Skip to main content
Nomba Checkout is a hosted payment page that lets your customers pay you via card, bank transfer, USSD, QR code, Buy Now Pay Later, or Apple Pay — without you building a payment UI. You create an order via API, display the checkout link to your customer, and Nomba handles the rest.

​
How it works

1

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.
Always use sandbox credentials with https://sandbox.nomba.com and production credentials with https://api.nomba.com. Mixing credentials across environments will result in authentication errors.
2

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.
3

Create a checkout order

Call POST /v1/checkout/order with the amount, currency, and optional customer details. Nomba returns a checkoutLink and an orderReference.
4

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.
5

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.
6

Verify and deliver

Verify the transaction using /v1/transactions/accounts/single before delivering goods or services. Never rely solely on the webhook without server-side verification.

​
Supported payment methods

MethodDescription
CardMastercard, Visa, and Verve debit/credit cards
Bank TransferCustomer transfers directly to a dynamically generated account number
USSDPayment via USSD shortcode on mobile
Nomba QRQR code scan-to-pay
Buy Now Pay LaterDeferred payment option
Apple PayOn supported Apple devices
You can restrict which methods appear on the checkout page using the allowedPaymentMethods field when creating an order.

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