Skip to main content
When your NGN payouts are confirmed, details about the transaction are sent in a payload that provides essential information for record-keeping and reconciliation.

​
Parameter overview

ParameterDescription
messageIndicates the status of the transaction.
transaction_idA unique identifier for the transaction.
transaction_referenceA unique identifier for the transaction.
transaction_statusThe status of the transaction (e.g., SUCCESSFUL).
transaction_feeThe fee charged for the transaction.
transaction_amount_without_feeThe amount sent excluding fees.
transaction_amountThe total amount including fees.
transaction_currencyThe currency in which the transaction is conducted (NGN).
customer_idThe customer associated with the transaction
recipientDetails of the recipient, including:
recipient.account_numberThe recipient’s bank account number.
recipient.account_nameThe name associated with the recipient’s bank account.
recipient.bank_nameThe name of the bank holding the recipient’s account.
recipient.amountThe net amount that the recipient received.
event_idA unique identifier for the event.
typeThe type of transaction (e.g., payout).

​
Example payload

{
  "message": "Transaction Completed",
  "transaction_id": "20580e50-1b32-40a6-aa46-ac8e795b3zas",
  "transaction_reference": "90980e50-0b83-40a6-aa46-ac8e795b1acd",
  "transaction_status": "SUCCESSFUL",
  "transaction_fee": 39.12,
  "transaction_amount_without_fee": 612.88,
  "transaction_amount": 652.0,
  "transaction_currency": "NGN",
  "customer_id": "9d4c4ec5-59ea-4130-bf8a-6a5edec401ee",
  "recipient": {
    "account_number": "0222500691",
    "account_name": "Olaolu Adejide",
    "bank_name": "Zenith Bank",
    "amount": 612.88
  },
  "event_id": "9d46b957-0cf5-4743-847a-254d92de6a85",
  "type": "payout"
}