A complete recurring-billing engine with card charging, virtual account collection, smart dunning, and automated reconciliation — all on top of Nomba's payment infrastructure.
Tokenized card charging with intelligent retry logic. Handles Nigerian card declines gracefully with Nomba's payment rails.
Each customer gets a dedicated VA via Nomba. Bank transfers auto-reconcile to open invoices within minutes.
Automated retry schedules, grace periods, and configurable dunning presets to recover failed payments before cancellation.
# 1. Create a customer + provision their virtual account
POST /v1/customers
{ "name": "Acme Technologies", "email": "billing@acme.ng" }
# Response includes a ready-to-use Nomba virtual account:
{ "id": "cus_01", "va": { "accountNumber": "9391234567", "bankName": "Nomba MFB" } }
# 2. Subscribe them to a plan
POST /v1/subscriptions
{ "customerId": "cus_01", "planId": "plan_pro", "rail": "transfer" }
# 3. Webhook fires on every state change
POST https://your-app.com/webhooks
{ "type": "invoice.paid", "data": { "invoiceId": "inv_01", "amount": 500000 } }