NOnomba
Online Checkout

Charge a customer using tokenized card data

Changed on

You can use this endpoint to charge a customer's card using the tokenized card details.

post/v1/checkout/tokenized-card-payment

Request

  • Base URL
    https://api.nomba.com
  • URL
    https://api.nomba.com/v1/checkout/tokenized-card-payment
  • Auth
    HTTP bearer

Headers

accountIdstring uuid required
Example:890022ce-bae0-45c1-9b9d-ee7872e6ca27

The parent accountId of the business.

Request body

tokenKeystring required

the token key returned in the webhook

Example request

{
  "order": {
    "orderReference": "90e81e8a-bc14-4ebf-89c0-57da752cca58",
    "customerId": "762878332454",
    "callbackUrl": "https://ip:port/merchant.com/callback",
    "customerEmail": "abcde@gmail.com",
    "currency": "NGN",
    "accountId": "01a10aeb-d989-460a-bbde-9842f2b4320f",
    "allowedPaymentMethods": [
      "Card",
      "Transfer"
    ],
    "splitRequest": {
      "splitList": [
        {
          "accountId": "01a10aeb-d989-460a-bbde-9842f2b4320f"
        }
      ]
    },
    "orderMetaData": {
      "productName": "Premium Plan",
      "internalRef": "INV-2026-001",
      "region": "CD"
    }
  },
  "tokenKey": "7628788443"
}

Response

OK - your request was successful.

codestring required

Response Code

descriptionstring required

Response description. It says the transaction completed even when the charge was declined or needs an OTP, so read data.status and data.otpRequired instead.

Example response

{
  "code": "00",
  "description": "tokenized transaction completed successfully",
  "data": {
    "message": "Please enter the OTP sent to the phone/email address registered with your bank.",
    "orderId": "b6a3c0f2-6d2e-4c1a-9a41-3f2b7d0c9e15",
    "orderReference": "90e81e8a-bc14-4ebf-89c0-57da752cca58",
    "otpRequired": true,
    "transactionId": "a729d716-566f-4a47-986f-32b3fa39e075"
  }
}

Changes

  • 278a25dccfe5Revision changes
    • breaking

      removed the enum value Buy Now Pay Later of the request property //

    • info

      added the new Intl Transfer enum value to the request property //

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status