Skip to main content

Institutions

Institutions represent the supported banks and mobile money providers through which fiat payout transfers are processed.

Supported Fiat Institutions​

This step is only required when performing a fiat payout transfer.

Fiat payouts rely on local financial institutions.
Before initiating a transfer with operationType: fiat_payout, you must retrieve the list of supported institutions for the target fiat currency.

Get Supported Institutions​

Use this endpoint to fetch all supported banks and mobile money providers for a given fiat currency.

Request​

curl --request GET \
  --url https://api.sandbox.celar.io/api/v1/payments/serviceProvider/{currency} \
  --header 'Accept: application/json' \

Replace {currency} with the fiat currency code (for example: KES).

Response​

{
  "success": true,
  "data": [
    {
      "name": "Kenya Commercial Bank",
      "type": "bank"
    },
    {
      "name": "M-PESA",
      "type": "mobile_money"
    }
  ]
}

How Institutions Are Used​

  • The returned name is supplied as serviceProvider when creating a fiat payout transfer
  • The type determines the expected paymentMethod (bank or mobile)
  • Providing an unsupported institution will cause the transfer to fail validation