Nomba Checkout is a hosted payment page that lets your customers pay you through supported methods such as card, bank transfer, USSD, QR code, Buy Now Pay Later, Apple Pay, International Card, or Mobile Money where applicable. You create an order via API, display the checkout link to your customer, and Nomba handles the rest.Documentation Index
Fetch the complete documentation index at: https://developer.nomba.com/llms.txt
Use this file to discover all available pages before exploring further.
How it works
Get your API keys
Create an account and retrieve your
clientId, clientSecret, and accountId from the Nomba dashboard. See Get API Keys for a step-by-step guide.Authenticate
Exchange your credentials for a short-lived access token. Use the sandbox base URL (
https://sandbox.nomba.com) during development and https://api.nomba.com in production.Create a checkout order
Call
POST /v1/checkout/order with the amount, currency, and optional customer details. Nomba returns a checkoutLink and an orderReference.Display the checkout link
Redirect your customer to the
checkoutLink or embed it in an iframe. The customer completes payment on the Nomba-hosted page.Handle the webhook
Nomba sends a
payment_success event to your configured webhook URL when payment is completed. The webhook payload contains the transaction details and order reference.Supported payment methods
| Method | Description |
|---|---|
| Card | Mastercard, Visa, and Verve debit/credit cards |
| International Card | Cross-border card acceptance for supported foreign-currency checkout flows |
| Bank Transfer | Customer transfers directly to a dynamically generated account number |
| USSD | Payment via USSD shortcode on mobile |
| Nomba QR | QR code scan-to-pay |
| Buy Now Pay Later | Deferred payment option |
| Mobile Money | Accept CDF and USD through Mpesa, Orange and Airtel money in DRC |
| Apple Pay | On supported Apple devices |
allowedPaymentMethods field when creating an order.
Quick links
Create a Checkout Order
Full field reference, code examples, split payments, and tokenization
Verify Transactions
Confirm payment status before delivering value
Sandbox Testing
End-to-end walkthrough for testing your integration
Refund an Order
Process full or partial refunds for completed transactions
Cancel an Order
Cancel a pending order before payment is made
Payment Methods
See all supported card networks and payment options
SDKs and integrations
For web and mobile integrations, using an SDK reduces boilerplate and handles token management for you.React / Web
Use the Nomba React SDK to embed checkout in your web app
Mobile (iOS / Android)
Native SDKs for iOS and Android integrations