Skip to main content

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.

No sign-up needed. Call the sandbox endpoints below directly — skip the Authorization header and accountId entirely. This is the fastest way to see Nomba APIs in action.
All examples on this page point to https://sandbox.nomba.com. No real money moves — it’s a fully isolated test environment.

​
Option 1 — Try it directly in the API Reference

The quickest way to test with zero setup. No terminal, no code.
1

Go to the API Reference

Navigate to the API Reference section in the sidebar, then pick any endpoint — for example Transfer, Create Virtual Account, or Create Checkout Order.
2

Click 'Try it'

On the endpoint page, click the Try it button to open the interactive request panel.
3

Select Sandbox from the base URL dropdown

At the top of the request panel, open the base URL dropdown and select Sandbox (https://sandbox.nomba.com).
4

Leave the auth fields blank

You will see fields for Bearer Token and accountId — leave both completely empty. You do not need credentials to test.
5

Fill in the request body and send

Enter your request body fields and click Send. The live response will appear directly on the page.
The API Reference playground sends requests directly to https://sandbox.nomba.com. Leaving the auth fields empty is intentional — it is how the no-account test mode works.

​
Option 2 — Run it from your terminal

​
Transfer to a bank account

Send money to any Nigerian bank account. 
curl --request POST \
  --url https://sandbox.nomba.com/v2/transfers/bank \
  --header 'Content-Type: application/json' \
  --data '{
    "amount": 3500,
    "accountNumber": "055472814",
    "accountName": "M.A Animashaun",
    "bankCode": "058",
    "merchantTxRef": "UNQ_test_001",
    "senderName": "Test Sender",
    "narration": "Test transfer"
  }'
Response
{
  "code": "00",
  "description": "Success",
  "data": {
    "id": "txn_abc123",
    "status": "SUCCESS",
    "amount": 3500,
    "accountNumber": "055472814",
    "bankCode": "058",
    "merchantTxRef": "UNQ_test_001"
  }
}

​
Create a virtual account

Generate a unique account number to receive payments. 
curl --request POST \
  --url https://sandbox.nomba.com/v1/accounts/virtual \
  --header 'Content-Type: application/json' \
  --data '{
    "accountRef": "ref_test_001",
    "accountName": "John Doe",
    "currency": "NGN"
  }'
Response
{
  "code": "00",
  "description": "Success",
  "data": {
    "accountNumber": "9900012345",
    "accountName": "John Doe",
    "bankName": "Nomba",
    "bankCode": "000026",
    "accountRef": "ref_test_001",
    "currency": "NGN"
  }
}

​
Create a checkout order

Generate a payment link your customers can use to pay. 
curl --request POST \
  --url https://sandbox.nomba.com/v1/checkout/order \
  --header 'Content-Type: application/json' \
  --data '{
    "order": {
      "orderReference": "order_test_001",
      "amount": "10000.00",
      "currency": "NGN",
      "customerEmail": "[email protected]",
      "callbackUrl": "https://merchant.com/callback"
    }
  }'
Response
{
  "code": "00",
  "description": "Success",
  "data": {
    "checkoutLink": "https://checkout.nomba.com/sandbox/<encrypted-ref>",
    "orderReference": "order_test_001"
  }
}
Open the checkoutLink in your browser to see the full payment UI. Use the test cards to simulate different payment outcomes.

​
Ready to go further?

Once you’ve explored the sandbox, create a free Nomba account to get your own credentials and go live.

Create an account

Get your API keys and start building in minutes.

Full sandbox guide

Test cards, webhooks, and error simulation for Checkout.

Authentication

Learn how bearer tokens and accountId work.

API Reference

Browse all available endpoints.