curl --request POST \
  --url https://api.nomba.com/v1/checkout/checkout-card-otp \
  --header 'Content-Type: application/json' \
  --data '{
    "otp": "123456",
    "orderReference": "90e81e8a-bc14-4ebf-89c0-57da752cca58",
    "transactionId": "a729d716-566f-4a47-986f-32b3fa39e075"
  }'

{
    "code": "00",
    "description": "checkout otp processed successfully",
    "data": {
        "status": true,
        "message": "SUCCESS"
    }
}

curl --request POST \
  --url https://api.nomba.com/v1/checkout/checkout-card-otp \
  --header 'Content-Type: application/json' \
  --data '{
    "otp": "123456",
    "orderReference": "90e81e8a-bc14-4ebf-89c0-57da752cca58",
    "transactionId": "a729d716-566f-4a47-986f-32b3fa39e075"
  }'

{
    "code": "00",
    "description": "checkout otp processed successfully",
    "data": {
        "status": true,
        "message": "SUCCESS"
    }
}

Submit customer card OTP

When Charge a Tokenized Card returns otpRequired: true, collect the OTP the customer’s bank sent them and submit it here with the orderReference and transactionId from the charge.

A charge whose OTP is not submitted within about 15 minutes is marked as failed. After submitting the OTP, confirm the final status via Verify Transactions before giving value to your customer.

`POST /v1/checkout/checkout-card-otp`

Request body

string

required

The OTP the customer received from their bank

string

required

The orderReference of the charge

string

required

The transactionId returned by the charge

Response body

string

required

Response code

string

required

Response description

object

required

Hide object

boolean

required

true when the charge was completed

string

required

Details of the response

curl --request POST \
  --url https://api.nomba.com/v1/checkout/checkout-card-otp \
  --header 'Content-Type: application/json' \
  --data '{
    "otp": "123456",
    "orderReference": "90e81e8a-bc14-4ebf-89c0-57da752cca58",
    "transactionId": "a729d716-566f-4a47-986f-32b3fa39e075"
  }'

{
    "code": "00",
    "description": "checkout otp processed successfully",
    "data": {
        "status": true,
        "message": "SUCCESS"
    }
}

Introduction

Getting Started

Products

API Basics

Guides

Submit Tokenized Card OTP

Submit customer card OTP

`POST /v1/checkout/checkout-card-otp`

Request body

Response body

Submit customer card OTP

​POST /v1/checkout/checkout-card-otp

​Request body

​Response body

`POST /v1/checkout/checkout-card-otp`

Request body

Response body