Pay ZimSwitch Sandbox Bulk

POST

{{baseUrl}}/sandbox/init/authenticate/merchant/bulkWallet

Request

Header Params

Body Params application/json

Example

{
    "merchantId": "{{merchantId}}",
    "merchantApiKey": "{{merchantApiKey}}",
    "merchantKey": "{{merchantKey}}",
    "walletName": "ZimSwitch",
    "amount": "120.50",
    "paymentCurrency": "USD",
    "paymentDescription": "{{payerDescription}}",
    "payerName": "{{payerName}}",
    "payerReference": "{{payerReference}}",
    "payerAccountId": {{accountId}},
    "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}}
        }
    ],
    "additionalFees": 0.0,
    "customerNumber": "",
    "customerEmail": "",
    "customerSubscription": "",
    "setDirectSubscription":false
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --globoff '{{baseUrl}}/sandbox/init/authenticate/merchant/bulkWallet' \
--header 'Content-Type: application/json' \
--data '{
    "merchantId": "{{merchantId}}",
    "merchantApiKey": "{{merchantApiKey}}",
    "merchantKey": "{{merchantKey}}",
    "walletName": "ZimSwitch",
    "amount": "120.50",
    "paymentCurrency": "USD",
    "paymentDescription": "{{payerDescription}}",
    "payerName": "{{payerName}}",
    "payerReference": "{{payerReference}}",
    "payerAccountId": {{accountId}},
    "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}}
        }
    ],
    "additionalFees": 0.0,
    "customerNumber": "",
    "customerEmail": "",
    "customerSubscription": "",
    "setDirectSubscription":false
}'

Responses

🟢200

application/json

Bodyapplication/json

Example

{
    "auth": {
        "token": "{{json_web_token_0ray}}",
        "user": {
            "id": 31,
            "email": "dev@smatpay.africa",
            "role": "USER",
            "token": "{{json_web_token_0ray}}"
        },
        "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 2026-09-28 00:06:45

Pay Visa Production Bulk

Pay ZimSwitch Production