Charge
Submit customer card details
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
Charge
Submit customer card details
Use this endpoint to submit the customers card details
POST
/
v1
/
checkout
/
checkout-card-detail
curl --request POST \
--url https://api.nomba.com/v1/checkout/checkout-card-detail \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"cardDetails": {
"cardCVV": 11,
"cardExpiryMonth": 3,
"cardExpiryYear": 2050,
"cardNumber": "5190752909999995",
"cardPin": 1111
},
"key": "",
"orderReference": "c4307d58-2513-41d8-b7f7-dfecd5f9fdbe",
"saveCard": "true",
"deviceInformation": {
"httpBrowserLanguage": "en-GB",
"httpBrowserJavaEnabled": "true",
"httpBrowserJavaScriptEnabled": "true",
"httpBrowserColorDepth": "30",
"httpBrowserScreenHeight": "900",
"httpBrowserScreenWidth": "1500",
"httpBrowserTimeDifference": "-60",
"userAgentBrowserValue": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
"deviceChannel": "Browser"
}
}'
{
"code": "00",
"description": "Success",
"data": {
"status": "true",
"message": "Success",
"responseCode": "00",
"transactionId": "c4307d58-2513-41d8-b7f7-dfecd5f9fdbe",
"secureAuthenticationData": {
"jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
"md": "6775843012",
"acsUrl": "https://ip:port/merchant.com/callback",
"termUrl": "https://ip:port/merchant.com/callback"
}
}
}
Authorizations
Nomba authenticates API calls with OAuth2 HTTP bearer tokens. There are two methods of authentication; Client-Credentials method and PKCE (Proof Key for Code Exchange) method. In each of the methods, You will get an ACCESS_TOKEN
. You need to use an "Authorization"
HTTP header to provide your ACCESS_TOKEN
. For example: Authorization: {ACCESS_TOKEN}
.
Body
application/json
The request payload required to filter account transactions.
The body is of type object
.
Response
200
application/json
OK - your request was successful.
The response is of type object
.
curl --request POST \
--url https://api.nomba.com/v1/checkout/checkout-card-detail \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"cardDetails": {
"cardCVV": 11,
"cardExpiryMonth": 3,
"cardExpiryYear": 2050,
"cardNumber": "5190752909999995",
"cardPin": 1111
},
"key": "",
"orderReference": "c4307d58-2513-41d8-b7f7-dfecd5f9fdbe",
"saveCard": "true",
"deviceInformation": {
"httpBrowserLanguage": "en-GB",
"httpBrowserJavaEnabled": "true",
"httpBrowserJavaScriptEnabled": "true",
"httpBrowserColorDepth": "30",
"httpBrowserScreenHeight": "900",
"httpBrowserScreenWidth": "1500",
"httpBrowserTimeDifference": "-60",
"userAgentBrowserValue": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)",
"deviceChannel": "Browser"
}
}'
{
"code": "00",
"description": "Success",
"data": {
"status": "true",
"message": "Success",
"responseCode": "00",
"transactionId": "c4307d58-2513-41d8-b7f7-dfecd5f9fdbe",
"secureAuthenticationData": {
"jwt": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
"md": "6775843012",
"acsUrl": "https://ip:port/merchant.com/callback",
"termUrl": "https://ip:port/merchant.com/callback"
}
}
}