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

​
Authorization
string
header
required

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.
​
cardDetails
string

Stringified card details

Example:

"{\"cardCVV\": 11,\"cardExpiryMonth\": 3,\"cardExpiryYear\": 2050,\"cardNumber\": \"5190752909999995\",\"cardPin\": 1111}"

​
key
string

encryption key is data encrption is in use, else empty string

Example:

""

​
orderReference
string

the order reference returned when the order was created

Example:

"c4307d58-2513-41d8-b7f7-dfecd5f9fdbe"

​
saveCard
boolean

if true, this this user cardn will be saved for the user's future use. Note the process is not complete until the user-card verification endpoints are called to authenticate the user's phone number.

Example:

"true"

​
deviceInformation
object

Contains browser information for the device making the api calls

Response

200
application/json
OK - your request was successful.
​
code
string
required

Response Code

Example:

"00"

​
description
string
required

Response description

Example:

"Success"

​
data
object
required
Get Order details based on the generated Order referenceSubmit customer card OTP