If you enable webhook notifications and set an webhook url, Safe Haven will send webhook events to notify updates, transfers, transactions.


Webhook Type

transfer is sent as the webhook type when a transfer is made.

Webhook Object

{ "type": "transfer", "data": { "_id": "616f6ad6d5c1fb4ba1f00076", "client": "61fbc386dab3430a31406018", "account": "613bdab34c38b5140663001f", "type": "Inwards", "sessionId": "000004211020011401570815591371", "nameEnquiryReference": "000004211020011401345232274414", "paymentReference": "000004211020011401570815591371", "mandateReference": null, "isReversed": false, "reversalReference": null, "provider": "NIBSS", "providerChannel": "NIP", "providerChannelCode": "3", "destinationInstitutionCode": "090286", "creditAccountName": "JOHN DOE", "creditAccountNumber": "1234567890", "creditBankVerificationNumber": null, "creditKYCLevel": "3", "debitAccountName": "ACME LTD", "debitAccountNumber": "0987654321", "debitBankVerificationNumber": null, "debitKYCLevel": "1", "transactionLocation": "", "narration": "MOB2/UTO/To JOHN DOE/Test Notification", "amount": 100, "fees": 0, "vat": 0, "stampDuty": 0, "responseCode": "00", "responseMessage": "Approved or completed successfully", "status": "Completed", "isDeleted": false, "createdAt": "2021-10-20T01:14:04.054Z", "updatedAt": "2021-10-20T01:15:10.954Z", "__v": 0, "approvedAt": "2021-10-20T01:15:10.954Z" } }

Webook for Transfer to Virtual Account

{ "type": "virtualAccount.transfer", "data": { "_id": "65b76ed3c0a4440024e45e75", "client": "61e5a83ac6f0ec001ee90fac", "virtualAccount": "65b76ebbc0a4440024e45e52", "sessionId": "999240240129092434550231308787", "nameEnquiryReference": "999240240129092425585215261320", "paymentReference": "999240240129092434550231308787", "isReversed": false, "reversalReference": "", "provider": "BANK", "providerChannel": "TRANSFER", "providerChannelCode": "IBS", "destinationInstitutionCode": "999240", "creditAccountName": "BITAKOTECHNOLOG / OmaTech", "creditAccountNumber": "8060376145", "creditBankVerificationNumber": null, "creditKYCLevel": "3", "debitAccountName": "ZEALVEND", "debitAccountNumber": "0119536306", "debitBankVerificationNumber": null, "debitKYCLevel": "3", "transactionLocation": "9.0932,7.4429", "narration": "", "amount": 1001, "fees": 5, "vat": 0, "stampDuty": 0, "responseCode": "00", "responseMessage": "Approved or completed successfully", "status": "Completed", "isDeleted": false, "createdAt": "2024-01-29T09:24:35.910Z", "declinedAt": "2024-01-29T09:24:35.910Z", "updatedAt": "2024-01-29T09:24:37.994Z", "__v": 0 } }