Corridors

Status: Available

This endpoint shows where you can move money, by region and by method. A corridor has three parts: a country, a direction, and a method. The direction is collect or pay out. Use this endpoint for your country and method menus. It is the live list of the methods and the local-currency limits.

Coverage at a glance

Collections (pay-in) — get paid in local money or crypto:

Africa — bank transfer and mobile money across African markets (e.g. NGN bank transfer, KES/UGX mobile money).
Latin America — local pay-in methods across LATAM markets.
Crypto — accept digital assets on any supported network (see collections); settled to your balance.

Payouts (pay-out) — send money almost anywhere:

Bank & mobile money to all countries except sanctioned jurisdictions.
Crypto to any supported asset/network (see payouts).

You always transact in USD. We calculate the local currency and the rate for each movement. This endpoint gives the current corridors. Use it, and not a list on this page.

List corridors

GET /v1/corridors

curl {BASE_URL}/v1/corridors \
  -H "x-api-key: sk_test_your_key_here"

Response

{
  "code": 200,
  "message": "Corridors fetched successfully",
  "data": [
    {
      "country": "NG",
      "country_name": "Nigeria",
      "collection": {
        "supported": true,
        "methods": [
          { "type": "bank", "name": "Bank Transfer", "currency": "NGN", "min_amount": 100, "max_amount": 2000000 }
        ]
      },
      "payout": {
        "supported": true,
        "methods": [
          { "type": "bank", "name": "Bank Transfer", "currency": "NGN", "min_amount": 100, "max_amount": 2000000 }
        ]
      }
    },
    {
      "country": "KE",
      "country_name": "Kenya",
      "collection": {
        "supported": true,
        "methods": [
          { "type": "momo", "name": "Mobile Money", "currency": "KES", "min_amount": 500, "max_amount": 250000 }
        ]
      },
      "payout": {
        "supported": true,
        "methods": [
          { "type": "momo", "name": "Mobile Money", "currency": "KES", "min_amount": 500, "max_amount": 250000 }
        ]
      }
    }
  ]
}

Corridor object

Field	Type	Description
`country`	string	ISO 3166-1 alpha-2 code (e.g. `NG`).
`country_name`	string	Display name.
`collection`	object	The pay-in side (see below).
`payout`	object	The pay-out side (see below).

Each of collection and payout:

Field	Type	Description
`supported`	boolean	Whether this direction is available for the country.
`methods`	array	Available payment methods for this direction.

Method object

Field	Type	Description
`type`	string	Method identifier (e.g. `bank`, `momo`).
`name`	string	Human-readable name (e.g. "Bank Transfer").
`currency`	string	Local currency moved on this method.
`min_amount`	number	Minimum, in the local currency.
`max_amount`	number	Maximum, in the local currency.

The min_amount and max_amount fields are in the local currency. They are for your end customers.

You always send and settle in USD. We calculate the equal USD amount at the current rate. When you start a movement, we show that amount in a quote. If a corridor direction has supported: false, you cannot use that direction.

Transaction Lifecycle

Balance