Payments API — fetch, capture, and list payments

Fetch payment details by ID, capture authorized payments before the window closes, and list payments using the Razorpay Payments API.

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

curl -X GET https://api.razorpay.com/v1/payments/pay_DJkTfWoJ5ZFPce \
  -u rzp_test_YOUR_KEY_ID:YOUR_KEY_SECRET

Response fields

id · string

Unique payment identifier.

entity · string

Always "payment".

amount · integer

Payment amount in the smallest currency unit (paise for INR, cents for USD).

currency · string

ISO 4217 currency code.

status · string

Payment status. One of created, authorized, captured, refunded, or failed.

order_id · string

The order ID associated with this payment.

method · string

Payment method used. One of card, netbanking, wallet, or upi.

captured · boolean

true if the payment has been captured.

description · string

Description provided at checkout.

email · string

Customer email address.

contact · string

Customer phone number.

created_at · 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.

amount · integer · required

Amount to capture in the smallest currency unit. Must match the original payment amount.

currency · string · required

ISO 4217 currency code. Must match the payment currency.

curl -X POST https://api.razorpay.com/v1/payments/pay_DJkTfWoJ5ZFPce/capture \
  -u rzp_test_YOUR_KEY_ID:YOUR_KEY_SECRET \
  -H "Content-Type: application/json" \
  -d '{"amount": 50000, "currency": "USD"}'

---

List payments

GET /v1/payments

Query parameters

count · integer

Number of payments to return. Maximum 100.

skip · integer

Number of payments to skip for pagination.

from · integer

Unix timestamp. Returns payments created on or after this time.

to · integer

Unix timestamp. Returns payments created on or before this time.