A callback will be sent to the merchant's callback_url when the billing request is created or the status is changed
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 | Billing Request ID |
uuid | String | Generated UUID |
status | String | Billing Request status |
title | String | Custom title of the request |
amount | String | Amount requested to refund |
due_days | Integer | Days after billing request will expired |
callback_url | String | Callback URL |
send_email | Boolean | If CoinGate will send an email to billing contact about request |
underpaid_cover_pct | String | Underpaid coverage percentage by merchant. |
created_at | String | Date of blilling request creation. |
billing_contact_id | Integer | ID of Billing Contact. |
currency_id | integer | ID of Currency. Currency of the invoice amount. |
receive_currency_id | Integer | ID of Currency. Currency that will be received on payment. |
billing_request_items | Hash | Biling Product ID, quantity |
billing_request_url | String | URL of invoice. |
An example of callback in JSON:
{
"id": 1,
"uuid": "6d93326d-f386-4b90-ab35-1eaab2673ba7",
"status": "pending",
"title": "Billing Request Example",
"amount": "0.0003",
"due_days": 1,
"callback_url": "https://callback.com/exmaple",
"send_email": true,
"underpaid_cover_pct": "0.0",
"created_at": "2024-10-02T13:16:49Z",
"billing_contact_id": 1,
"currency_id": 1,
"receive_currency_id": 2,
"billing_request_items": [
{
"id": 4,
"billing_product_id": 1,
"quantity": 2
},
{
"id": 5,
"billing_product_id": 1,
"quantity": 1
}
],
"billing_request_url": ""
}