Institution Providers

`GET /v1/global-payout/bank/providers`

Returns available bank, institution, or mobile money providers. Use the isMobileMoney query parameter to switch between bank/institution and mobile money listings. Use the code from the response as institutionCode and displayName as institutionName in the Authorize Transfer request.

Query parameters

boolean

false returns bank or institution providers. true returns mobile money providers.

string

ISO 3166-1 alpha-2 destination country code (e.g., KE, ZA, GH, ET, RW). When provided, takes priority over the region derived from your JWT. Use this when your platform supports multiple destination countries — pass the recipient’s country code to get the correct provider list.

curl --request GET \
  --url 'https://api.nomba.com/v1/global-payout/bank/providers?countryIsoCode=US&isMobileMoney=false' \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

curl --request GET \
  --url 'https://api.nomba.com/v1/global-payout/bank/providers?isMobileMoney=true' \
  --header 'Authorization: Bearer <token>' \
  --header 'accountId: <accountId>'

{
  "code": "00",
  "description": "Success",
  "status": false,
  "data": [
    { "code": "access_bank", "displayName": "Access Bank" },
    { "code": "bank_of_africa", "displayName": "Bank Of Africa" },
    { "code": "eco_bank", "displayName": "Eco Bank" },
    { "code": "equity_bank", "displayName": "Equity Bank" },
    { "code": "raw_bank", "displayName": "Raw Bank" },
    { "code": "uba", "displayName": "United Bank of Africa" }
  ]
}

{
  "code": "00",
  "description": "Success",
  "status": false,
  "data": [
    { "code": "nomba", "displayName": "Nomba" },
    { "code": "airtel", "displayName": "Airtel Money" },
    { "code": "mpesa", "displayName": "Mpesa" },
    { "code": "orange", "displayName": "Orange" }
  ]
}

Always pass countryIsoCode when calling this endpoint. Multiple countries share the same currency (e.g., XOF covers Senegal and Côte d’Ivoire; XAF covers Cameroon and Gabon) — the country code is how the API returns the correct provider list for your destination. code from this endpoint → institutionCode in the transfer request. displayName → institutionName.

Providers by Country

Country	ISO Code	Currency	Institution Providers
DR Congo	CD	USD / CDF	Nomba, Airtel Money, M-Pesa, Orange
Kenya	KE	KES	M-Pesa
Ghana	GH	GHS	MTN Mobile Money
South Africa	ZA	ZAR	Bank only — use `isMobileMoney=false`
Senegal	SN	XOF	Orange Money, Wave
Côte d’Ivoire	CI	XOF	Orange Money, MTN, Moov, Wave
Ethiopia	ET	ETB	Safaricom M-Pesa, Ethio Telecom
Rwanda	RW	RWF	MTN Mobile Money, Airtel Money
Uganda	UG	UGX	MTN Mobile Money, Airtel Money
Cameroon	CM	XAF	MTN Mobile Money, Orange Money
Gabon	GA	XAF	Airtel Money, Moov
UAE	AE	AED	Bank only — use `isMobileMoney=false`

Provider codes (institutionCode) and display names (institutionName) returned by this endpoint are the canonical values — always call the API rather than hardcoding them, as they may be updated.

Response body

array

required

List of available institutions.

Hide institution object

string

The institution code. Use this as institutionCode in the Authorize Transfer request.

string

Human-readable institution name. Use this as institutionName in the Authorize Transfer request.

Introduction

Getting Started

Products

API Basics

Guides

Institution Providers

Institution Providers

`GET /v1/global-payout/bank/providers`

Query parameters

Providers by Country

Response body

Institution Providers

​GET /v1/global-payout/bank/providers

​Query parameters

​Providers by Country

​Response body

`GET /v1/global-payout/bank/providers`

Query parameters

Providers by Country

Response body