Notification

This document provides a sample payload for transaction notifications. It outlines the structure and fields that are included in a transaction notification message to a webhook.

Use this as a reference for building, testing, or consuming transaction notifications within your system.

Paylaod Body Fields

Field Name	Type	Required	Description
`account_number`	string	Yes	The account number involved in the transaction.
`amount`	string or number	Yes	The transaction amount. This value may be provided as a string or a numeric type.
`sourceBankName`	string	Yes	The name of the bank initiating the transaction.
`transactionStatus`	string	Yes	The status of the transaction (e.g., `CONFIRMED`, `PENDING`).
`transactionReference`	string	Yes	A unique reference identifier for the transaction.
`session_id`	string	Yes	The session identifier, which typically matches the transaction reference.
`type`	string	Yes	The type of the transaction (e.g., `Normal`), indicating the nature of the transaction.
`destinationAccountNUBAN`	string	Yes	The NUBAN number for the destination account.
`destinationAccountName`	string	Yes	The name of the destination account holder.
`destinationInstitutionCode`	string	Yes	The institution code for the destination financial institution.
`narration`	string	No	Optional additional details or notes about the transaction.
`sourceAccountNUBAN`	string	Yes	The NUBAN number for the source account.
`name`	string	Yes	The name associated with the notification, typically reflecting the destination account name.
`sourceInstitutionCode`	string	Yes	The institution code for the source financial institution.
`destinationBankName`	string	Yes	The name of the bank receiving the transaction.
`sourceAccountName`	string	Yes	The name of the source account holder.

Payload Example

{
    "account_number": "9000003702",
    "amount": "100.0",
    "sourceBankName": "STANBIC IBTC BANK PLC",
    "transactionStatus": "CONFIRMED",
    "transactionReference": "000012240813141505939055370222",
    "session_id": "000012240813141505939055370222",
    "type": "Normal",
    "destinationAccountNUBAN": "9000003702",
    "destinationAccountName": "Customer 1",
    "destinationInstitutionCode": "090682",
    "narration": "Hi",
    "sourceAccountNUBAN": "0040088210",
    "name": "Customer 1",
    "sourceInstitutionCode": "000012",
    "destinationBankName": "EXAMPLE POWER MFB",
    "sourceAccountName": "JOHN DOE"
}

This document serves as a guide for the expected structure of transaction notification payloads. Adjustments may be necessary depending on your specific implementation needs.

Paylaod Body Fields#

Payload Example#

Paylaod Body Fields

Payload Example