CUcurlec
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

  • Base URL
    https://api.razorpay.com/v1
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization codehttps://mcp.razorpay.com/authorize
      Client credentials
      Token URLhttps://mcp.razorpay.com/token
      Scopesread_only
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

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[]

Changes

No recorded changes to this operation across all 1 revision of this API.