v1

latestOpenAPI 3.0.0Proprietary2026-07-1313647393.0 KB

Orders

Create an order

Create an order before initiating a payment. The returned order_id must be passed to Razorpay Checkout. An order can have multiple payment attempts but only one successful capture.

post/orders

Request body

amountinteger required

Payment amount in paise. Example: 50000 for ₹500. Must be >= 100.

currencystring required

ISO 4217 currency code. Example: INR.

receiptstring

Your internal receipt number. Max 40 characters.

notesNotes

Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.

partial_paymentboolean

Allow partial payments.

Response

Order created.

idstring

Unique order identifier. Prefix: order_

entity'order'

amountinteger

Order amount in paise. Example: 50000 = ₹500.

amount_paidinteger

Total amount paid against this order (paise).

amount_dueinteger

Remaining unpaid amount (paise).

currencystring

ISO 4217 currency code. Example: INR.

receiptstring

Your internal receipt or order reference number.

status'created' | 'attempted' | 'paid'

created: awaiting payment. attempted: payment attempted but not captured. paid: fully paid.

attemptsinteger

Number of payment attempts made.

notesNotes

Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.

created_atinteger

Unix timestamp of order creation.

offer_idstring

offersstring[]