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": "<string>",
  "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
headerrequired

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

Stringified card details

key
string

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

orderReference
string

the order reference returned when the order was created

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.

deviceInformation
object

Contains browser information for the device making the api calls

Response

200 - application/json
code
string
required

Response Code

description
string
required

Response description

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