Refund payment
POST
https://api.gigstack.io/v2/payments/{id}/refund
team parameter.Key Features
reason and amount are both required. amount must be at least 0.01 — thevalidator rejects anything below it.
Request
Path Params
Query Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.gigstack.io/v2/payments/payment_1234567890/refund?team=undefined' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"reason": "Customer requested cancellation",
"amount": 1160,
"external_processor_refund": true
}'Response Response Example
200 - Example 1
{
"success": true,
"data": {
"refund": {
"id": "refund_1234567890",
"reason": "Customer requested cancellation",
"total": 1160,
"status": "succeeded",
"timestamp": 1767225600000,
"from": "api",
"external_processor_refund": true
},
"payment": {
"id": "payment_1234567890",
"amount": 116000,
"total_refunded": 116000,
"refund_status": "refunded"
}
},
"message": "Operation completed successfully",
"timestamp": 1767225600000
}Modified at 2026-08-13 23:10:14