API ReferenceIntegrationsKnowledge Base

Razorpay Invoices

Razorpay Invoices enables you to send GST-compliant invoices to your customers and accept payments instantly.

The invoice contains information regarding the sale such as the name of the ordered products or services, quantity, billing cycle, price breakup, receipt number and customer information.

You can create, update, cancel and delete invoices either from the Dashboard or using our APIs.

GST and Non-GST Invoices:
You can generate both GST-compliant and non-GST invoices from the Dashboard. However, you can create only non-GST invoices using our APIs.

Invoice States#

During its life cycle, an invoice starts in the draft state and moves through several different states. Below is a high level diagrammatic overview of the invoice life cycle.

The table below lists the various states of an invoice and gives a brief description of each state.

Status

Description

draft

This state indicates that the invoice has been created and saved. An invoice in this state is not issued and can be edited at a later time.
Customer and item fields are required to save an invoice. A saved invoice can be deleted. Once deleted, you can no longer view the invoice.

issued

This state indicates that an invoice has been finalized and issued to the customer. An issued invoice cannot be deleted, but can be cancelled.
You can edit the following information even after sending it to the customer:
- Invoice #
- Expiry Date
- Customer Notes
- Terms and Conditions
- Enable or disable partial payment

partially paid

This state indicates that the customer has made a partial payment against an invoice. Once a payment has been made, you can neither delete nor cancel the invoice. You can only view the invoice and add internal notes to it.

paid

This state indicates that the customer has fully paid the invoice amount. Paid is the final state of an invoice. A paid invoice can only be viewed. You can neither delete nor cancel it.

expired

This state indicates that an invoice has expired. Once expired, neither can the customer make any payments against the invoice, nor can you cancel or delete it. However, you can view an expired invoice.

cancelled

This state indicates that you have cancelled the invoice. Though you can view the cancelled invoice, the customer can neither view nor make payments against it in this state. You can only cancel an issued invoice.

deleted

This state indicates that the invoice has been deleted. You can only delete an invoice in the draft state and not in any other states.