Razorpay Invoices

Introduction#

An Invoice is a digital document that summarises the details of an order or a transaction and allows customers to initiate payments. A typical invoice contains sale transaction information such as the name of the ordered products or services, quantities or billing cycle, price breakup, receipt number, customer information, and so on.

GST Compliance: Currently,GST complaint Invoices can be created via Dashboard only. However, we still support creation of non-GST invoices via APIs.

How Invoices Work#

Razorpay Dashboard allows you to create invoices and perform other operations such as update, cancel and delete. You can perform the same via APIs as well. Once an invoice is issued, the customer can initiate the payment.

Lifecycle of an Invoice#

The lifecycle of an invoice starts in the Draft state and ends as Paid after being Issued to the customer.

Note: deleted is not a status of an invoice. A deleted invoice disappears from the list of invoices.

The table below describes each state of an invoice:

Status

Description

draft

When an invoice is saved, it moves to the draft state.

issued

This status indicates that an invoice has been created and is sent to the customer.

paid

This status indicates that a payment for an invoice is completed by the customer. Paid is the final state of an invoice and no write operations are allowed after an invoice reaches the Paid status. It can only be viewed.

expired

This status indicates that an invoice has expired. You can set the expire timestamp at the time of invoice creation via APIs using expire_by. Refer Creating an Invoice.

cancelled

This status indicates that an invoice has been cancelled. Cancelled invoice are not viewable/payable by customers, however, it will be listed on the Dashboard. You only can cancel an issued invoice.

deleted

Deleted invoices does not appear on Dashboard as they are removed from the list. Only the invoices that were saved as drafts can be deleted.