- Payments
- 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 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 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 SandboxGET
- Payment Status Visa ProductionGET
- Payment Status Mastercard ProductionGET
- Generate Payment Token SandboxPOST
- Generate Recurring Payment SandboxPOST
- Generate Payment Token ProductionPOST
- Generate Payment Token With Payment SandboxPOST
- Card Token Payment SandboxPOST
- Cancel Recurring Payment SandboxPOST
- Card Token Payment ProductionPOST
- Delete Card Token SandboxDELETE
- Fast CheckoutPOST
- Fast Checkout SandboxPOST
- Fiscalization
Generate Payment Token Sandbox
POST
/sandbox/api/requestPaymentToken
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": "311722504951049",
"paymentTokenReferenceRequest": "TokenForMbano001",
"transactionsTokenCustomerName": "Udean",
"transactionsTokenCustomerSurname": "Mbano",
"transactionsTokenCustomerNumber": "631374774744",
"paymentTokenMethodName": "Visa",
"paymentTokenExpiryDate": "012028",
"paymentTokenCardNumber": "4456530000001005"
}Request Code 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/requestPaymentToken' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"merchantId": "311722504951049",
"paymentTokenReferenceRequest": "TokenForMbano001",
"transactionsTokenCustomerName": "Udean",
"transactionsTokenCustomerSurname": "Mbano",
"transactionsTokenCustomerNumber": "631374774744",
"paymentTokenMethodName": "Visa",
"paymentTokenExpiryDate": "012028",
"paymentTokenCardNumber": "4456530000001005"
}'Responses
🟢200Generate Payment Token Sandbox
text/plain
Body
Example
{
"checkOutStatus": "Success",
"checkOutId": "1",
"checkOutReference": "TokenForMbano001",
"checkOutToken": "18665470510"
}Modified at 2025-10-01 10:30:32