Enable Pay-in Notifications
A pay-in webhook delivers real-time notifications to your system about key pay-in events, such as initiation, completion, or failure, ensuring automated updates without manual polling.
Webhook Type
Once you have a vIBAN, and it receives a deposit, the following webhooks will be sent out:
Event | Description |
---|---|
bvnk:payment:payin:status-change | The pay-in has transitioned to a new state. |
Data Types
Field | Description |
---|---|
| Type of the event triggering the webhook. |
| Unique identifier for the event. |
| Timestamp of when the event occurred. |
| Status of the payout:
|
| Customer-specific reference for the transaction. Optional. |
| Unique reference for the transaction generated by BVNK. |
| Reference description of the payment. The text is propagated along with the transfer, so a beneficiary could see it. |
| Date the transaction was valued. |
| Value of the transaction amount. |
| Currency code of the transaction amount. |
| Value of the transaction fee. |
| Currency code of the transaction fee. |
| Payment method used for the pay-in. |
| Name of the sender, which can be a company or an individual. |
| Bank code of the sender. Optional. |
| Account number of the sender. Optional. |
| Format of the account number of the sender. |
| Originator's address line 1. Optional. |
| Originator's address line 2. Optional. |
| Sender's city. Optional. |
| Sender's region or state. Optional. |
| Sender's postal code. Optional. |
| Sender's country code. Optional. |
| Sender's full concatenated address. Optional. |
| Wallet ID of the beneficiary. |
| Type of the beneficiary (recipient) entity. |
| Name of the beneficiary for companies. |
| First name of the beneficiary for individuals. |
| Last name of the beneficiary for individuals. |
| Bank code of the beneficiary. Optional. |
| Account number of the beneficiary. |
| Format of the account number of the beneficiary. |
Webhook Example
{
"event":"bvnk:payment:payin:status-change",
"eventId":"4d9f2f80-7f4d-11ee-8c99-0242ac120002",
"timestamp":"2024-10-28T12:25:21.716405000Z",
"data":{
"status":"COMPLETED",
"customerReference":"fd808a48-7313-4773-8383-fffb62fdc2d7", // This will be received for embedded and nested use cases
"transactionReference":"fd808a48-7313-4773-8383-fffb62fdc2d7",
"paymentReference":"GBPCLEAREXTERNALPA",
"valueDate":"2024-09-12",
"amount":{
"value":39,
"currencyCode":"EUR"
},
"fee":{
"value":3,
"currencyCode":"EUR"
},
"paymentMethod":"SEPA_CT",
"originator":{
"name":"Some Business",
"bankAccount":{
"bankCode":"SAPYGB2L", //optional
"accountNumber":"GB93SAPY60838220490275", //optional
"accountNumberFormat":"IBAN"
},
"address": {
"addressLine1": "123 Main St",
"addressLine2": "Apt 4B",
"city": "London",
"region": "London",
"postCode": "12345",
"countryCode", "GB",
"fullAddress": "123 Main St, Apt 4B, London, London, 12345, GB"
},
},
"beneficiary":{
"walletId":"a:24042240678622:beEODVM:1",
"entity":{
"type":"COMPANY",
"name":"Some Business", //for company
"firstName":"John", //for individual
"lastName":"Doe", //for individual
},
"bankAccount":{
"bankCode":"LHVBEE20",
"accountNumber":"EE307777000028295451",
"accountNumberFormat":"IBAN"
}
},
"metadata": {
"someKey": "someValue",
"someKey2": {
"someKey3": "someValue3"
}
}
}
}
Updated 4 months ago