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.

Verify by Order Reference

Look up a transaction using your order reference or the Nomba transaction ID.

Fetch Checkout Transaction (Production)

Retrieve full checkout order details including card and transfer info.

​
Which endpoint should I use?

There are two ways to verify a checkout transaction. Choose based on your environment and what you need:
EndpointMethodEnvironmentUse when
/v1/transactions/accounts/singleGETSandbox + ProductionYou want to confirm status: SUCCESS before delivering value. Works with both orderReference and transactionRef as query params.
/v1/checkout/transactionGETProduction onlyYou need full checkout order details (card info, transfer details, order metadata).
Always verify transactions before providing goods or services to your customer — even if you received a webhook.

​
Option 1: Verify via /v1/transactions/accounts/single

This endpoint works in both sandbox and production. Pass the orderReference (the reference on the order) or the transactionRef (the Nomba transaction ID from the webhook) as a query parameter. The key field to check in the response is data.status. A successful payment returns "status": "SUCCESS". 
  curl --request GET \
    --url 'https://api.nomba.com/v1/transactions/accounts/single?orderReference=90e81e8a-bc14-4ebf-89c0-57da801cca68' \
    --header 'Authorization: Bearer <token>' \
    --header 'accountId: <accountid>'
For sandbox transactions, use the sandbox base URL: https://sandbox.nomba.com/v1/transactions/accounts/single. See Sandbox Testing for details on looking up sandbox transactions.

​
Option 2: Get Checkout Transaction (Production only)

This endpoint returns full checkout order details including card information, transfer details, and order metadata. It is useful when you need richer data than the basic transaction lookup provides — for example, to display order details on a receipt page.
This endpoint is only available in the production environment. For sandbox verification, use POST /v1/transactions/accounts with the transaction reference — see Sandbox Testing.
To fetch a checkout transaction, send a GET request to this endpoint /v1/checkout/transaction. 
  curl --request GET \
    --url 'https://api.nomba.com/v1/checkout/transaction?idType=ORDER_REFERENCE&id=68da39e0-2ce4-4ea6-9def-5*********' \
    --header 'Authorization: Bearer <token>' \
    --header 'accountId: <accountid>'