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 Ecocash Production Bulk

      POST
      /init/authenticate/merchant/bulkWallet

      Request

      Header Params

      Body Params application/json

      Example
      {
    "merchantId": "{{merchantId}}",
    "merchantApiKey": "{{merchantApiKey}}",
    "merchantKey": "{{merchantKey}}",
    "walletName": "Ecocash",
    "amount": "{{amount}}",
    "paymentCurrency": "USD",
    "paymentDescription": "{{payerDescription}}",
    "payerName": "{{payerName}}",
    "payerReference": "{{payerReference}}",
    "payerAccountId": {{accountId}},
    "payerMobile": "{{263000000000}}",
    "profileId": {{profileId}},
    "dynamicPaidList": [
        {
            "dynamicMerchantId": "{{Approved Merchant ID}}",
            "dynamicPayoutPercentage": {{Percentage 1-100 i.e 50}}
        },
        {
            "dynamicMerchantId": "{{Approved Merchant ID}}",
            "dynamicPayoutPercentage": {{Percentage 1-100 i.e 50}}
        }
    ]
}

      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/init/authenticate/merchant/bulkWallet' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantId": "{{merchantId}}",
    "merchantApiKey": "{{merchantApiKey}}",
    "merchantKey": "{{merchantKey}}",
    "walletName": "Ecocash",
    "amount": "{{amount}}",
    "paymentCurrency": "USD",
    "paymentDescription": "{{payerDescription}}",
    "payerName": "{{payerName}}",
    "payerReference": "{{payerReference}}",
    "payerAccountId": {{accountId}},
    "payerMobile": "{{263000000000}}",
    "profileId": {{profileId}},
    "dynamicPaidList": [
        {
            "dynamicMerchantId": "{{Approved Merchant ID}}",
            "dynamicPayoutPercentage": {{Percentage 1-100 i.e 50}}
        },
        {
            "dynamicMerchantId": "{{Approved Merchant ID}}",
            "dynamicPayoutPercentage": {{Percentage 1-100 i.e 50}}
        }
    ]
}'

      Responses

      🟢200InititatePaymentEcocash
      text/plain
      Body

      Example
      {
    "auth": {
        "token": "eyJhbGciOiJIUzUxMiJ9.eyJVc2VySWQiOjcsInJvbGVzIjpbIlVTRVIiXSwic3ViIjoidWRlYW5tYmFub0BnbWFpbC5jb20iLCJpYXQiOjE3MjAwOTQyOTYsImV4cCI6MTcyMDExMjI5Nn0.e7fZx1AfsMHzBa7cupP_ssbXV6-2Dx3JSLdeft0n8JtroYAFCzCbsLAx2mymK8-iBswCmKMX123HV8XBVatG7w",
        "user": {
            "id": 7,
            "email": "udeanmbano@gmail.com",
            "role": "USER",
            "token": "eyJhbGciOiJIUzUxMiJ9.eyJVc2VySWQiOjcsInJvbGVzIjpbIlVTRVIiXSwic3ViIjoidWRlYW5tYmFub0BnbWFpbC5jb20iLCJpYXQiOjE3MjAwOTQyOTYsImV4cCI6MTcyMDExMjI5Nn0.e7fZx1AfsMHzBa7cupP_ssbXV6-2Dx3JSLdeft0n8JtroYAFCzCbsLAx2mymK8-iBswCmKMX123HV8XBVatG7w"
        },
        "errorResponse": {
            "errorMessage": null,
            "statusCode": 0
        }
    },
    "paymentInitiationResponse": {
        "status": "Processing",
        "paymentTokenExpiry": "",
        "paymentTokenDescription": "The payment is being processed enter pin on next prompt!",
        "paymentToken": "",
        "paymentId": "981af738-f459-4629-a72e-8388e0acdb5e",
        "paymentRedirectUrl": ""
    }
}
      Modified at 2025-03-10 20:49:15
      Previous
      Pay Ecocash Production
      Next
      Payment Status Innbucks Sandbox
      Built with