Skip to main content
POST
/
v1
/
payments
/
{id}
/
refund
Refund
curl --request POST \
  --url https://api.sandbox.zafapay.com/v1/payments/{id}/refund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 5.5,
  "reason": "Customer request"
}
'
{
  "id": "orf_xyz789",
  "transaction_id": "tx_abc123",
  "amount": "5.50",
  "status": "succeeded",
  "psp_refund_id": "re_xxxxx",
  "refund_fee": "1.00"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication using access token

Path Parameters

​
id
string
required

Transaction ID

Example:

"tx_abc123"

Body

application/json
​
amount
number

Refund amount (supports up to 2 decimal places). If omitted, full refund is processed.

Example:

5.5

​
reason
string

Refund reason

Example:

"Customer request"

Response

Refund successful

​
id
string

Refund ID

Example:

"orf_xyz789"

​
transaction_id
string

Transaction ID

Example:

"tx_abc123"

​
amount
string

Refund amount (string format)

Example:

"5.50"

​
status
string

Refund status

Example:

"succeeded"

​
psp_refund_id
string

PSP refund ID

Example:

"re_xxxxx"

​
refund_fee
string

Refund fee (string format)

Example:

"1.00"