curl --request POST \
  --url https://api.nomba.com/v1/checkout/checkout-card-detail \
  --header 'Content-Type: application/json' \
  --data '{
    "cardDetails": "{\"cardNumber\": \"5061000000000000\", \"cardExpiryMonth\": 9, \"cardExpiryYear\": 2031, \"cardCVV\": 123, \"cardPin\": 1234}",
    "key": "",
    "orderReference": "be727ded-aa6e-4b6e-beea-898d4428740a",
    "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": "card details submitted successfully",
  "status": true,
  "data": {
    "status": true,
    "message": "Kindly enter the OTP sent to **********9046",
    "responseCode": "T0",
    "transactionId": "0b572789-0770-44f8-b400-99164ef2712b",
    "secureAuthenticationData": null
  }
}

curl --request POST \
  --url https://api.nomba.com/v1/checkout/checkout-card-detail \
  --header 'Content-Type: application/json' \
  --data '{
    "cardDetails": "{\"cardNumber\": \"5061000000000000\", \"cardExpiryMonth\": 9, \"cardExpiryYear\": 2031, \"cardCVV\": 123, \"cardPin\": 1234}",
    "key": "",
    "orderReference": "be727ded-aa6e-4b6e-beea-898d4428740a",
    "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": "card details submitted successfully",
  "status": true,
  "data": {
    "status": true,
    "message": "Kindly enter the OTP sent to **********9046",
    "responseCode": "T0",
    "transactionId": "0b572789-0770-44f8-b400-99164ef2712b",
    "secureAuthenticationData": null
  }
}

Submit customer card details

Step 2 of 7. Collect the customer’s card details on your own page, then send them to Nomba with the orderReference from Create a checkout order. You need to be PCI DSS compliant to handle card details. The card is saved because you set tokenizeCard: true on the order. You don’t need to send saveCard. On its own, saveCard saves the card to the customer’s Nomba checkout, not to your account, so you can’t charge it.

`POST /v1/checkout/checkout-card-detail`

Headers

This call doesn’t need an Authorization or accountId header.

Request body

string

required

The card details as a JSON string, with cardNumber, cardExpiryMonth, cardExpiryYear, cardCVV and cardPin

string

required

The encryption key if you encrypt cardDetails, otherwise an empty string. See Initialize charge.

string

required

data.orderReference from the create-order response, which is Nomba’s ID for the order

object

required

Details of the customer’s browser or device

Response body

string

required

Response code

string

required

Response description

object

required

Hide object

boolean

required

true when the card details were accepted

string

required

Message to show the customer

string

required

T0 when the customer must enter the OTP their bank sent them

string

required

The transaction ID. Send it with the OTP in the next step.

object

3D Secure data, when the bank asks for a 3D Secure check instead of an OTP. See Initialize charge.

When data.responseCode is T0, ask the customer for the OTP and keep data.transactionId for the next step.

curl --request POST \
  --url https://api.nomba.com/v1/checkout/checkout-card-detail \
  --header 'Content-Type: application/json' \
  --data '{
    "cardDetails": "{\"cardNumber\": \"5061000000000000\", \"cardExpiryMonth\": 9, \"cardExpiryYear\": 2031, \"cardCVV\": 123, \"cardPin\": 1234}",
    "key": "",
    "orderReference": "be727ded-aa6e-4b6e-beea-898d4428740a",
    "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": "card details submitted successfully",
  "status": true,
  "data": {
    "status": true,
    "message": "Kindly enter the OTP sent to **********9046",
    "responseCode": "T0",
    "transactionId": "0b572789-0770-44f8-b400-99164ef2712b",
    "secureAuthenticationData": null
  }
}

Next: Submit card OTP

Send the OTP to complete the first payment.

Introduction

Getting Started

Products

API Basics

Guides

Submit card details

Submit customer card details

`POST /v1/checkout/checkout-card-detail`

Headers

Request body

Response body

Next: Submit card OTP

Submit customer card details

​POST /v1/checkout/checkout-card-detail

​Headers

​Request body

​Response body

Next: Submit card OTP

`POST /v1/checkout/checkout-card-detail`

Headers

Request body

Response body