Webhooks

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": "6ac3d2f75677120024d9b573",
    "client": "695b887f5877190024248935",
    "account": "6985f82373894e0024892867",
    "type": "Inwards",
    "sessionId": "100033261005164021958568653551",
    "nameEnquiryReference": "100033261005164008621675730778",
    "paymentReference": "100033261005164021958568653551",
    "mandateReference": null,
    "isReversed": false,
    "reversalReference": null,
    "provider": "NIBSS",
    "providerChannel": "NIP",
    "providerChannelCode": "3",
    "destinationInstitutionCode": "090286",
    "creditAccountName": "KYETECHGLOBAL / PRINCE MUTEH",
    "creditAccountNumber": "5010073948",
    "creditBankVerificationNumber": null,
    "creditKYCLevel": "3",
    "debitAccountName": "PRINCE KYEMUTEH ETATUVIE",
    "debitAccountNumber": "7030338024",
    "debitBankVerificationNumber": null,
    "debitKYCLevel": "3",
    "transactionLocation": "",
    "narration": "PRINCE KYEMUTEH ETATUVIE:7030338024",
    "amount": 100,
    "fees": 5,
    "vat": 0.38,
    "stampDuty": 0,
    "responseCode": "00",
    "responseMessage": "Approved or completed successfully",
    "status": "Completed",
    "isDeleted": false,
    "createdAt": "2026-10-05T16:40:23.617Z",
    "updatedAt": "2026-10-05T16:41:24.067Z",
    "__v": 0,
    "approvedAt": "2026-10-05T16:41:24.067Z"
  }
}

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