BYLLS 2.0 Infrastructure|Multi-Provider Aggregation Engine

Financial infrastructure for digital services.

One unified, provider-agnostic API for bill payments, mobile airtime, SMS credits, and digital vouchers. Built for fintechs, neo-banks, and platforms demanding guaranteed idempotency and sub-100ms execution.

Request
curl -X POST https://bylls-api-production.up.railway.app/api/v1/organizations/org_acme/transactions \
  -H "X-API-Key: bylls_live_8f39c04b82d..." \
  -H "Content-Type: application/json" \
  -d '{
    "clientReference": "inv_2026_0941",
    "serviceId": "svc_elec_prepaid",
    "amount": 75.00,
    "currency": "USD",
    "inputData": {
      "meterNumber": "04294829104",
      "customerPhone": "+212600112233"
    }
  }'
Response201 Created • 84ms
{
  "success": true,
  "data": {
    "id": "txn_8c41f71a9e",
    "internalReference": "BYLLS-TXN-2026-99418",
    "clientReference": "inv_2026_0941",
    "status": "SUCCESS",
    "amount": 75.00,
    "fee": 0.95,
    "netAmount": 74.05,
    "currency": "USD",
    "outputData": {
      "token": "4920-1940-5829-1940-0294",
      "unitsKwh": "214.5",
      "receiptNumber": "REC-994120"
    },
    "createdAt": "2026-10-03T08:30:00.000Z"
  }
}
99.99%
Uptime SLA Guaranteed
< 85ms
Mean Execution Latency
100%
Idempotent Transactions
Zero
Provider Lock-in
Aggregated Catalog

Every digital service through one unified schema

Stop stitching together brittle, disparate third-party APIs. BYLLS unifies billing, mobile top-ups, and vouchers into standard endpoints.

BILLSPrepaid & Postpaid

Utility & Bill Payments

Electricity meters (prepaid token generation & postpaid), water, internet, and cable TV networks.

AIRTIMEReal-time Topup

Airtime & Mobile Bundles

Instant airtime reload and data bundles across local and international cellular networks.

MESSAGINGTwilio + Telcos

SMS Credits & Messaging

Hybrid routing via Twilio and local telco providers with intelligent cost-per-credit optimization.

VOUCHERSInstant Delivery

Digital Vouchers & Cards

On-demand digital voucher code generation for streaming, gaming, food delivery, and retail platforms.

ACCOUNTINGDouble-Entry

Pre-funded Wallet & Ledger

Automated double-entry accounting with real-time balance tracking, reserved locks, and immutable audits.

WEBHOOKSGuaranteed Delivery

HMAC Webhooks & Retry Queue

Real-time status updates delivered to your servers with cryptographic HMAC-SHA256 verification and BullMQ retries.

Engineered for 99.99% Availability

Fault-tolerant orchestration with automatic failover

Downstream providers go down. Your checkout never should. BYLLS intelligently routes transactions through secondary and tertiary fallback adapters when upstream carriers experience latency or failures.

Idempotency keys prevent duplicate debits under network drops
Asynchronous transaction engine powered by Redis & BullMQ queues
Autonomous reconciliation batches to catch downstream edge cases
Encrypted credential storage with scoped API key rotation
Routing TopologyActive Gateway
Client Request
POST /api/v1/transactions
TLS 1.3
BYLLS Core GatewaySub-10ms
Auth & Scopes
Ledger Hold
Smart Route
Primary Provider
Twilio / Aggregator
Secondary Fallback
Direct Telco API
Tertiary Route
Mock / Sandbox
Designed For Scale

Empowering leading fintech products

Whether launching a neo-bank or enhancing an existing mobile wallet, BYLLS delivers immediate time-to-market.

Digital Wallets & Super Apps

Embed utility payments, airtime reloads, and transit cards directly inside your mobile application without signing multiple telco contracts.

Single balance across all services
White-labeled user experience
Instant confirmation webhooks

B2B Platforms & Marketplaces

Equip your merchant ecosystem with utility disbursements, automated messaging credits, and business bill settlement rails.

Multi-tenant organization segregation
Granular team permissions
Automated monthly invoice receipts

Payroll & Employee Benefits

Automate salary advance airtime allowances, utility bill allowances, and gift card distributions via scheduled batch endpoints.

Bulk quote calculation
Atomic balance reservation
Comprehensive audit logging

Global Payment Aggregators

Expand regional payment coverage in emerging markets with standardized REST endpoints and unified reconciliation reports.

Multi-currency balance support
Webhook HMAC signatures
OpenAPI 3.1 specifications
Ready for integration

Start integrating in less than 10 minutes

Create your organization sandbox, generate your development API keys, and test end-to-end payment flows with simulated carriers.