Bila← Docs

Rails

One Charge endpoint, many rails. Pick the rail at request time with the rail field, or pass rail:auto and let Bila route.

Available today

CodeStatusCountryCurrenciesCarrier mapping
sandboxactive—USD, SOSTest simulator. Use it with sk_test_ keys.
waafipayliveSOUSD, SLSH, DJFHormuud EVC Plus. MSISDN prefixes 61/62/63/65/66/68/77/90.
edahabbetaSOUSD, SOSSomtel eDahab. Prefixes 64/69. Connector ready; credentials pending.

Planned

CodeStatusWhat it is
premier_mcdisabledPremier Bank Mastercard acquiring (cards via 3DS hosted page).
sahaldisabledGolis Telecom Sahal mobile money.
mybankdisabledSalaam Somali Bank MyBank.
amaldisabledAmal Bank Somalia.
dahabshiildisabledDahabshiil eCash.
mpesa_sodisabledM-Pesa Somalia (Hormuud–Safaricom corridor).
telebirrdisabledTelebirr (Ethiopia). Awaits PSP licence + NBE correspondent.

See live rail health at /status.

Per-rail capabilities

Each rail exposes a capabilities object: refunds, auth_capture, save_method. Query GET /v1/rails for the live values.

Smart routing

Pass rail: "auto" and Bila resolves the rail in this order: (1) MSISDN carrier prefix, (2) your merchant rail-preferences (configurable at /dashboard/settings/rails), (3) Bila's global default order. See Collecting payments for examples.

Adding a rail

When a new rail's operator credentials land with Tabsamo Group, the connector is a one-file swap (lib/rails/<rail>.ts) — no API changes for your app. Charges with rail: "auto" on the matching MSISDN prefix start routing to the new rail automatically.