Skip to main content
POST
/
payments
/
merchant
/
refund
cURL
curl --request POST \
  --url https://api.xpaycheckout.com/payments/merchant/refund \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "xIntentId": "in_fooBOwYsaK50AEfK",
  "amount": "200"
}
'
{
  "errorCode": "bad_request",
  "errorDescription": "Failed to read request"
}

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Body

application/json

Refund API

​
xIntentId
string
required

Unique identifier of the intent

Example:

"in_fooBOwYsaK50AEfK"

​
amount
string

The amount you want to refund, specified in the smallest unit of the currency (for example, cents for USD, paise for INR).

  • If you want to issue a partial refund, provide the amount you wish to refund here. For example, if the original payment was $100 (i.e., 10000 cents), and you want to refund $20, you would enter 2000.
  • If you leave this field blank, the full payment amount will be refunded automatically.
Example:

"200"

Response

Refund API response