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