API ReferenceIntegrationsKnowledge Base

About Orders

Order is an important step of the payment life cycle at Razorpay. When a customer clicks the pay button on your website or app, an order is created with a unique identifier. This contains details such as the transaction amount and currency. Pass this order ID to the Razorpay Checkout.

You need to integrate your server with Orders API before proceeding with Razorpay Payment Gateway integration on your website or app.

Advantages🔗

  • Single successful payment bound to an order. Prevents multiple payments.
  • Quick and easy query in the database. Combines multiple payment attempts for a single order.

Order States🔗

Following are the various states of an order:

Status

Description

created

When a new order is created, it is in the created state. It stays in this state until payment is attempted on it.

attempted

An order moves from created to attempted state when a payment is first attempted on it. It remains in the attempted state until a payment associated with that order is captured.

paid

After the payment is captured successfully, the order moves to the paid state. No further payment requests are allowed once the order moves to the paid state. The order continues to be in paid state state even if the payment associated with the order is refunded.

Order and Payment Flows🔗

Following is a pictorial representation of how order and payment flows are closely related:

Order and Payment Flow
×