Skip to main content

Rails, countries & currencies

A rail is one way to pay — Orange Money, MTN MoMo, a card. Each rail is offered by a provider, in specific countries, and settles in specific currencies there. Orange Money in Senegal settles in XOF, for example.

The rule you price against​

ePay refuses a charge in a currency the chosen rail doesn't settle. There is no conversion and no default currency: a charge must name its currency, and that currency must be one the rail settles in the country the payment is routed to.

The consequence is simple, and it is the one to plan around: price your plans in a currency your rail settles. A plan priced in a currency your rail can't take is a plan nobody can pay for — the customer reaches checkout and the charge is refused.

A free plan has nothing to charge, so its currency is unrestricted.

Where you see what your rail settles​

You don't have to look this up. Each product asks ePay and shows you the answer:

  • Kuploy Cloud — the currency field on a plan at Admin → Plans only offers currencies your gateway's providers accept, and a paid plan can't be saved until the Payment Gateway is configured. See Manage Your Plans → Currency.
  • Leeram Business — the Tenant revenue merchant panel on /admin/license shows Rail settles in for the provider and country you picked. When it reads (unrestricted), the provider declares no limit there.

These are the early, friendlier half of the rule. If either check can't reach the gateway, checkout still goes ahead — and ePay still refuses a currency it can't settle.

Which rails exist where​

The countries ePay serves, the currencies it settles in each, and the payment methods on offer are listed on ePay's public pages:

A method that doesn't exist in the country a payment is routed to is simply not offered at checkout — see What your customers see.