v1

latestOpenAPI 3.0.32026-07-264469137.7 KB
Payments

List payment rails

Get available payment rails for a specific payment method and currency combination. Use this to determine which payment rails are available before creating a quote. The 'id' field from the response should be used as the 'payment_rail' parameter when creating quotes.

get/v1/payment-methods/rails

Query parameters

payment_method'CARD' | 'CRYPTO' | 'BANK_TRANSFER' | 'MOBILE_MONEY' required

Payment method to get rails for

currencystring required

Currency code (e.g., 'NGN', 'USD', 'GHS', 'USDT_TRC20')

country_codestring

Optional ISO country code (e.g., 'NG', 'GH') to filter rails by country

Response

Success - Payment rails retrieved

payment_methodstring required

Payment method requested.

currencystring required

Currency requested.

country_codestring nullable

Resolved country code for this rail lookup.

Example response

{
  "rails": [
    {
      "id": "bank_transfer_ng",
      "name": "Bank Transfer Nigeria",
      "active": true
    }
  ]
}