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.

🚧
If you use walletID in the request that produces the webhook, note that you will also receive this field in the webhook response. In this case, you can ignore merchantID, since merchantId will be discontinued soon.

Crypto transactions

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
  }
}

Transaction on Hold

The bvnk:payment:crypto:transaction-on-hold webhook is triggered when a customer sends a payment to a BVNK wallet address and under BVNKs compliance engine the transaction deemed as High Risk.

This webhook notification alerts the recipient system about a cryptocurrency payment that is currently on hold. Post BVNK compliance checks the payment will either transition to COMPLETE or will be cancelled.

{
  "event": "bvnk:payment:crypto:transaction-on-hold",
  "eventId": "0198a4b0-9031-7c09-bbc4-a1f717f00e0f",
  "timestamp": "2025-08-13T18:28:11.441893Z",
  "data": {
    "flow": null,
    "type": "OUT",
    "uuid": "0198a4b0-5d46-7466-bf2e-67b57dc6f52c",
    "pegged": false,
    "refund": null,
    "status": "PROCESSING",
    "address": {
      "tag": null,
      "uri": "ethereum:0xdac17f958d2ee523a2206206994597c13d831ec7/transfer?address=0xa37fEAA3Aa6c98c04708c7e406B51Bf00Fe06d27&uint256=9978304",
      "address": "0xa37fEAA3Aa6c98c04708c7e406B51Bf00Fe06d27",
      "protocol": "ERC20",
      "alternatives": []
    },
    "refunds": [],
    "subType": "merchantPayOut",
    "twoStep": false,
    "metadata": {},
    "reference": "REF139312381150",
    "returnUrl": "",
    "customerId": "asdasdfead31d3d31",
    "expiryDate": 1755110878000,
    "merchantId": "73f0fe7c-5a1c-4cba-a4ea-0ac052f3591c",
    "dateCreated": 1755109678000,
    "displayRate": {
      "base": "USDT",
      "rate": 1.002174317399,
      "counter": "USD"
    },
    "feeCurrency": {
      "actual": 0,
      "amount": 0.1,
      "currency": "USD"
    },
    "quoteStatus": "ACCEPTED",
    "redirectUrl": "https://pay.sandbox.bvnk.com/payout/0198a4b0-5d46-7466-bf2e-67b57dc6f52c",
    "exchangeRate": {
      "base": "USD",
      "rate": 0.997830368837,
      "counter": "USDT"
    },
    "paidCurrency": {
      "actual": 0,
      "amount": 9.978304,
      "currency": "USDT"
    },
    "transactions": [
      {
        "hash": null,
        "amount": 9.978304,
        "sources": [],
        "isOnHold": true,
        "protocol": "ERC20",
        "dateCreated": 1755109691000,
        "displayRate": {
          "base": "USDT",
          "rate": 1.002174317399,
          "counter": "USD"
        },
        "exchangeRate": {
          "base": "USD",
          "rate": 0.9978303688372976,
          "counter": "USDT"
        },
        "dateConfirmed": null,
        "networkFeeAmount": 0,
        "networkFeeCurrency": "USDT"
      }
    ],
    "walletCurrency": {
      "actual": 10,
      "amount": 10,
      "currency": "USD"
    },
    "currencyOptions": null,
    "displayCurrency": {
      "actual": 0,
      "amount": 10,
      "currency": "USD"
    },
    "quoteExpiryDate": 1755110878000,
    "networkFeeCurrency": {
      "actual": 0,
      "amount": 1.75,
      "currency": "USD"
    },
    "merchantDisplayName": "USD 2",
    "acceptanceExpiryDate": 1755109708000
  }
}

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
  }
}

Channel Payments

Transaction detected and confirmed

The bvnk:payment:channel:transaction-detectedwebhook is triggered when a new channel transaction is detected, and the transaction has not yet been confirmed. The bvnk:payment:channel:transaction-confirmedwebhook is triggered when a new channel transaction is confirmed on chain, and the transaction has been processed.

{
  "event": "bvnk:payment:channel:transaction-detected",
  "eventId": "0198a515-86d7-7000-8000-000000000000",
  "timestamp": "2025-08-13T20:18:28.183Z",
  "data": {
    "channelId": "01985b37-ef43-761e-b70c-fddd2cfefffe",
    "merchantId": "a32f9409-1750-49be-bb2a-fc62b18e0fc8",
    "walletId": "a:24072237783989:Unkx9kW:1",
    "merchantDisplayName": "MoneyGram",
    "reference": "MoneyGram",
    "dateCreated": 1755116308156,
    "lastUpdated": 1755116308156,
    "status": "DETECTED",
    "uuid": "0198a515-8671-7ad8-bd58-79abec301e89",
    "hash": "0x97b27d27df128f027d2a124b3757c93cd3c1a4934876c0e4a79891c414c1c0b6",
    "address": "0xb330872f2c956dea57b19b72e9b0fc8f26a6a969",
    "tag": null,
    "paidCurrency": "USDT",
    "displayCurrency": "USD",
    "walletCurrency": "USD",
    "feeCurrency": "USD",
    "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
  }
}

