Crypto Pay-ins
To configure Payout webhooks, go to the BVNK Portal and navigate to Integrations > Webhooks. For the full guide, see Create a Webhook Listener.
Crypto: Status change
The bvnk:payment:crypto:status-change webhook is triggered when the status of the crypto transaction changes, for example, from Pending, to Processing, to Complete.
{
"event": "bvnk:payment:crypto:status-change",
"eventId": "01983bca-6838-7e22-9ad1-eb7db0008b83",
"timestamp": "2025-07-24T09:36:17.464310400Z",
"data": {
"flow": null,
"type": "IN",
"uuid": "a5408dae-2d58-4603-b16d-15994a48a7e7",
"pegged": false,
"refund": null,
"status": "PROCESSING",
"address": {
"tag": null,
"uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/transfer?address=0xe64c920a27ef8424022bb354e2b9de692c93f7c1&uint256=2E+6",
"address": "0xe64c920a27ef8424022bb354e2b9de692c93f7c1",
"protocol": "ERC20",
"alternatives": []
},
"refunds": [],
"subType": "merchantPayIn",
"twoStep": false,
"metadata": {},
"reference": "ProcessingHook",
"returnUrl": "",
"customerId": "gsyme",
"expiryDate": 1753350009000,
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"dateCreated": 1753349709000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"feeCurrency": {
"actual": 0,
"amount": 0.014,
"currency": "USDC"
},
"quoteStatus": "ACCEPTED",
"redirectUrl": "https://pay.bvnk.com/payin/a5408dae-2d58-4603-b16d-15994a48a7e7",
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"paidCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"transactions": [
{
"hash": "0xb88f6ac232711c3d30e74c6bcb5333409c9a4d2dba477ce4c826ab942619485e",
"amount": 2,
"sources": [],
"isOnHold": false,
"protocol": "ERC20",
"dateCreated": 1753349777000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"dateConfirmed": null,
"networkFeeAmount": null,
"networkFeeCurrency": "USDC"
}
],
"walletCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"quoteExpiryDate": 1753350009000,
"networkFeeCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"merchantDisplayName": "merchaOne",
"acceptanceExpiryDate": 1753349739000
}
}{
"event": "bvnk:payment:crypto:status-change",
"eventId": "01983bcc-38e8-79c3-95af-f8266436512e",
"timestamp": "2025-07-24T09:38:16.424508600Z",
"data": {
"flow": null,
"type": "IN",
"uuid": "a5408dae-2d58-4603-b16d-15994a48a7e7",
"pegged": false,
"refund": null,
"status": "COMPLETE",
"address": {
"tag": null,
"uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/transfer?address=0xe64c920a27ef8424022bb354e2b9de692c93f7c1&uint256=2E+6",
"address": "0xe64c920a27ef8424022bb354e2b9de692c93f7c1",
"protocol": "ERC20",
"alternatives": []
},
"refunds": [],
"subType": "merchantPayIn",
"twoStep": false,
"metadata": {},
"reference": "CompleteWebhooks",
"returnUrl": "",
"customerId": "gsyme",
"expiryDate": 1753350009000,
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"dateCreated": 1753349709000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"feeCurrency": {
"actual": 0.014,
"amount": 0.014,
"currency": "USDC"
},
"quoteStatus": "ACCEPTED",
"redirectUrl": "https://pay.bvnk.com/payin/a5408dae-2d58-4603-b16d-15994a48a7e7",
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"paidCurrency": {
"actual": 2,
"amount": 2,
"currency": "USDC"
},
"transactions": [
{
"hash": "0xb88f6ac232711c3d30e74c6bcb5333409c9a4d2dba477ce4c826ab942619485e",
"amount": 2,
"sources": [
"0xDeAdBeEf01234567890123456789aBcDeF012345"
],
"isOnHold": false,
"protocol": "ERC20",
"dateCreated": 1753349777000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"dateConfirmed": 1753349896000,
"networkFeeAmount": 0.000146,
"networkFeeCurrency": "USDC"
}
],
"walletCurrency": {
"actual": 2,
"amount": 2,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 2,
"amount": 2,
"currency": "USDC"
},
"quoteExpiryDate": 1753350009000,
"networkFeeCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"merchantDisplayName": "merchOne",
"acceptanceExpiryDate": 1753349739000
}
}{
"event": "bvnk:payment:crypto:status-change",
"eventId": "01983ce6-1e44-773d-a6a0-4cc874685e0b",
"timestamp": "2025-07-24T14:46:10.756981Z",
"data": {
"flow": null,
"type": "IN",
"uuid": "4eda87bd-e555-4310-ab2b-5ecaedd3039c",
"pegged": false,
"refund": null,
"status": "EXPIRED",
"address": null,
"refunds": [],
"subType": "merchantPayIn",
"twoStep": false,
"metadata": {},
"reference": "CameronTestingRefundWebhookViaWallet5",
"returnUrl": "",
"customerId": "Cameron123",
"expiryDate": 1753368370753,
"merchantId": "e91a7928-7353-4ad4-93eb-32632f01b7b6",
"dateCreated": 1753368206000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"feeCurrency": {
"actual": 0,
"amount": 0.014,
"currency": "USDC"
},
"quoteStatus": "ACCEPTED",
"redirectUrl": "https://pay.bvnk.com/payin/4eda87bd-e555-4310-ab2b-5ecaedd3039c",
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"paidCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"transactions": [],
"walletCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"quoteExpiryDate": 1753368266000,
"networkFeeCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"merchantDisplayName": "USDC",
"acceptanceExpiryDate": 1753368236000
}
}Transaction late
The bvnk:payment:crypto:transaction-late webhook is triggered when a customer sends a payment to an expired hosted payment page.
This webhook notification alerts the recipient system about a cryptocurrency payment transaction that was received late or after an expected deadline.
{
"event": "bvnk:payment:crypto:transaction-late",
"eventId": "01983c00-5ba6-7cc0-889f-559a5470d599",
"timestamp": "2025-07-24T10:35:13.190815700Z",
"data": {
"flow": null,
"type": "IN",
"uuid": "f7c7adca-7e3a-4fcc-9cb1-87e36668a8b2",
"pegged": false,
"refund": null,
"status": "EXPIRED",
"address": {
"tag": null,
"uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/transfer?address=0x632cbf94b236419c63f23867a89f4beded3ee3da&uint256=2E+6",
"address": "0x632cbf94b236419c63f23867a89f4beded3ee3da",
"protocol": "ERC20",
"alternatives": []
},
"refunds": [],
"subType": "merchantPayIn",
"twoStep": false,
"metadata": {},
"reference": "RefundWebhook",
"returnUrl": "",
"customerId": "gsyme",
"expiryDate": 1753350971000,
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"dateCreated": 1753350575000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"feeCurrency": {
"actual": 0,
"amount": 0.014,
"currency": "USDC"
},
"quoteStatus": "ACCEPTED",
"redirectUrl": "https://pay.bvnk.com/payin/f7c7adca-7e3a-4fcc-9cb1-87e36668a8b2",
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"paidCurrency": {
"actual": 5,
"amount": 2,
"currency": "USDC"
},
"transactions": [
{
"hash": "0x8c29b2b0c6d841b550783c797d3b9668675c05fb17d56db1c9d2172db2536d0e",
"amount": 5,
"sources": [
"0xC0fFEe1234567890ABCdEf0123456789aBcDeF01"
],
"isOnHold": false,
"protocol": "ERC20",
"dateCreated": 1753353196000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"dateConfirmed": 1753353312000,
"networkFeeAmount": 0.00011,
"networkFeeCurrency": "USDC"
}
],
"walletCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"quoteExpiryDate": 1753350875000,
"networkFeeCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"merchantDisplayName": "PieroMerch",
"acceptanceExpiryDate": 1753350605000
}
}Refund initiated
The bvnk:payment:crypto:refund-initiated webhook notifies when a refund process has begun for a cryptocurrency payment. This can happen if your merchant settings are set to auto-refund under- and overpayments, or if a payment is made to an expired payment link.
{
"event": "bvnk:payment:crypto:refund-initiated",
"eventId": "01983bf0-c3eb-77b8-bda2-3a09d9bb1235",
"timestamp": "2025-07-24T10:18:11.307235200Z",
"data": {
"flow": null,
"type": "OUT",
"uuid": "bf651b97-722f-400b-b96f-3e56fe182cfe",
"pegged": false,
"refund": {
"flow": null,
"type": "IN",
"uuid": "ad5c2cfc-6ec3-4e51-96f1-03dfad8efc11",
"pegged": false,
"refund": null,
"status": "COMPLETE",
"address": {
"tag": null,
"uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/transfer?address=0x27f9bfa4e6782671e9224c5debdf4350a28bc728&uint256=2E+6",
"address": "0x27f9bfa4e6782671e9224c5debdf4350a28bc728",
"protocol": "ERC20",
"alternatives": []
},
"refunds": [],
"subType": "merchantPayIn",
"twoStep": false,
"metadata": {},
"reference": "RefundWebhook1",
"returnUrl": "",
"customerId": "gsyme",
"expiryDate": 1753352469000,
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"dateCreated": 1753352169000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"feeCurrency": {
"actual": 0.014,
"amount": 0.014,
"currency": "USDC"
},
"quoteStatus": "ACCEPTED",
"redirectUrl": "https://pay.bvnk.com/payin/ad5c2cfc-6ec3-4e51-96f1-03dfad8efc11",
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"paidCurrency": {
"actual": 5,
"amount": 2,
"currency": "USDC"
},
"transactions": [
{
"hash": "0x7551bf6f17e2d354f21415bdc46234872d6cc9cce1f504259bb72326b9e53b34",
"amount": 5,
"sources": [
"0x9E8d7C6b5A4f3E2d1C0B9a8F7e6D5c4B3a2F1e0D"
],
"isOnHold": false,
"protocol": "ERC20",
"dateCreated": 1753352226000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"dateConfirmed": 1753352291000,
"networkFeeAmount": 0.000148,
"networkFeeCurrency": "USDC"
}
],
"walletCurrency": {
"actual": 2,
"amount": 2,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 2,
"amount": 2,
"currency": "USDC"
},
"quoteExpiryDate": 1753352469000,
"networkFeeCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"merchantDisplayName": "merchaone",
"acceptanceExpiryDate": 1753352199000
},
"status": "PENDING",
"address": null,
"refunds": [],
"subType": "merchantRefund",
"twoStep": false,
"metadata": {},
"reference": "REFUND-RefundWebhook1-296593287",
"returnUrl": "",
"customerId": "gsyme",
"expiryDate": 1761236291296,
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"dateCreated": 1753352291000,
"displayRate": null,
"feeCurrency": {
"actual": 5.003059,
"amount": 5.003059,
"currency": "USDC"
},
"quoteStatus": "TEMPLATE",
"redirectUrl": "https://pay.bvnk.com/payout/bf651b97-722f-400b-b96f-3e56fe182cfe",
"exchangeRate": null,
"paidCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"transactions": [],
"walletCurrency": {
"actual": 0,
"amount": 3,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 0,
"amount": 3,
"currency": "USDC"
},
"quoteExpiryDate": null,
"networkFeeCurrency": null,
"merchantDisplayName": "merchaone",
"acceptanceExpiryDate": null
}
}{
"event": "bvnk:payment:crypto:refund-initiated",
"eventId": "01983c00-5c32-77c1-9cfe-984d7d2efa6a",
"timestamp": "2025-07-24T10:35:13.330886600Z",
"data": {
"flow": null,
"type": "OUT",
"uuid": "3b38d6e1-51b4-4c46-9ce5-1d17ac9f7449",
"pegged": false,
"refund": {
"flow": null,
"type": "IN",
"uuid": "f7c7adca-7e3a-4fcc-9cb1-87e36668a8b2",
"pegged": false,
"refund": null,
"status": "EXPIRED",
"address": {
"tag": null,
"uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/transfer?address=0x632cbf94b236419c63f23867a89f4beded3ee3da&uint256=2E+6",
"address": "0x632cbf94b236419c63f23867a89f4beded3ee3da",
"protocol": "ERC20",
"alternatives": []
},
"refunds": [],
"subType": "merchantPayIn",
"twoStep": false,
"metadata": {},
"reference": "RefundWebhookExp",
"returnUrl": "",
"customerId": "gsyme",
"expiryDate": 1753350971000,
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"dateCreated": 1753350575000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"feeCurrency": {
"actual": 0,
"amount": 0.014,
"currency": "USDC"
},
"quoteStatus": "ACCEPTED",
"redirectUrl": "https://pay.bvnk.com/payin/f7c7adca-7e3a-4fcc-9cb1-87e36668a8b2",
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"paidCurrency": {
"actual": 5,
"amount": 2,
"currency": "USDC"
},
"transactions": [
{
"hash": "0x8c29b2b0c6d841b550783c797d3b9668675c05fb17d56db1c9d2172db2536d0e",
"amount": 5,
"sources": [
"0xC0fFEe1234567890ABCdEf0123456789aBcDeF01"
],
"isOnHold": false,
"protocol": "ERC20",
"dateCreated": 1753353196000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"dateConfirmed": 1753353312000,
"networkFeeAmount": 0.00011,
"networkFeeCurrency": "USDC"
}
],
"walletCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"quoteExpiryDate": 1753350875000,
"networkFeeCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"merchantDisplayName": "merchaOne",
"acceptanceExpiryDate": 1753350605000
},
"status": "PENDING",
"address": null,
"refunds": [],
"subType": "merchantRefund",
"twoStep": false,
"metadata": {},
"reference": "RefundWebhook-318302166",
"returnUrl": "",
"customerId": "gsyme",
"expiryDate": 1761237313318,
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"dateCreated": 1753353313000,
"displayRate": null,
"feeCurrency": {
"actual": 5.003059,
"amount": 5.003059,
"currency": "USDC"
},
"quoteStatus": "TEMPLATE",
"redirectUrl": "https://pay.bvnk.com/payout/3b38d6e1-51b4-4c46-9ce5-1d17ac9f7449",
"exchangeRate": null,
"paidCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"transactions": [],
"walletCurrency": {
"actual": 0,
"amount": 5,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 0,
"amount": 5,
"currency": "USDC"
},
"quoteExpiryDate": null,
"networkFeeCurrency": null,
"merchantDisplayName": "MerchaOne",
"acceptanceExpiryDate": null
}
}Transaction detected
The bvnk:payment:channel:transaction-detectedwebhook is triggered when a new channel transaction is detected, and the transaction has not yet been confirmed.
{
"event": "bvnk:payment:crypto:transaction-detected",
"eventId": "01983bca-682c-703e-8750-f84aa1da9b61",
"timestamp": "2025-07-24T09:36:17.452414800Z",
"data": {
"flow": null,
"type": "IN",
"uuid": "a5408dae-2d58-4603-b16d-15994a48a7e7",
"pegged": false,
"refund": null,
"status": "PENDING",
"address": {
"tag": null,
"uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/transfer?address=0xe64c920a27ef8424022bb354e2b9de692c93f7c1&uint256=2E+6",
"address": "0xe64c920a27ef8424022bb354e2b9de692c93f7c1",
"protocol": "ERC20",
"alternatives": []
},
"refunds": [],
"subType": "merchantPayIn",
"twoStep": false,
"metadata": {},
"reference": "TransactionWebhooks",
"returnUrl": "",
"customerId": "gsyme",
"expiryDate": 1753350009000,
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"dateCreated": 1753349709000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"feeCurrency": {
"actual": 0,
"amount": 0.014,
"currency": "USDC"
},
"quoteStatus": "ACCEPTED",
"redirectUrl": "https://pay.bvnk.com/payin/a5408dae-2d58-4603-b16d-15994a48a7e7",
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"paidCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"transactions": [
{
"hash": "0xb88f6ac232711c3d30e74c6bcb5333409c9a4d2dba477ce4c826ab942619485e",
"amount": 2,
"sources": [],
"isOnHold": false,
"protocol": "ERC20",
"dateCreated": 1753349777000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"dateConfirmed": null,
"networkFeeAmount": null,
"networkFeeCurrency": "USDC"
}
],
"walletCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"quoteExpiryDate": 1753350009000,
"networkFeeCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"merchantDisplayName": "merchaOne",
"acceptanceExpiryDate": 1753349739000
}
}{
"event": "bvnk:payment:crypto:transaction-detected",
"eventId": "01983ce6-2ec7-7edc-86da-f13b2d5c9a12",
"timestamp": "2025-07-24T14:46:14.983815400Z",
"data": {
"flow": null,
"type": "IN",
"uuid": "4eda87bd-e555-4310-ab2b-5ecaedd3039c",
"pegged": false,
"refund": null,
"status": "EXPIRED",
"address": {
"tag": null,
"uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/transfer?address=0xf796e7bbff462cf5981cb5283e7dca11a907ef2b&uint256=2E+6",
"address": "0xf796e7bbff462cf5981cb5283e7dca11a907ef2b",
"protocol": "ERC20",
"alternatives": []
},
"refunds": [],
"subType": "merchantPayIn",
"twoStep": false,
"metadata": {},
"reference": "RefundWViaWallet5",
"returnUrl": "",
"customerId": "gsyme",
"expiryDate": 1753368371000,
"merchantId": "e91a7928-7353-4ad4-93eb-32632f01b7b6",
"dateCreated": 1753368206000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"feeCurrency": {
"actual": 0,
"amount": 0.014,
"currency": "USDC"
},
"quoteStatus": "ACCEPTED",
"redirectUrl": "https://pay.bvnk.com/payin/4eda87bd-e555-4310-ab2b-5ecaedd3039c",
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"paidCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"transactions": [
{
"hash": "0x84c2affb25f03a20ebc4ebe0087455027c402ab2353edb6a9fc9ca338a999784",
"amount": 5,
"sources": [],
"isOnHold": false,
"protocol": "ERC20",
"dateCreated": 1753368375000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"dateConfirmed": null,
"networkFeeAmount": null,
"networkFeeCurrency": "USDC"
}
],
"walletCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"quoteExpiryDate": 1753368266000,
"networkFeeCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"merchantDisplayName": "USDC",
"acceptanceExpiryDate": 1753368236000
}
}{
"event": "bvnk:payment:channel:transaction-detected",
"eventId": "01983d02-0660-7000-8000-000000000000",
"timestamp": "2025-07-24T15:16:39.648Z",
"data": {
"channelId": "01983cff-e4dc-7a81-b136-ad1d00f5171b",
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"merchantDisplayName": "merchaOne",
"reference": "ChannelsDetected",
"dateCreated": 1753370199630,
"lastUpdated": 1753370199630,
"status": "DETECTED",
"uuid": "01983d02-0627-7363-9962-8cfb1120f633",
"hash": "0xe97dee4a51a8bd8e1274a76e7d6cfe66d4120bf19853afbab4b67e264b3956bd",
"address": "0xaae71e74b099ddd2cc02b4828f07a9ff33619f02",
"tag": null,
"paidCurrency": "USDC",
"displayCurrency": "USDC",
"walletCurrency": "USDC",
"feeCurrency": "USDC",
"paidAmount": 0,
"displayAmount": 0,
"walletAmount": 0,
"feeAmount": 0,
"exchangeRate": null,
"displayRate": null,
"risk": {
"level": "UNKNOWN",
"resourceName": "UNKNOWN",
"resourceCategory": "UNKNOWN",
"alerts": []
},
"sources": null,
"networkFee": {
"paidCurrency": null,
"paidAmount": 0,
"displayCurrency": null,
"displayAmount": 0
},
"pegged": false
}
}Transaction confirmed
The bvnk:payment:channel:transaction-confirmed webhook is triggered when a new channel transaction has been confirmed.
{
"event": "bvnk:payment:crypto:transaction-confirmed",
"eventId": "01983bcc-377d-7630-a325-1a082db90ca5",
"timestamp": "2025-07-24T09:38:16.061696300Z",
"data": {
"flow": null,
"type": "IN",
"uuid": "a5408dae-2d58-4603-b16d-15994a48a7e7",
"pegged": false,
"refund": null,
"status": "PROCESSING",
"address": {
"tag": null,
"uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/transfer?address=0xe64c920a27ef8424022bb354e2b9de692c93f7c1&uint256=2E+6",
"address": "0xe64c920a27ef8424022bb354e2b9de692c93f7c1",
"protocol": "ERC20",
"alternatives": []
},
"refunds": [],
"subType": "merchantPayIn",
"twoStep": false,
"metadata": {},
"reference": "TransactionProcessing",
"returnUrl": "",
"customerId": "gsyme",
"expiryDate": 1753350009000,
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"dateCreated": 1753349709000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"feeCurrency": {
"actual": 0,
"amount": 0.014,
"currency": "USDC"
},
"quoteStatus": "ACCEPTED",
"redirectUrl": "https://pay.bvnk.com/payin/a5408dae-2d58-4603-b16d-15994a48a7e7",
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"paidCurrency": {
"actual": 2,
"amount": 2,
"currency": "USDC"
},
"transactions": [
{
"hash": "0xb88f6ac232711c3d30e74c6bcb5333409c9a4d2dba477ce4c826ab942619485e",
"amount": 2,
"sources": [
"0x7A9b1C3d5E7f9A1b3C5d7E9f1A3b5C7d9E1f3A5b"
],
"isOnHold": false,
"protocol": "ERC20",
"dateCreated": 1753349777000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"dateConfirmed": 1753349896053,
"networkFeeAmount": 0.000146122936802832,
"networkFeeCurrency": "USDC"
}
],
"walletCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"quoteExpiryDate": 1753350009000,
"networkFeeCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"merchantDisplayName": "merchaOne",
"acceptanceExpiryDate": 1753349739000
}
}{
"event": "bvnk:payment:channel:transaction-confirmed",
"eventId": "01983d15-ba8b-7000-8000-000000000000",
"timestamp": "2025-07-24T15:38:10.955Z",
"data": {
"channelId": "01983cff-e4dc-7a81-b136-ad1d00f5171b",
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"merchantDisplayName": "gsyme",
"reference": "ChannelsComplete",
"dateCreated": 1753371436000,
"lastUpdated": 1753371490889,
"status": "COMPLETE",
"uuid": "01983d14-e2fd-7800-90f0-e5bf92a8f49a",
"hash": "0x04ac8fc16e0dbf5114af0c3722e995a870eb72766e5729c306bf305079bfc98f",
"address": "0xaae71e74b099ddd2cc02b4828f07a9ff33619f02",
"tag": null,
"paidCurrency": "USDC",
"displayCurrency": "USDC",
"walletCurrency": "USDC",
"feeCurrency": "USDC",
"paidAmount": 2,
"displayAmount": 2,
"walletAmount": 2,
"feeAmount": 0.013999,
"exchangeRate": {
"base": "USDC",
"counter": "USDC",
"rate": 1
},
"displayRate": {
"base": "USDC",
"counter": "USDC",
"rate": 1
},
"risk": {
"level": "UNKNOWN",
"resourceName": "UNKNOWN",
"resourceCategory": "UNKNOWN",
"alerts": []
},
"sources": [
"0xC0fFEe1234567890ABCdEf0123456789aBcDeF01"
],
"networkFee": {
"paidCurrency": "ETH",
"paidAmount": 0.000214355416260472,
"displayCurrency": "USDC",
"displayAmount": 0.798519
},
"pegged": false
}
}{
"event": "bvnk:payment:crypto:transaction-confirmed",
"eventId": "01983c00-5771-7092-8587-65cc19eb365a",
"timestamp": "2025-07-24T10:35:12.113504600Z",
"data": {
"flow": null,
"type": "IN",
"uuid": "f7c7adca-7e3a-4fcc-9cb1-87e36668a8b2",
"pegged": false,
"refund": null,
"status": "EXPIRED",
"address": {
"tag": null,
"uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/transfer?address=0x632cbf94b236419c63f23867a89f4beded3ee3da&uint256=2E+6",
"address": "0x632cbf94b236419c63f23867a89f4beded3ee3da",
"protocol": "ERC20",
"alternatives": []
},
"refunds": [],
"subType": "merchantPayIn",
"twoStep": false,
"metadata": {},
"reference": "RefundExprired",
"returnUrl": "",
"customerId": "gsyme",
"expiryDate": 1753350971000,
"merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
"dateCreated": 1753350575000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"feeCurrency": {
"actual": 0,
"amount": 0.014,
"currency": "USDC"
},
"quoteStatus": "ACCEPTED",
"redirectUrl": "https://pay.bvnk.com/payin/f7c7adca-7e3a-4fcc-9cb1-87e36668a8b2",
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"paidCurrency": {
"actual": 5,
"amount": 2,
"currency": "USDC"
},
"transactions": [
{
"hash": "0x8c29b2b0c6d841b550783c797d3b9668675c05fb17d56db1c9d2172db2536d0e",
"amount": 5,
"sources": [
"0xC0fFEe1234567890ABCdEf0123456789aBcDeF01"
],
"isOnHold": false,
"protocol": "ERC20",
"dateCreated": 1753353196000,
"displayRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"exchangeRate": {
"base": "USDC",
"rate": 1,
"counter": "USDC"
},
"dateConfirmed": 1753353312107,
"networkFeeAmount": 0.000109810013530228,
"networkFeeCurrency": "USDC"
}
],
"walletCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"currencyOptions": null,
"displayCurrency": {
"actual": 0,
"amount": 2,
"currency": "USDC"
},
"quoteExpiryDate": 1753350875000,
"networkFeeCurrency": {
"actual": 0,
"amount": 0,
"currency": null
},
"merchantDisplayName": "merchaOne",
"acceptanceExpiryDate": 1753350605000
}
}Updated 1 day ago