Docs · v1 preview
Bila API
One REST API for every Somali payment rail. Stripe-style — if you've used Stripe, you know Bila.
Quickstart
Accept your first payment in 5 minutes.
Authentication
sk_test_ and sk_live_ keys, idempotency keys, request IDs.
Charges
The central money object. Create, retrieve, list, refund.
Webhooks
Signed events sent to your endpoints. Retried 9 times over 72h.
Rails
WaafiPay, eDahab, Premier MC, more. Per-rail capabilities.
API reference
Interactive OpenAPI 3.1 reference (Scalar) — try every endpoint right in the browser.
OpenAPI 3.1 YAML
Raw spec. Import into Postman, Insomnia, or generate your own SDK.
Guides
Collecting payments
The full charge → confirm → settle flow with every rail.
Handling webhooks
Verify signatures, idempotency, and dead-letter recovery.
Refunds & balance
Full and partial refunds, balance reconciliation, payouts.
Errors
Error envelope shape, codes, when to retry vs surface.
Going live
Live-key gating, KYC checklist, production checklist.
SDKs
@bila/node — official TypeScript SDK.
Versioning
Pin to a dated API version with the Bila-Version header. See the changelog for breaking changes and migration notes.
Errors
Every error response carries a request_id in the body and the Bila-Request-Id header. Paste it into a support email and we'll find the request in seconds.
See the live status page for current rail health.