{
  "event": "bvnk:payment:channel:transaction-confirmed",
  "eventId": "0198a516-3442-7000-8000-000000000000",
  "timestamp": "2025-08-13T20:19:12.578Z",
  "data": {
    "channelId": "01985b37-ef43-761e-b70c-fddd2cfefffe",
    "merchantId": "a32f9409-1750-49be-bb2a-fc62b18e0fc8",
    "walletId": "a:24072237783989:Unkx9kW:1",
    "merchantDisplayName": "MoneyGram",
    "reference": "MoneyGram",
    "dateCreated": 1755116308000,
    "lastUpdated": 1755116352463,
    "status": "COMPLETE",
    "uuid": "0198a515-8671-7ad8-bd58-79abec301e89",
    "hash": "0x97b27d27df128f027d2a124b3757c93cd3c1a4934876c0e4a79891c414c1c0b6",
    "address": "0xb330872f2c956dea57b19b72e9b0fc8f26a6a969",
    "tag": null,
    "paidCurrency": "USDT",
    "displayCurrency": "USD",
    "walletCurrency": "USD",
    "feeCurrency": "USD",
    "paidAmount": 10,
    "displayAmount": 9.9,
    "walletAmount": 9.9,
    "feeAmount": 0.05,
    "exchangeRate": {
      "base": "USDT",
      "counter": "USD",
      "rate": 0.99033
    },
    "displayRate": {
      "base": "USDT",
      "counter": "USD",
      "rate": 0.99033
    },
    "risk": {
      "level": "UNKNOWN",
      "resourceName": "UNKNOWN",
      "resourceCategory": "UNKNOWN",
      "alerts": []
    },
    "sources": [
      "0xa7d78498f7010e8ffac098d0b3a208c46896e00d"
    ],
    "networkFee": {
      "paidCurrency": "ETH",
      "paidAmount": 0.000344635113987594,
      "displayCurrency": "USD",
      "displayAmount": 1.59
    },
    "pegged": false
  }
}

Transaction on hold

The bvnk:payment:channel:transaction-on-hold webhook is triggered when a transaction sent to a channel is placed on hold under BVNKs compliance programme. If the payment is released, you will receive the bvnk:payment:channel:transaction-confirmed event.

{
  "event": "bvnk:payment:channel:transaction-on-hold",
  "eventId": "019899b5-55f3-7000-8000-000000000000",
  "timestamp": "2025-08-11T15:17:34.835Z",
  "data": {
    "channelId": "019899a3-2046-7292-946d-71e9fb04fecc",
    "merchantId": "d06b9f44-9302-4b45-adbb-0ad4e97d98e8",
		"walletId": "a:24072237783989:Unkx9kW:1",
    "merchantDisplayName": "ETH Channel Same Currency Fee",
    "reference": "eur-USDC-channel-sanctioned-originator",
    "dateCreated": 1754925414000,
    "lastUpdated": 1754925454820,
    "status": "HELD",
    "uuid": "019899b4-b805-7e11-abc8-777d07e0b1a1",
    "hash": "0xb178c995f9934198c5269ae0ec9ac8771bb73f733b868e799820442769e962f8",
    "address": "0x46b42c6a9d36b3d428c8f9ffb937682dd3c11a00",
    "tag": null,
    "paidCurrency": "USDC",
    "displayCurrency": "USDC",
    "walletCurrency": "ETH",
    "feeCurrency": "ETH",
    "paidAmount": 10,
    "displayAmount": 0,
    "walletAmount": 0,
    "feeAmount": 0,
    "exchangeRate": null,
    "displayRate": null,
    "risk": {
      "level": "UNKNOWN",
      "resourceName": "UNKNOWN",
      "resourceCategory": "UNKNOWN",
      "alerts": []
    },
    "sources": [
      "0xa37feaa3aa6c98c04708c7e406b51bf00fe06d27"
    ],
    "networkFee": {
      "paidCurrency": "ETH",
      "paidAmount": 0.000052532028993292,
      "displayCurrency": null,
      "displayAmount": 0
    },
    "pegged": false
  }
}

If you use walletID in the request that produces the webhook, note that you will also receive this field in the webhook response. In this case, you can ignore merchantID, since merchantId will be discontinued soon.

Crypto transactions

Status change

Transaction late

Transaction on Hold

Refund initiated

Channel Payments

Transaction detected and confirmed

Transaction on hold

If you use `walletID` in the request that produces the webhook, note that you will also receive this field in the webhook response. In this case, you can ignore `merchantID`, since merchantId will be discontinued soon.