Enable Wallet Creation Notifications

A wallet creation webhook provides real-time notifications to your system when a new wallet is successfully created, enabling seamless integration and automated updates.

Webhook Type

In the wallet (currently applicable only to customer wallets) creation workflow you should expect to receive the following webhooks:

Event	Description
`bvnk:ledger:wallet:create`	The wallet creation request has transitioned to a new state.

Data Types

Field	Description
`event`	Type of the event triggering the webhook.
`eventId`	Unique identifier for the event.
`timestamp`	Timestamp of when the event occurred.
`data.status`	Status of the wallet creation request. Possible values: `PROCESSING` `REJECTED` `COMPLETED`
`data.id`	Unique identifier of the wallet.
`data.walletName`	Name of the wallet.
`data.currencyCode`	Currency code of the wallet.
`data.accountReference`	Unique reference of the account that owns the wallet.
`data.customerReference`	Unique reference of the customer that owns the wallet. Optional.
`data.ledgers`	Information object about the ledger.
`data.ledgers[0].type`	Type of the ledger. Possible values: `FIAT` `CRYPTO`
`data.ledgers[0].code`	Code for the bank that issued the ledger. Provided only if `ledgers.type` = `FIAT`.
`data.ledgers[0].accountNumber`	Bank account number. Provided only if `ledgers.type` = `FIAT`.
`data.ledgers[0].accountNumberFormat`	Format of the account number. Provided only if `ledgers.type` = `FIAT`. Possible values: `IBAN` `SCAN` `SWIFT` `ABA` `BBAN` `CUBIX`

Webhook Example

{
   "event": "bvnk:ledger:wallet:create",
   "eventId": "0193da1c-a95f-7f7d-a524-f1a3654bec86",
   "timestamp": "2024-12-18T14:12:11.743368759Z",
      "data": {
         "id": "a:24121851098381:mohEmnT:1",
         "status": "COMPLETED",
         "ledgers": [
            {
               "code": "LHVBEE20",
               "type": "FIAT",
               "accountNumber": "EE047777000028534345",
               "accountNumberFormat": "IBAN"
            }
         ],
         "walletName": "Finance Wallet",
         "currencyCode": "EUR",
         "accountReference": "3399c975-e1c1-4acf-9a90-6cfbdcdeaaea",
         "customerReference": "f62a5da6-f727-4a6b-bb51-78003545b7ee"
      }
}