Skip to main content
POST
/
3p
/
api
/
v1
/
transactions
/
{uuid}
/
refund
Refund a transaction ( STABLE )
curl --request POST \
  --url https://api.grailpay.com/3p/api/v1/transactions/{uuid}/refund \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "amount": 100,
  "client_reference_id": "123456"
}
'
{
  "status": true,
  "message": "",
  "data": {
    "uuid": "d1b3b3b0-7b3b-4b3b-8b3b-3b3b3b3b3b3b",
    "transaction_uuid": "d1b3b3b0-7b3b-4b3b-8b3b-3b3b3b3b3b3b",
    "amount": 100,
    "status": "REFUND_PENDING",
    "client_reference_id": "123456",
    "created_at": "2021-09-01 12:00:00"
  },
  "errors": null,
  "error_code": null
}

Authorizations

​
Authorization
string
header
required

Token-based authentication using Authorization: Bearer <YOUR_API_KEY> provided by the GrailPay Support Team.

Path Parameters

​
uuid
string<uuid>
required

UUID of the transaction to refund

Body

application/json
​
amount
integer
required

Amount to refund

Example:

100

​
client_reference_id
string

Client reference id

Example:

"123456"

Response

Refund created

​
status
boolean
Example:

true

​
message
string
Example:

""

​
data
object
​
errors
string
Example:

null

​
error_code
string
Example:

null