Tokenize Card Sandbox

POST

{{baseUrl}}/sandbox/api/requestPaymentTokenAndPay

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Example

{
    "merchantId":"71722326657622",
    "paymentTokenReferenceRequest":"Payer0008",
    "walletName": "Visa|Mastercard",
    "amount": "0.0",
    "paymentCurrency": "USD",
    "paymentDescription": "School Fees FullPayment",
    "payerName": "Keith Chimeto",
    "payerReference": "1a1401fe-21cd-4111-a980-c0ecf6675951",
    "payerAccountId": 9,
    "profileId": 4
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff '{{baseUrl}}/sandbox/api/requestPaymentTokenAndPay' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "merchantId":"71722326657622",
    "paymentTokenReferenceRequest":"Payer0008",
    "walletName": "Visa|Mastercard",
    "amount": "0.0",
    "paymentCurrency": "USD",
    "paymentDescription": "School Fees FullPayment",
    "payerName": "Keith Chimeto",
    "payerReference": "1a1401fe-21cd-4111-a980-c0ecf6675951",
    "payerAccountId": 9,
    "profileId": 4
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "checkOutStatus": "Success",
    "checkOutId": "FD5F75C50D264FF34D8BAB9797B3557C.uat01-vm-tx04",
    "checkOutRedirectUrl": "https://staging-payments.smatpay.africa?paymentCode=FD5F75C50D264FF34D8BAB9797B3557C.uat01-vm-tx04",
    "checkOutToken": ""
}

Modified at 2026-09-28 00:06:45

Tokenize Card

Card Token Payment Sandbox