Authenticate
Obtain access token
API Documentation
Accounts
Virtual Accounts
Online Checkout
Charge
- GETGet Order details based on the generated Order reference
- POSTSubmit customer card details
- POSTSubmit customer card OTP
- POSTResend OTP to customer's phone
- POSTFetch checkout transaction details
- GETFetch checkout Flash account number for transfer payment
- POSTRequest OTP before saving a user's card
- POSTRequest OTP to validate a user before fetching saved cards
- POSTSubmit user OTP
- GETGet user saved cards
- POSTCancel Checkout transaction
Transfers
Terminals
Transactions
Airtime & Data Vending
Cable & Bill Payments
Authenticate
Obtain access token
You can use this endpoint to authenticate with Nomba.
POST
/
v1
/
auth
/
token
/
issue
curl --request POST \
--url https://api.nomba.com/v1/auth/token/issue \
--header 'Content-Type: application/json' \
--header 'accountId: <accountid>' \
--data '{
"grant_type": "client_credentials",
"client_id": "2242b79d-f2cf-4ccc-ada1-e890bd1a9f0d",
"client_secret": "JFJ8yq3G4+DvjivJMsji0YkZBkkKdSdjifR+TgT9RLM="
}'
{
"code": "00",
"description": "Success",
"data": {
"businessId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
"access_token": "eyJhbGciOiJIUzI1NiJ9.eyJHOjhmYWM4M2FjLTc2YjAtNDM1Zi1hYTM1LThkOTU3ZGQ5MjdkZCI6Ikc6OGZhYzgzYWMtNzZiMC00MzVmLWFhMzUtOGQ5NTdkZDkyN2RkIiwiUjpURUFNU19PV05FUiI6IlI6VEVBTVNfT1dORVIiLCJFbWFpbDp2aWN0b3JzaG9hZ2FAZ21haWwuY29tIjoiRW1haWw6dmljdG9yc2hvYWdhQGdtYWlsLmNvbSIsImlhdCI6MTY4MTkxODU3OSwic3ViIjoiNWUyNmNmYjAtNTI5Zi00MTdiLWI4ZDItYWJjNDcxZjRjOWRiIiwiZXhwIjoxNjgxOTIyMTc5fQ.lQOsyhR1gajKdzE9IHQEtxhQyUrArctEDZiP9pWVTFY",
"refresh_token": "01h4gdx2tctxfjgacbdwrcvs5d1688473602892",
"expiresAt": "2022-07-08T14:33:00Z"
}
}
Headers
The parent accountId of the business.
Example:
"890022ce-bae0-45c1-9b9d-ee7872e6ca27"
Body
application/json
The request payload required for authentication
A structure representing an authentication request.
Response
200
application/json
Your authentication request was successful.
The response is of type object
.
curl --request POST \
--url https://api.nomba.com/v1/auth/token/issue \
--header 'Content-Type: application/json' \
--header 'accountId: <accountid>' \
--data '{
"grant_type": "client_credentials",
"client_id": "2242b79d-f2cf-4ccc-ada1-e890bd1a9f0d",
"client_secret": "JFJ8yq3G4+DvjivJMsji0YkZBkkKdSdjifR+TgT9RLM="
}'
{
"code": "00",
"description": "Success",
"data": {
"businessId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
"access_token": "eyJhbGciOiJIUzI1NiJ9.eyJHOjhmYWM4M2FjLTc2YjAtNDM1Zi1hYTM1LThkOTU3ZGQ5MjdkZCI6Ikc6OGZhYzgzYWMtNzZiMC00MzVmLWFhMzUtOGQ5NTdkZDkyN2RkIiwiUjpURUFNU19PV05FUiI6IlI6VEVBTVNfT1dORVIiLCJFbWFpbDp2aWN0b3JzaG9hZ2FAZ21haWwuY29tIjoiRW1haWw6dmljdG9yc2hvYWdhQGdtYWlsLmNvbSIsImlhdCI6MTY4MTkxODU3OSwic3ViIjoiNWUyNmNmYjAtNTI5Zi00MTdiLWI4ZDItYWJjNDcxZjRjOWRiIiwiZXhwIjoxNjgxOTIyMTc5fQ.lQOsyhR1gajKdzE9IHQEtxhQyUrArctEDZiP9pWVTFY",
"refresh_token": "01h4gdx2tctxfjgacbdwrcvs5d1688473602892",
"expiresAt": "2022-07-08T14:33:00Z"
}
}