If you enable webhook notifications and set a webhook URL, Safe Haven will send webhook events to notify updates, transfers, transactions.
Webhook Account Credit
{
"eventType": "account.credit",
"type": "transfer",
"data": {
"queued": false,
"limitExceeded": false,
"_id": "69ca8144d1972300241afb5b",
"client": "6874eb47aaad890024be3930",
"account": "6874eb48aaad890024be3931",
"type": "Inwards",
"sessionId": "999240260330135724548589538648",
"nameEnquiryReference": "999240260330135712652575838577",
"paymentReference": "SHW-300326145723770",
"mandateReference": null,
"isReversed": false,
"reversalReference": null,
"provider": "BANK",
"providerChannel": "TRANSFER",
"providerChannelCode": "IBS",
"destinationInstitutionCode": "999240",
"creditAccountName": "PRIMETECH",
"creditAccountNumber": "0117964837",
"creditBankVerificationNumber": null,
"creditKYCLevel": "3",
"debitAccountName": "SALIUTECH",
"debitAccountNumber": "0114012524",
"realDebitAccountName": "SALIUTECH",
"realDebitAccountNumber": "0114012524",
"debitBankVerificationNumber": null,
"debitKYCLevel": "3",
"transactionLocation": "9.0932,7.4429",
"narration": "",
"amount": 500,
"fees": 0,
"vat": 0,
"stampDuty": 0,
"responseCode": "00",
"responseMessage": "Approved or completed successfully",
"status": "Completed",
"isDeleted": false,
"createdAt": "2026-03-30T13:57:24.457Z",
"updatedAt": "2026-03-30T13:57:24.457Z",
"__v": 0
}
}
Webhook Account Debit
{
"eventType": "account.debit",
"type": "transfer",
"data": {
"queued": false,
"limitExceeded": false,
"_id": "69ca80284b70e6002412d9de",
"client": "6874eb47aaad890024be3930",
"account": "6874eb48aaad890024be3931",
"type": "Outwards",
"sessionId": "999240260330135240846606296310",
"nameEnquiryReference": "999240260330135232160661808196",
"paymentReference": "SHW-300326145239643",
"mandateReference": null,
"isReversed": false,
"reversalReference": null,
"provider": "BANK",
"providerChannel": "TRANSFER",
"providerChannelCode": "IBS",
"destinationInstitutionCode": "999240",
"creditAccountName": "SUDO AFRICA LIMITED / SUDO SETTLEMENT ACCOUNT",
"creditAccountNumber": "0117071135",
"creditBankVerificationNumber": null,
"creditKYCLevel": "3",
"debitAccountName": "PRIMETECH",
"debitAccountNumber": "0117964837",
"debitBankVerificationNumber": null,
"debitKYCLevel": "3",
"transactionLocation": "9.0932,7.4429",
"narration": "",
"amount": 1000,
"fees": 0,
"vat": 0,
"stampDuty": 0,
"responseCode": null,
"responseMessage": null,
"status": "Created",
"isDeleted": false,
"createdAt": "2026-03-30T13:52:40.616Z",
"createdBy": "6874eaf8aaad890024be3912",
"updatedAt": "2026-03-30T13:52:40.616Z",
"__v": 0
}
}
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": 100,
"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
}
}