Bills3

Customers4

Disputes4

Documents3

Instant Settlements3

Invoices8

Items5

Linked Accounts8

Orders5

Partner Accounts1

Partner Documents4

Partner Stakeholders1

Partner Webhooks5

Payment Downtimes2

Payment Links6

Payments4

Plans3

QR Codes6

Refunds6

Settlements3

Subscriptions10

Transfers8

Virtual Accounts10

X Account Validation3

X Banking Balances1

X Contacts4

X Fund Accounts4

X Payout Links4

X Payouts6

X Transactions2

Payments

Capture a payment

Capture an authorized payment to collect funds. Must be called within the capture window (default 5 days). Amount must exactly equal authorized amount unless partial capture is enabled.

post/payments/{id}/capture

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
https://skmtc.dev/razorpay/apis/razorpay-api/docs/payments/:id/capture/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idstring required

Payment ID (pay_*). Must be in 'authorized' status.

Request body

amountinteger required

Amount to capture in paise. Must equal authorized amount unless partial capture is enabled.

currencystring required

Response

Payment captured. Status changes to 'captured'.

idstring

Unique payment identifier. Prefix: pay_

entity'payment'

amountinteger

Payment amount in paise.

currencystring

status'created' | 'authorized' | 'captured' | 'refunded' | 'failed'

created: initiated. authorized: bank approved, not yet captured. captured: funds collected. refunded: fully refunded. failed: transaction failed.

order_idstring

Associated order ID (order_*).

invoice_idstring

internationalboolean

method'card' | 'netbanking' | 'wallet' | 'emi' | 'upi'

amount_refundedinteger

Total refunded amount in paise.

refund_status'null' | 'partial' | 'full'

capturedboolean

descriptionstring

card_idstring

bankstring

Bank code for netbanking. Example: HDFC.

walletstring

Wallet name. Examples: paytm, mobikwik.

vpastring

emailstring

contactstring

customer_idstring

token_idstring

notesNotes

Key-value pairs for storing custom metadata. Maximum 15 pairs. Each key and value must not exceed 256 characters.

feeinteger

Razorpay fee charged (paise).

taxinteger

GST on the fee (paise).

error_codestring

error_descriptionstring

error_sourcestring

error_stepstring

error_reasonstring

created_atinteger

Changes

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