Skip to main content
POST
/
v1
/
checkout
/
checkout-card-detail
Submit customer card details
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"
    }
  }
}

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.

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

OK - your request was successful.

​
code
string
required

Response Code

Example:

"00"

​
description
string
required

Response description

Example:

"Success"

​
data
object
required