Channel payment callbacks

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

The snippet below demonstrates two types of callbacks you will receive.

Callback event

Channel payment status

Description

created

pending

A customer has just broadcasted their transaction on the network

completed

completed

The transaction has just been confirmed on the network. The channel payment status has been changed to completed

Created
Completed
{
"type": "ChannelPayment",
"event": "created",
"data": {
"id": "284d4b79-fea6-46ce-bc2f-0f9cbed6367e",
"txid": "09723bf75253f3d2bf2f150fd8b5da5bc3026b95f1fe50b1f5f76f43d67a2e30",
"paid_amount": "0.02",
"paid_currency": "BTC",
"received_amount": "0.0",
"received_currency": "EUR",
"fee": "0.0",
"fee_currency": "EUR",
"status": "pending",
"channel_id": "50eb5775-f77e-4c64-870b-dc93624b5967",
"custom_id": "631044494",
"risk": {
"score": 0.0,
"level": "low",
"resource_name": "Bitstamp",
"resource_category": "Exchange"
},
"hosted_page_url": "https://business-hosted.cryptopay.me/channels/50eb5775-f77e-4c64-870b-dc93624b5967",
"created_at": "2019-05-02T11:00:01+00:00"
}
}
{
"type": "ChannelPayment",
"event": "completed",
"data": {
"id": "284d4b79-fea6-46ce-bc2f-0f9cbed6367e",
"txid": "09723bf75253f3d2bf2f150fd8b5da5bc3026b95f1fe50b1f5f76f43d67a2e30",
"paid_amount": "0.02",
"paid_currency": "BTC",
"received_amount": "97.26",
"received_currency": "EUR",
"fee": "0.99",
"fee_currency": "EUR",
"exchange": {
"pair": "BTCEUR",
"rate": "4912.8021"
},
"status": "completed",
"channel_id": "50eb5775-f77e-4c64-870b-dc93624b5967",
"custom_id": "631044494",
"risk": {
"score": 0.0,
"level": "low",
"resource_name": "Bitstamp",
"resource_category": "Exchange"
},
"hosted_page_url": "https://business-hosted.cryptopay.me/channels/50eb5775-f77e-4c64-870b-dc93624b5967",
"created_at": "2019-05-02T11:00:01+00:00"
}
}