Guides
  1. Integration Guides

Get Provider Networks for a Country

Retrieve the available payout networks for a country before you create a beneficiary account.

Get the available provider networks for a country so you can choose the right payout rail before you add a beneficiary account.

Prerequisites

  1. Set your NadaPay API base URL in $baseUrl.
  2. Export your NadaPay API key as YOUR_API_KEY.
  3. Generate a unique idempotency key for the request.

Step 1 — Fetch provider networks for a country

curl --request POST \
  --url $baseUrl/transactions/networks \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --header 'x-idempotency-key: YOUR_UNIQUE_UUID' \
  --data '{
    "country": "GH"
  }'

Response:

{
  "data": {
    "country": "GH",
    "networks": [
      {
        "code": "bank_transfer",
        "name": "Local Bank Transfer",
        "currency": "GHS",
        "type": "bank_account"
      },
      {
        "code": "mtn_momo",
        "name": "MTN Mobile Money",
        "currency": "GHS",
        "type": "mobile_money"
      },
      {
        "code": "vodafone_cash",
        "name": "Vodafone Cash",
        "currency": "GHS",
        "type": "mobile_money"
      }
    ]
  }
}

Step 2 — Use the network result when you add a beneficiary account

Use the returned network identifier in the details object required by the Add Beneficiary Account API reference for your selected account type.

📘

Network availability varies by corridor. Always fetch provider networks dynamically rather than hardcoding them.

What's next

Updated about 1 month ago