NGN

When your NGN wallet is funded via any of the generated VBAs, details about the transaction are sent in a payload that provides essential information for record-keeping and reconciliation.


Parameters Overview

ParametersDescription
messageA message indicating the status of the transaction.
transaction_idA unique identifier for the transaction used for tracking and reference.
transaction_referenceA unique identifier for the transaction used for tracking and reference.
transaction_statusThe status of the transaction (e.g., SUCCESSFUL, FAILED).
transaction_feeThe fee charged for the transaction.
transaction_amount_without_feeThe amount that was transferred, excluding any fees.
transaction_amountThe total amount of the transaction, including fees.
transaction_currencyThe currency in which the transaction was conducted (e.g., NGN for Naira).
virtual_bank_accountAn object containing details of the virtual bank account associated with the transaction.
virtual_bank_account.idThe unique identifier for the virtual bank account.
virtual_bank_account.account_numberThe account number of the virtual bank account.
virtual_bank_account.account_nameThe name associated with the virtual bank account.
virtual_bank_account.bank_nameThe name of the bank that holds the virtual account.
source_informationAn object containing details about the source of the funds.
source_information.account_numberThe account number of the source account.
source_information.account_nameThe name associated with the source account.
source_information.bank_nameThe name of the bank for the source account.
event_idA unique identifier for the event associated with the transaction.
typeThe type of transaction, indicating it as a collection (e.g., "collection").

Example Payload

{
  "message": "Transaction Completed",
  "transaction_id": "20580e50-1b32-40a6-aa46-ac8e795b3zas",
  "transaction_reference": "000017240425120937445702087012",
  "transaction_status": "SUCCESSFUL",
  "transaction_fee": 0.0,
  "transaction_amount_without_fee": 100.0,
  "transaction_amount": 100.0,
  "transaction_currency": "NGN",
  "virtual_bank_account": {
    "id": "e4c09672-3db2-49c5-afa4-d3d1a3b856b4",
    "account_number": "3020000086",
    "account_name": "Derrick Huel",
    "bank_name": "quas"
  },
  "source_information": {
    "account_number": "IDOWU MATHEW DAMILOLA",
    "account_name": "0220901228",
    "bank_name": "WEMA BANK"
  },
  "event_id": "9d46a6c6-a872-4697-a72a-d327d189bec0",
  "type": "collection"
}