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"
    }
}