curl --request POST \
  --url https://api.nomba.com/v1/checkout/tokenized-card-payment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
  "order": {
    "orderReference": "fd3002af-d48b-40a0-adba-0b1c93635bd2",
    "customerId": "762878332454",
    "callbackUrl": "https://ip:port/merchant.com/callback",
    "customerEmail": "[email protected]",
    "amount": "10000.00",
    "currency": "NGN"
  },
  "tokenKey": "7628788443"
}'
{
    "code": "00",
    "description": "Success",
    "data": {
        "status": true,
        "message": "Approved by Financial Insitution"
    }
}

Charge a tokenized card

Process payments with a unique tokens instead of exposing sensitive card details

​
POST /v1/checkout/tokenized-card-payment

Kindly be aware that the optional boolean value tokenizedCard should be included or set to true only if you intend to tokenize your customer’s card for the purpose of attempting other card payments at a later time.

​
Request body

​
order
object
required

Account reference

​
tokenkey
string

The token key returned in the webhook

​
Response body

​
code
string
required

Response code

​
description
string
required

Response description

​
data
object
curl --request POST \
  --url https://api.nomba.com/v1/checkout/tokenized-card-payment \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'accountId: <accountid>' \
  --data '{
  "order": {
    "orderReference": "fd3002af-d48b-40a0-adba-0b1c93635bd2",
    "customerId": "762878332454",
    "callbackUrl": "https://ip:port/merchant.com/callback",
    "customerEmail": "[email protected]",
    "amount": "10000.00",
    "currency": "NGN"
  },
  "tokenKey": "7628788443"
}'
{
    "code": "00",
    "description": "Success",
    "data": {
        "status": true,
        "message": "Approved by Financial Insitution"
    }
}