Callbacks

Handling callbacks correctly is crucial to make sure your integration’s business logic works as expected. It is highly recommended to validate payment statuses and callbacks before acting on it inside your system.

Refer to this section to get more information on what callbacks are and how to validate them before acting on it inside your system.

Event

Description

created

A CoinWithdrawal transaction has been created

status_changed

The CoinWithdrawal transaction has changed its status

Refer to this section to get more information on CoinWithdrawal transaction statuses.

CoinWithdrawal created
CoinWithdrawal status changed
CoinWithdrawal status changed
CoinWithdrawal created
{
"type": "CoinWithdrawal",
"event": "created",
"data": {
"id": "09968790-5f14-442d-a9a4-0c2bd09e0766",
"custom_id": "CP39563937491",
"address": "2MvavRrBCRVUm9JNSGmukeBWzU3A1ACvJne",
"txid": null,
"status": "pending",
"charged_amount": "10.17",
"charged_currency": "EUR",
"received_amount": "0.00105461",
"received_currency": "BTC",
"network_fee": "0.0000054",
"network_fee_level": "fast",
"fee": "0.0",
"fee_currency": "BTC",
"exchange": {
"pair": "BTCEUR",
"rate": "9482.0979"
},
"risk": null,
"created_at": "2020-02-07T09:07:26+00:00"
}
}
CoinWithdrawal status changed
{
"type": "CoinWithdrawal",
"event": "status_changed",
"data": {
"id": "09968790-5f14-442d-a9a4-0c2bd09e0766",
"custom_id": "CP39563937491",
"address": "2MvavRrBCRVUm9JNSGmukeBWzU3A1ACvJne",
"txid": null,
"status": "processing",
"charged_amount": "10.17",
"charged_currency": "EUR",
"received_amount": "0.00105461",
"received_currency": "BTC",
"network_fee": "0.0000054",
"network_fee_level": "fast",
"fee": "0.0",
"fee_currency": "BTC",
"exchange": {
"pair": "BTCEUR",
"rate": "9482.0979"
},
"risk": null,
"created_at": "2020-02-07T09:07:26+00:00"
}
}
CoinWithdrawal status changed
{
"type": "CoinWithdrawal",
"event": "status_changed",
"data": {
"id": "09968790-5f14-442d-a9a4-0c2bd09e0766",
"custom_id": "CP39563937491",
"address": "2MvavRrBCRVUm9JNSGmukeBWzU3A1ACvJne",
"txid": "c01d93c268ee884f09c586c89340ed35b5b05fba5a1bb726924f2dd1eb9319b6",
"status": "completed",
"charged_amount": "10.17",
"charged_currency": "EUR",
"received_amount": "0.00105461",
"received_currency": "BTC",
"network_fee": "0.0000054",
"network_fee_level": "fast",
"fee": "0.0",
"fee_currency": "BTC",
"exchange": {
"pair": "BTCEUR",
"rate": "9482.0979"
},
"risk": null,
"created_at": "2020-02-07T09:07:26+00:00"
}
}

How to start receiving coin withdrawal callbacks

Log in to your account and navigate to a Settings → API page where you will find a toggle switch called "I want to receive callbacks for coin withdrawal transactions":