Transactions (Initiation)

The transaction endpoint facilitates the initiation of funds transfer to beneficiaries. By providing details about the amount, beneficiary, sender, and other optional metadata, you can execute payouts seamlessly through this endpoint.

Request Body

Field	Type	Description	Required
`amount`	integer	The amount to be transferred in the smallest unit of the currency.	Yes
`currency`	string	The currency code, e.g., "NGN" for Nigerian Naira.	Yes
`country`	string	The ISO country code for the transfer, e.g. "NG"	Yes
`beneficiary`	object	Details of the beneficiary receiving the funds.	Yes
`metadata`	object	Additional information for the transaction.	No
`customer_reference`	string	A unique reference provided by the client for this transaction.	Yes
`description`	string	A brief description or purpose of the payment.	Yes
`sender`	object	Details of the person or entity sending the funds.	Yes

Beneficiary Object:

Field	Type	Description	Required
`type`	string	Type of beneficiary account. Typically "BANK_ACCOUNT".	Yes
`account_name`	string	Name on the beneficiary's account.	Yes
`account_number`	string	Beneficiary's account number.	Yes
`bank_code`	string	The bank's unique identification code.	Yes
`bank_name`	string	Official name of the beneficiary's bank.	Yes

Sender Object:

Field	Type	Description	Required
`name`	string	Full name of the sender.	Yes
`country`	string	The ISO country code of the sender, e.g. "NG".	Yes
`send_currency`	string	The currency code the sender is using.	Yes
`send_amount`	integer	Amount being sent by the sender in the smallest unit.	Yes
`dob`	string	Sender's date of birth in YYYY-MM-DD format. Optional.	No
`address`	string	Sender's address. Optional.	No

Sample Data Response

{
    "data": {
        "id": "waza_trf_LHg8_1689553108124",
        "amount": 18000,
        "currency": "NGN",
        "country": "NG",
        "beneficiary": {
            "type": "BANK_ACCOUNT",
            "account_name": "Frank Sani",
            "account_number": "123400001",
            "bank_code": "090365",
            "bank_name": "CORESTEP MICROFINANCE BANK"
        },
        "state": "PENDING",
        "created_date": "2023-07-17T00:18:28.124Z",
        "completion_date": "2023-07-17T00:18:28.125Z",
        "customer_reference": "1234ab",
        "metadata": {
            "reason": "Payment from APP"
        },
        "balance_before": 1880000,
        "balance_after": 1862000
    }
}