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

orderReference
string

Reference of the online checkout order to be created

customerId
string

ID of the customer that would be paying for the checkout order

callbackUrl
string
required

Merchant callback url for redirect after payment

customerEmail
string
required

Customer email

amount
number
required

The amount to be paid by the customer

currency
string
required

The currency of the money to be paid by the customer

tokenkey
string

The token key returned in the webhook

​
Response body

code
string
required

Response code

description
string
required

Response description

data
object
status
boolean
required

Status of the transaction.

message
string
required

Some details of the transaction response.

Create a checkout orderDispute Management