SmatPay Merchant Public Api
SmatPay Merchant Public Api
  • Introduction to the SmatPay API
  • Integration Guide - Quick Start
  • Integration Guide - Payments
  • SmatPay WooCommerce
  • .NET SDK
  • Get Token Sandbox
    POST
  • Get Token Production
    POST
  • Get Currencies
    GET
  • Get Banks
    GET
  • Get Payment intervals
    GET
  • Payment Calculator
    POST
  • Test Webhook Sandbox
    POST
  • Test Webhook Production
    POST
  • Pay Innbucks Sandbox
    POST
  • Pay Innbucks Sandbox Bulk
    POST
  • Pay Innbucks Production
    POST
  • Pay Innbucks Production Bulk
    POST
  • Pay ZimSwitch Sandbox
    POST
  • Pay Visa Sandbox
    POST
  • Pay Visa Production
    POST
  • Pay Mastercard Sandbox
    POST
  • Pay Mastercard Production
    POST
  • Pay Mastercard Sandbox Bulk
    POST
  • Pay Mastercard Production Bulk
    POST
  • Pay Visa Sandbox Bulk
    POST
  • Pay Visa Production Bulk
    POST
  • Pay ZimSwitch Sandbox Bulk
    POST
  • Pay ZimSwitch Production
    POST
  • Pay ZimSwitch Production Bulk
    POST
  • Pay Ecocash Sandbox
    POST
  • Pay Ecocash Sandbox Bulk
    POST
  • Bulk Payouts Sandbox
    POST
  • Bulk Payouts Production
    POST
  • Pay Ecocash Production
    POST
  • Pay Ecocash Production Bulk
    POST
  • Payment Status Innbucks Sandbox
    GET
  • Payment Status Innbucks Production
    GET
  • Payment Status Ecocash Sandbox
    GET
  • Payment Status Ecocash Production
    GET
  • Payment Status ZimSwitch Sandbox
    GET
  • Payment Status ZimSwitch Production
    GET
  • Payment Status Visa Sandbox
    GET
  • Payment Status MasterCard Sandbox Copy
    GET
  • Payment Status Visa Production
    GET
  • Payment Status Mastercard Production
    GET
  • Generate Recurring Payment Sandbox
    POST
  • Generate Payment Token Sandbox
    POST
  • Generate Payment Token With Payment Sandbox
    POST
  • Cancel Recurring Payment Sandbox
    POST
  • Fast Checkout
    POST
  • Fast Checkout Sandbox
    POST

Pay Mastercard Sandbox

POST
/sandbox/init/authenticate/merchant/wallet

Request

Header Params
Content-Type
string 
required
Example:
application/json
Body Params application/json
object {0}
Example
{
     "merchantId":"{{merchantId}}",
    "merchantApiKey":"{{merchantApiKey}}",
    "merchantKey":"{{merchantKey}}",
    "walletName": "Mastercard",
    "amount": "{{amount}}",
    "paymentCurrency": "USD",
    "paymentDescription": "{{payerDescription}}",
    "payerName": "{{payerName}}",
    "payerReference": "{{payerReference}}",
    "payerAccountId": {{accountId}},
    "profileId": {{profileId}}
}

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/init/authenticate/merchant/wallet' \
--header 'Content-Type: application/json' \
--data-raw '{
     "merchantId":"{{merchantId}}",
    "merchantApiKey":"{{merchantApiKey}}",
    "merchantKey":"{{merchantKey}}",
    "walletName": "Mastercard",
    "amount": "{{amount}}",
    "paymentCurrency": "USD",
    "paymentDescription": "{{payerDescription}}",
    "payerName": "{{payerName}}",
    "payerReference": "{{payerReference}}",
    "payerAccountId": {{accountId}},
    "profileId": {{profileId}}
}'

Responses

🟢200InititatePaymentVisa
text/plain
Body
auth
object 
required
token
string 
required
user
object 
required
errorResponse
object 
required
paymentInitiationResponse
object 
required
status
string 
required
paymentTokenExpiry
null 
required
paymentTokenDescription
string 
required
paymentToken
null 
required
paymentId
string 
required
paymentRedirectUrl
string 
required
paymentResponseMessage
null 
required
paymentProcessedDateTime
null 
required
paymentCode
null 
required
paymentQrCode
null 
required
Example
{
  "auth": {
    "token": "eyJhbGciOiJIUzUxMiJ9.eyJVc2VySWQiOjMxLCJyb2xlcyI6WyJVU0VSIl0sInN1YiI6ImRldkBzbWF0cGF5LmFmcmljYSIsImlhdCI6MTcyODkzMzA2MCwiZXhwIjoxNzI4OTUxMDYwfQ.fvtGWvDANe0QQFKiToVYgyiycW5Y1ofPI6xfFHkdARo9iB6jndM3nn9ACiPrM4JIGWuGJJxyMMehL82traf5NQ",
    "user": {
      "id": 31,
      "email": "dev@smatpay.africa",
      "role": "USER",
      "token": "eyJhbGciOiJIUzUxMiJ9.eyJVc2VySWQiOjMxLCJyb2xlcyI6WyJVU0VSIl0sInN1YiI6ImRldkBzbWF0cGF5LmFmcmljYSIsImlhdCI6MTcyODkzMzA2MCwiZXhwIjoxNzI4OTUxMDYwfQ.fvtGWvDANe0QQFKiToVYgyiycW5Y1ofPI6xfFHkdARo9iB6jndM3nn9ACiPrM4JIGWuGJJxyMMehL82traf5NQ"
    },
    "errorResponse": {
      "errorMessage": null,
      "statusCode": 0
    }
  },
  "paymentInitiationResponse": {
    "status": "Success",
    "paymentTokenExpiry": null,
    "paymentTokenDescription": "successfully created checkout",
    "paymentToken": null,
    "paymentId": "BFE1B4470D1981A5F29FC4DC292C2757.uat01-vm-tx03",
    "paymentRedirectUrl": "https://dev-payments.smatpay.africa?paymentCode=BFE1B4470D1981A5F29FC4DC292C2757.uat01-vm-tx03",
    "paymentResponseMessage": null,
    "paymentProcessedDateTime": null,
    "paymentCode": null,
    "paymentQrCode": null
  }
}
Modified at 2025-03-10 20:49:15
Previous
Pay Visa Production
Next
Pay Mastercard Production
Built with