Generate Payment Token With Payment Sandbox

POST

/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": "ZimSwitch",
    "amount": "120.50",
    "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 --request POST 'https://live.smatpay.africa/sandbox/api/requestPaymentTokenAndPay' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantId":"71722326657622",
    "paymentTokenReferenceRequest":"Payer0008",
    "walletName": "ZimSwitch",
    "amount": "120.50",
    "paymentCurrency": "USD",
    "paymentDescription": "School Fees FullPayment",
    "payerName": "Keith Chimeto",
    "payerReference": "1a1401fe-21cd-4111-a980-c0ecf6675951",
    "payerAccountId": 9,
    "profileId": 4
}'

Responses

🟢200GeneratePaymentToken

text/plain

Body

Example

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

Modified at 2025-03-10 20:49:15

Generate Payment Token Sandbox

Cancel Recurring Payment Sandbox