Managing balances

Managing balances is another important aspect of using our B2B Global Payment API effectively. This documentation page provides an overview of how you can check and fund your account balances.

Check Account Balance

You can use our API to retrieve the current balance of your account at any time. This is useful for monitoring your available funds and ensuring you have sufficient resources for your transactions.

The balance API provides an endpoint that allows you to fetch your wallet balance.

Example Request

curl --request GET \
     --url https://api.sandbox.waza.co/v2/balances \
     --header 'accept: application/json' \
     --header 'waza-x-key: <your waza api key>'

Example response

{
  "data": [
    {
      "currency": "NGN",
      "balance": 4665000,
      "country": "NG"
    }
  ]
}

📔

Balances are in the lowest currency value - kobo or cent.

Fund Account Balance

On signup and completion of onboarding on Waza, we provide a dedicated bank account in your local currency, which you can make deposits into to fund your balance. All payments into this account get credited into your account on Waza.

Your can use our API to retrieve the methods through which you can fund your account balance.

Example Request

curl --request GET \
     --url https://api.sandbox.waza.co/v2/payment-methods \
     --header 'accept: application/json' \
     --header 'waza-x-key: <your waza api key>'

Example response

{
  "data": [
    {
      "type": "bank_account",
      "country": "NGA",
      "currency": "NGN",
      "attributes": {
        "bank_name": "PROVIDUS BANK",
        "account_name": "Waza Workspaces 15",
        "account_number": "3016611276"
      }
    }
  ]
}

🔒

Your payments are safe and secure with Waza. We’ve implemented military-grade security tools designed to detect and prevent fraud, with real-time monitoring of transactions and other activities.