- Introduction to the SmatPay API
- Integration Guide - Quick Start
- Integration Guide - Payments
- SmatPay WooCommerce
- .NET SDK
- Get Token SandboxPOST
- Get Token ProductionPOST
- Get CurrenciesGET
- Get BanksGET
- Get Payment intervalsGET
- Payment CalculatorPOST
- Test Webhook SandboxPOST
- Test Webhook ProductionPOST
- Pay Innbucks SandboxPOST
- Pay Innbucks Sandbox BulkPOST
- Pay Innbucks ProductionPOST
- Pay Innbucks Production BulkPOST
- Pay ZimSwitch SandboxPOST
- Pay Visa SandboxPOST
- Pay Visa ProductionPOST
- Pay Mastercard SandboxPOST
- Pay Mastercard ProductionPOST
- Pay Mastercard Sandbox BulkPOST
- Pay Mastercard Production BulkPOST
- Pay Visa Sandbox BulkPOST
- Pay Visa Production BulkPOST
- Pay ZimSwitch Sandbox BulkPOST
- Pay ZimSwitch ProductionPOST
- Pay ZimSwitch Production BulkPOST
- Pay Ecocash SandboxPOST
- Pay Ecocash Sandbox BulkPOST
- Bulk Payouts SandboxPOST
- Bulk Payouts ProductionPOST
- Pay Ecocash ProductionPOST
- Pay Ecocash Production BulkPOST
- Payment Status Innbucks SandboxGET
- Payment Status Innbucks ProductionGET
- Payment Status Ecocash SandboxGET
- Payment Status Ecocash ProductionGET
- Payment Status ZimSwitch SandboxGET
- Payment Status ZimSwitch ProductionGET
- Payment Status Visa SandboxGET
- Payment Status MasterCard Sandbox CopyGET
- Payment Status Visa ProductionGET
- Payment Status Mastercard ProductionGET
- Generate Recurring Payment SandboxPOST
- Generate Payment Token SandboxPOST
- Generate Payment Token With Payment SandboxPOST
- Cancel Recurring Payment SandboxPOST
- Fast CheckoutPOST
- Fast Checkout SandboxPOST
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
merchantId
string
required
paymentTokenReferenceRequest
string
required
walletName
string
required
amount
string
required
paymentCurrency
string
required
paymentDescription
string
required
payerName
string
required
payerReference
string
required
payerAccountId
integer
required
profileId
integer
required
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 samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://live.smatpay.africa/sandbox/api/requestPaymentTokenAndPay' \
--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
checkOutStatus
string
required
checkOutId
string
required
checkOutRedirectUrl
string
required
checkOutToken
string
required
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