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