Create a Transaction

Changed on

This endpoint is used for Initiating funds transfer to beneficiaries.

post/transactions

Request

  • Base URL
    https://api.sandbox.waza.co/payouts/v1
  • URL
    https://api.sandbox.waza.co/payouts/v1/transactions
  • Auth
    none required

Headers

x-waza-keystring

your app key

Request body

amountstring required

in the lowest denominator i.e. kobo

currency'NGN' | 'USD' required

Currency of Beneficiary

country'NG' | '' required

Country of Beneficiary

customer_referencestring required

uniquely generated reference for transaction

descriptionstring required

e.g. purpose of payment

Response

200

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

Changes