Channel payment callbacks

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

It is Highly recommended to validate callbacks before acting on it inside your system

The snippet below demonstrates two types of callbacks you will receive when a customer sends their transaction to a channel cryptocurrency address.

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": "default",
"resource_category": "unknown"
},
"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": "default",
"resource_category": "unknown"
},
"created_at": "2019-05-02T11:00:01+00:00"
}
}