Webhooks

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