1. Payments
SmatPay Merchant Public Api
  • Payments
    • 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 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
      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
      GET
    • Payment Status Visa Production
      GET
    • Payment Status Mastercard Production
      GET
    • Generate Recurring Payment Sandbox
      POST
    • Tokenize Card
      POST
    • Tokenize Card Sandbox
      POST
    • Card Token Payment Sandbox
      POST
    • Cancel Recurring Payment Sandbox
      POST
    • Card Token Payment Production
      POST
    • Delete Card Token Sandbox
      DELETE
    • Fast Checkout
      POST
    • Fast Checkout Sandbox
      POST
    • Production - Tokens by Customer Number
      GET
    • Sandbox - Tokens by Customer Number
      GET
    • 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 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
      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
      GET
    • Payment Status Visa Production
      GET
    • Payment Status Mastercard Production
      GET
    • Generate Recurring Payment Sandbox
      POST
    • Tokenize Card
      POST
    • Tokenize Card Sandbox
      POST
    • Card Token Payment Sandbox
      POST
    • Cancel Recurring Payment Sandbox
      POST
    • Card Token Payment Production
      POST
    • Delete Card Token Sandbox
      DELETE
    • Fast Checkout
      POST
    • Fast Checkout Sandbox
      POST
  • Fiscalization
    • add-invoice
    • add-debit-note
    • add-credit-note
    • money-type-list
  1. Payments

Pay Innbucks Sandbox Bulk

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

Request

Header Params

Body Params application/json

Example
{
    "merchantId": "{{merchantId}}",
    "merchantApiKey": "{{merchantApiKey}}",
    "merchantKey": "{{merchantKey}}",
    "paymentDescription": "{{payerDescription}}",
    "amount": "1.00",
    "paymentCurrency": "USD",
    "payerName": "{{payerName}}",
    "payerReference": "{{payerReference}}",
    "payerAccountId": {{accountId}},
    "walletName": "Innbucks",
    "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
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff '{{baseUrl}}/init/authenticate/merchant/bulkWallet' \
--header 'Content-Type: application/json' \
--data '{
    "merchantId": "{{merchantId}}",
    "merchantApiKey": "{{merchantApiKey}}",
    "merchantKey": "{{merchantKey}}",
    "paymentDescription": "{{payerDescription}}",
    "amount": "1.00",
    "paymentCurrency": "USD",
    "payerName": "{{payerName}}",
    "payerReference": "{{payerReference}}",
    "payerAccountId": {{accountId}},
    "walletName": "Innbucks",
    "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_04pf}}",
        "user": {
            "id": 31,
            "email": "dev@smatpay.africa",
            "role": "USER",
            "token": "{{json_web_token_04pf}}"
        },
        "errorResponse": {
            "errorMessage": null,
            "statusCode": 0
        }
    },
    "paymentInitiationResponse": {
        "status": "00",
        "paymentTokenExpiry": "2024-10-14T21:17:12.000+02:00",
        "paymentTokenDescription": "Request successful",
        "paymentToken": "{{json_web_token_0chd}}",
        "paymentId": null,
        "paymentRedirectUrl": null,
        "paymentResponseMessage": "Approved or completed successfully",
        "paymentProcessedDateTime": "2024-10-14 23:02:13.682",
        "paymentCode": "701540999",
        "paymentQrCode": "iVBORw0KGgoAAAANSUhEUgAAASwAAAEsAQAAAABRBrPYAAABMElEQVR4Xu3XO47DMAwEUKbyMXTU6Kg6QkpV4YpDOXaIANkF1lQzUziO9VQN6I/ob/KQeOVjyELIQshCyELIQshC/sa6zJRxdtd+0zov3MjymP/TWvQ5WTkvkCWxasXUAuEHdEe2iGnbrDayhcwWlWwRQ6qJ8xmZ/+YwmSkdjaE7hCyPnfL0kXkPWcglDGVtNigoy9+nZndkWcwq8vF4Lbaxyw9kSazvn3TFz2zTyJ0smQkGpdmqW58bK5Ash6k9NHY7bmEQs0CyNPZK3x8fDXaGLINZT0hRfFEc3ZElMp8MEyPNN1hZ7yNDdjWr9ipV0ZNsR2NkK1g/nt9idy8sky1g/uTwDWSpDBlsnLVjg8SRIbuQyYwx1KaYljgyZFeybyELIQshCyELIQshC/ln9gM8X2H2uNM9NgAAAABJRU5ErkJggg=="
    }
}
Modified at 2026-09-28 00:06:45
Previous
Pay Innbucks Sandbox
Next
Pay Innbucks Production
Built with