A refund callback will be sent to the merchant's callback_url when the merchant refund is created or the status is changed to processing, rejected or completed.
API Callback Documentation
Read more about common callback functionalities in the API Callbacks section.
CoinGate callback sends the data below:
Name | Type | Value |
---|---|---|
id | Integer | CoinGate merchant refund ID |
order_id | Integer | CoinGate order ID assigned to the merchant refund |
status | String | Current order status |
request_amount | String | Amount requested to refund |
request_currency | Hash | Currency id and symbol |
address | String | Customer’s wallet address where the refund will be sent |
additional_address_field | String | Address memo or destination tag |
refund_amount | String | Amount to refund a customer |
refund_currency | Hash | Currency id, symbol, platform id, and title |
email | String | Customer’s email address |
reason | String | Reason for refund |
ledger_account | Hash | Ledger id, currency id, and symbol |
An example of callback in JSON:
{
"id": 123,
"order_id": 124,
"status": "completed",
"request_amount": "123.0",
"request_currency": {
"id": 2,
"symbol": "EUR"
},
"address": "mvKFTr6M8NtKrD659qBCpT9hfM1LTwnQV3",
"additional_address_field": null,
"refund_amount": "0.00012345",
"refund_currency": {
"id": 1,
"symbol": "BTC",
"platform": {
"id": 6,
"title": "Bitcoin"
}
},
"email": "[email protected]",
"reason": "Callbacks Testing Reason",
"ledger_account": {
"id": "01HBDE32A9FKNJT5S8MYFFYY6JJ",
"currency": {
"id": 1,
"symbol": "BTC"
}
}
}