Different Invoice states

Prev Next
This content is currently unavailable in German. You are viewing the default (English) version.

What are the different types of invoices available in Frisbii Billing and Pay?

Frisbii Billing and Pay offers two main types of invoices to cater to various billing scenarios. Understanding these invoice types can help businesses manage their billing processes more effectively.


Subscription Invoices

  • Subscription invoices are essential for managing recurring payments, ensuring accurate and timely billing for services. They maintain transaction records and provide billing transparency.

  • Features like automated reminders can enhance user experience by informing customers of upcoming payments, improving satisfaction and reducing late payments.

  • Invoices can be customized with service descriptions, payment terms, and applicable taxes, helping customers understand charges and resolve billing disputes. Effective management of these invoices is crucial for businesses and customers.

One-Time  or Charge Invoices

One-time invoices are generated for unique transactions that do not fall under a subscription model. These invoices are typically used for:

  • Ad-hoc services or products sold to customers.

  • Special events or projects that require separate billing.

  • Custom pricing arrangements that do not fit into standard subscription plans.


Subscription invoice states

  • CREATED - Placeholder state. Subscription invoices use this state for pending subscriptions not activated yet. This is accounting wise not an invoice yet, but a DRAFT.

  • PENDING - A pending invoice is awaiting processing, or in processing and failing but within grace period.

  • DUNNING - Invoice has entered a dunning state because payment fails, either because of failing payment method or no payment method, and grace period has expired.

  • FAILED - Dunning for subscription invoice has failed.

  • CANCELLED - An non-paid invoice can be cancelled

  • SETTLED - Invoice has been paid. Refunds can be made on a settled invoice.

How does the status of a Subscription invoice change?

Source

Target

Cause

-

CREATED

  • Pending subscription created with created invoice to be paid at activation.

-

PENDING

  • Invoice created automatically when subscriptions renews

  • Invoice created when active subscription is created if billing period starts immediately

  • Invoice created on-demand

CREATED

PENDING

  • Pending subscription activated

CANCELLED

PENDING

  • Cancelled invoice re-activated through Admin or API

FAILED

PENDING

  • Failed invoice re-activated through Admin or API

PENDING

DUNNING

  • Pending invoice entering dunning because of no payment method or failing payment method

PENDING

FAILED

  • No dunning configured and payment method failing

  • Force fail operation used in Admin or through API

DUNNING

FAILED

  • Dunning process not successful

  • Force fail operation used in Admin or through API

PENDING

SETTLED

  • Invoice is successfully automatically paid by subscription engine

  • Settle operation invokes in Admin or through API

DUNNING

SETTLED

  • Invoice is successfully automatically paid by subscription engine

  • Settle operation invokes in Admin or through API

SETTLED

SETTLED

  • Refund performed on settled invoice

PENDING

CANCELLED

  • Cancel operation used in Admin or through API

DUNNING

CANCELLED

  • Cancel operation used in Admin or through API

FAILED

CANCELLED

  • Cancel operation used in Admin or through API


One Time or Charge Invoice states

  • CREATED - A charge invoice has been prepared in a created state for payment in Checkout. A created charge invoice is created when a charge session is created, if the session is not for an existing charge.

  • PENDING - A Merchant Initiated Transaction (MIT) payment is made for an asynchronous payment type like MobilePay Subscriptions. The result of the payment is not known instantly. Result can be delivered by web-hook, or polling can be used.

  • AUTHORIZED - A payment without instant settle was successful. Money has been reserved for potential later settlement.

  • FAILED - A payment has failed. Re-attempts can be made on the failed charge invoice.

  • CANCELLED - An non-paid invoice can be cancelled

  • SETTLED - Charge invoice has been settled. Refunds can be performed on a settled charge.

How does the status of a Charge or One Time invoice change?

MIT - Merchant Initiated Transaction - Merchant i.e You

CIT - Customer Initiated Transaction - Customer i.e Your Customer

Source

Target

Cause

-

CREATED

  • Invoice prepared when creating a charge session.

-

PENDNG

  • MIT creates a charge for an asynchronous payment method where the result of charge is not known instantly.

-

AUTHORIZED

  • MIT creates charge without instant settle

CREATED

AUTHORIZED

  • CIT payment of charge in Checkout without instant settle

PENDING

AUTHORIZED

  • Asynchronous payment of charge without instant settle

-

FAILED

  • MIT create charge with failed payment

CREATED

FAILED

  • CIT payment of charge failed

PENDING

FAILED

  • Asynchronous payment without instant settle failed

AUTHORIZED

FAILED

  • Settle of authorization with hard decline where settle can never succeed.

FAILED

FAILED

  • Failed CIT or MIT payment re-attempt

-

SETTLED

  • MIT create charge with instant settle

CREATED

SETTLED

  • CIT payment of charge in Checkout with instant settle

PENDING

SETTLED

  • Asynchronous payment of charge with instant settle

AUTHORIZED

SETTLED

  • Settle of authorized charge

SETTLED

SETTLED

  • Refund on settled invoice

CREATED

CANCELLED

  • Cancellation of a created charge

AUTHORIZED

CANCELLED

  • Cancellation of an authorized charge. Release of reserved funds will be attempted.

FAILED

CANCELLED

  • Cancellation of a failed charge