Transfer Notifications

With internal transfer webhook, you can receive real-time notifications to your system about key internal transfer events, such as initiation, completion, or failure, enabling automated updates without manual intervention.

See Create a Webhook Listener to learn how to configure a webhook.

Transfer: Status change

In the internal transfer workflow, you should expect to receive the bvnk:payment:transfer:status-change, which indicated that the transfer has transitioned to a new state.

{
   "event": "bvnk:payment:transfer:status-change",
   "eventId": "0193ba8c-74f4-7bd3-a2fb-00e43851577c",
   "timestamp": "2024-12-12T11:06:27.444216650Z",
   "data": {
      "fee": {
         "value": 0,
         "currencyCode": "EUR"
       },
      "amount": {
         "value": 10,
         "currencyCode": "EUR"
      },
      "status": "COMPLETED",
      "valueDate": "2024-12-12",
      "originator": {
         "entity": {
            "type": "INDIVIDUAL",
            "lastName": "John",
            "firstName": "Doe"
         },
         "walletId": "a:15972384650193:xKLMnPq:1",
         "accountReference": "3399c975-e1c1-4acf-9a90-6cfbdcdeaaea"
      },
      "beneficiary": {
         "entity": {
            "name": "Test Ltd",
            "type": "COMPANY"
         },
         "walletId": "b:38206947513024:bRTuVwX:2",
         "accountReference": "3399c975-e1c1-4acf-9a90-6cfbdcdeaaea"
      },
      "paymentReference": "REF124903",
      "transactionReference": "13584355-b879-11ef-982c-e1c33615f5a8"
   }
}

Field

Description

event

Type of event triggering the webhook.

eventId

Unique identifier for the event.

timestamp

Timestamp of when the event occurred.

data.status

Status of the transfer.

data.customerReference

Customer-specific reference for the transaction. Optional.

data.transactionReference

Unique reference for the transaction.

data.paymentReference

Reference code for the payment.

data.valueDate

Date the transaction was valued.

data.amount.value

Value of the transaction amount.

data.amount.currencyCode

Currency code of the transaction amount.

data.fee.value

Value of the transaction fee.

data.fee.currencyCode

Currency code of the transaction fee.

data.originator.walletId

Wallet ID of the sender / originator.

data.originator.accountReference

Unique reference for the account of the sender.

data.originator.entity.type

Type of the sender entity.

Possible values:

  • INDIVIDUAL
  • COMPANY

data.originator.entity.name

Name of the sender for companies.

data.originator.entity.firstName

First name of the sender for individuals.

data.originator.entity.lastName

Last name of the sender for individuals.

data.beneficiary.walletId

Wallet ID of the beneficiary (recipient).

data.beneficiary.accountReference

Unique reference for the account of the beneficiary.

data.beneficiary.entity.type

Type of beneficiary entity.

data.beneficiary.entity.name

Name of the beneficiary for companies.

data.beneficiary.entity.firstName

First name of the beneficiary for individuals.

data.beneficiary.entity.lastName

Last name of the beneficiary for individuals.

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": "01983c00-5d18-7e5e-b85c-c51cf4d42105",
  "timestamp": "2025-07-24T10:35:13.560470800Z",
  "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": "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": [
            "0xDeAdBeEf01234567890123456789aBcDeF014675"
          ],
          "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": "merchOne",
      "acceptanceExpiryDate": 1753350605000
    },
    "status": "PROCESSING",
    "address": {
      "tag": null,
      "uri": "ethereum:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48/transfer?address=0xDeAdBeEf01234567890123456789aBcDeF014675=5E+6",
      "address": "0xDeAdBeEf01234567890123456789aBcDeF014675",
      "protocol": "ERC20",
      "alternatives": []
    },
    "refunds": [],
    "subType": "merchantRefund",
    "twoStep": false,
    "metadata": {},
    "reference": "RefundWebhook-318302166",
    "returnUrl": "",
    "customerId": "gsyme",
    "expiryDate": 1761237313318,
    "merchantId": "a1050da2-b085-4a6c-a68b-8c2b1950615a",
    "dateCreated": 1753353313000,
    "displayRate": {
      "base": "USDC",
      "rate": 1,
      "counter": "USDC"
    },
    "feeCurrency": {
      "actual": 5.003059,
      "amount": 5.003059,
      "currency": "USDC"
    },
    "quoteStatus": "ACCEPTED",
    "redirectUrl": "https://pay.bvnk.com/payout/3b38d6e1-51b4-4c46-9ce5-1d17ac9f7449",
    "exchangeRate": {
      "base": "USDC",
      "rate": 1,
      "counter": "USDC"
    },
    "paidCurrency": {
      "actual": 0,
      "amount": 5,
      "currency": "USDC"
    },
    "transactions": [],
    "walletCurrency": {
      "actual": 5,
      "amount": 5,
      "currency": "USDC"
    },
    "currencyOptions": null,
    "displayCurrency": {
      "actual": 0,
      "amount": 5,
      "currency": "USDC"
    },
    "quoteExpiryDate": 1761237313318,
    "networkFeeCurrency": null,
    "merchantDisplayName": "merchaOne",
    "acceptanceExpiryDate": 1753353343353
  }
}

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