Invoice Life Cycle and States

List of states of a RazorpayX invoice and their significance.


Following are the 2 life cycles in Vendor Payments:

Below is the life cycle of an invoice.

vendor payment life cycle

Invoices can be in any one of the following states:

  • draft
  • unpaid
  • scheduled
  • partially paid
  • processing
  • canceled
  • paid

An invoice is in the draft state when the process of creating an invoice has been initiated but the invoice has not been saved yet. For an invoice in the draft state, you can take the following actions from the Vendor Payments app:

  • Complete details (or edit the invoice)
  • Cancel

The invoice has been uploaded to our system. A payout may be created, but not successfully paid against the invoice.

Possible payout states:

  • Payout not yet created.
  • rejected
  • cancelled
  • failed
  • reversed

For an invoice in the unpaid state, you can take the following actions from the Vendor Payments app:

  • Pay Invoice
  • Edit Invoice
  • Mark as Paid
  • Cancel Invoice
  • Add File

An invoice can be created and a corresponding payout can be scheduled. This is done in cases where payments are to be made on specific dates. For an invoice in the scheduled state, you can take the following actions from the Vendor Payments app:

  • Pay Remaining
  • Mark as Paid
  • Edit Details
  • Add File

Scheduled payouts can be canceled/approved/rejected from the Payouts app. This will automatically change the status of the invoice to unpaid.

Partial payouts are done in cases where an advance payment is requested or in cases where payments are made in EMIs. An invoice is moved to partially paid state in such cases. For an invoice in this state, you can take the following actions from the Vendor Payments app:

  • Pay Remaining
  • Mark as Paid
  • Edit Details
  • Add File

Invoices in this state can be canceled/approved/rejected from the Payouts app.

The payment for the invoice is being processed. A payout is created and is being processed.

Possible payout states:

  • pending
  • queued
  • processing

From the processing state, the invoice can go back to the unpaid state:

  • If you reject or cancel the payout.
  • If the payout fails or is reversed.

For an invoice in the processing state, you can take the following actions from the Vendor Payments app:

  • Edit Details
  • Add File

Invoices in this state can be canceled/approved/rejected from the Payouts app.

A payout for the full amount is made against the invoice to your vendor. Possible payout state: processed.

Once an invoice is paid, your vendor receives an email informing them about the payment. Shown below is a sample email that is sent to your vendor.

Invoice paid email example confirming successful transfer

You can perform the following actions on invoices in the paid state:

  • Edit Details
  • Add File

You have manually cancelled the payout against the invoice from the Dashboard.

  • You can only cancel an invoice in the unpaid state.
  • You cannot cancel an invoice once a payout is made for it.

After you pay an invoice, a payout is created. The payout created follows the same life cycle as a normal payout. Know more about

.


Was this page helpful?


razorpayx vendor payments lifecycle
razorpayx invoice lifecycle
invoice stage in razorpay
invoice schedule payment
invoice partial payment