You have to create a new order every time you want to charge your customers. This order is different from the one created during the authorisation transaction.
The following endpoint creates an order.
amount
mandatory
integer
Amount in currency subunits. For cards, the minimum value is 100
(ā‚¹1.00).
currency
mandatory
string
The 3-letter ISO currency code for the payment. Currently, we only support INR
.
receipt
optional
string
A user-entered unique identifier for the order. For example, Receipt No. 1
. You should map this parameter to the order_id
sent by Razorpay.
notes
optional
object
Key-value pair you can use to store additional information about the entity. Maximum of 15 key-value pairs, 256 characters each. For example, "note_key": "Beam me up Scottyā€¯
.
payment_capture
mandatory
boolean
Determines whether tha payment status should be changed to captured
automatically or not. Possible values:
true
: Payments are captured automatically.false
: Payments are not captured automatically. You can manually capture payments using the .
id
string
A unique identifier of the order created. For example order_1Aa00000000001
.
entity
string
The entity that has been created. Here it is order
.
amount
integer
Amount in currency subunits.
amount_paid
integer
The amount that has been paid.
amount_due
integer
The amount that is yet to pay.
currency
string
The 3-letter ISO currency code for the payment. Currently, we only support INR
.
receipt
string
A user-entered unique identifier of the order. For example, rcptid #1
.
status
string
The status of the order.
notes
object
Key-value pair you can use to store additional information about the entity. Maximum of 15 key-value pairs, 256 characters each. For example, "note_key": "Beam me up Scottyā€¯
.
created_at
integer
The Unix timestamp at which the order was created.
Given below is a list of possible errors you may face while creating an Order.
Error | Cause | Solution |
---|---|---|
The api key provided is invalid | This error occurs when you enter the wrong API key or secret. | Make sure to enter the valid API key and secret. |
The amount must be atleast INR 1.00. | This error occurs when you enter an amount less than INR 1. | Make sure the entered amount is atleast INR 1. |
The currency should be INR when method is upi | This error occurs when you enter a currency other than INR. | Make sure the currency is INR. |