v1

latestOpenAPI 3.0.32026-07-26172157253.6 KB

Razorpay Payments

Create Razorpay Order

Create a local Razorpay Order record with the caller's user context, create a Razorpay Order, and return Checkout options for the client-side Razorpay Checkout script.

post/api/payments/razorpay/{environment}/orders

Path parameters

environment'test' | 'live' required

Payment provider environment.

Request body

amountinteger required

currencystring required

receiptstring nullable

descriptionstring nullable

customerNamestring nullable

customerEmailstring email nullable

customerContactstring nullable

callbackUrlstring uri nullable

notesMetadata

Example request

{
  "amount": 50000,
  "currency": "INR",
  "subject": {
    "type": "team",
    "id": "team_123"
  }
}

Response

Razorpay Order created

Example response

{
  "order": {
    "orderId": "order_123",
    "amount": 50000,
    "currency": "inr",
    "verifiedPaymentId": "pay_123"
  },
  "checkoutOptions": {
    "key": "rzp_test_xxx",
    "currency": "INR",
    "order_id": "order_123"
  }
}