Create Order

Create a new Razorpay payment order by submitting an amount and optional ride details. You must include a valid Bearer token in the request header.

Request

POST /payments/order

Authorization: Bearer <token>
Content-Type: application/json

integer

required

The amount to charge, in Indian Rupees (INR). Must be a positive integer.

string

A short description of the ride. Optional.

string

The payment mode to associate with this order (e.g. upi, card). Optional.

Response

string

The unique Razorpay order identifier. Pass this to the Razorpay checkout SDK on the client.

integer

The order amount in paise (INR × 100).

string

Always INR.

All amounts in the Razorpay response are denominated in paise. For example, an amountInInr of 150 returns amount: 15000.

This endpoint returns 503 Service Unavailable if Razorpay is not configured in the server environment. Verify the integration is active before calling this endpoint in production.

Example

curl -X POST http://localhost:8080/payments/order \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "amountInInr": 250,
    "rideSummary": "Airport pickup — Terminal 2",
    "paymentMode": "upi"
  }'

{
  "orderId": "order_OmXy1234abcd",
  "amount": 25000,
  "currency": "INR"
}

Authentication

Rides

Payments

Notifications & Settings

Request

Response

Example

​Request

​Response

​Example

Request

Response

Example