Skip to main content
The Payments API lets you retrieve payment details, capture authorized payments, and list payments. Payments are created automatically when a customer completes checkout — you do not create payments directly.

​
Fetch a payment

GET /v1/payments/:id

​
Response fields

​
string
Unique payment identifier.
​
string
Always "payment".
​
integer
Payment amount in the smallest currency unit (paise for INR, cents for USD).
​
string
ISO 4217 currency code.
​
string
Payment status. One of created, authorized, captured, refunded, or failed.
​
string
The order ID associated with this payment.
​
string
Payment method used. One of card, netbanking, wallet, or upi.
​
boolean
true if the payment has been captured.
​
string
Description provided at checkout.
​
string
Customer email address.
​
string
Customer phone number.
​
integer
Unix timestamp of when the payment was created.

​
Capture a payment

POST /v1/payments/:id/capture Capturing a payment transfers the authorized funds. You must capture a payment within 5 days of authorization (or your configured capture timeout). Uncaptured payments are automatically refunded.
Always capture for the exact amount and currency of the original payment. Capturing a different amount will fail.
​
integer
required
Amount to capture in the smallest currency unit. Must match the original payment amount.
​
string
required
ISO 4217 currency code. Must match the payment currency.

​
List payments

GET /v1/payments

​
Query parameters

​
integer
Number of payments to return. Maximum 100.
​
integer
Number of payments to skip for pagination.
​
integer
Unix timestamp. Returns payments created on or after this time.
​
integer
Unix timestamp. Returns payments created on or before this time.