v1

latestOpenAPI 3.0.0Proprietary2026-07-1313647393.0 KB

Payments

Update a payment

Update the notes field of a payment. Only notes can be modified.

patch/payments/{id}

Path parameters

idstring required

Payment ID (pay_*).

Request body

notesNotes required

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

Response

Updated payment.

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