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 Innbucks Sandbox

      POST
      /init/authenticate/merchant/wallet

      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}}
      }

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

      Responses

      🟢200Innbucks Example
      text/plain
      Body

      Example
      {
          "auth": {
              "token": "eyJhbGciOiJIUzUxMiJ9.eyJVc2VySWQiOjMxLCJyb2xlcyI6WyJVU0VSIl0sInN1YiI6ImRldkBzbWF0cGF5LmFmcmljYSIsImlhdCI6MTcyODkzMjUzMiwiZXhwIjoxNzI4OTUwNTMyfQ.2oWk_BTD1HBr06gW-ZB6NsjvhbIwdkqRv5EuUe_LfSNQeRAnDtuODk8iNfQ6kZkdy3zMvcbxio5jTkxqdTIVWA",
              "user": {
                  "id": 31,
                  "email": "dev@smatpay.africa",
                  "role": "USER",
                  "token": "eyJhbGciOiJIUzUxMiJ9.eyJVc2VySWQiOjMxLCJyb2xlcyI6WyJVU0VSIl0sInN1YiI6ImRldkBzbWF0cGF5LmFmcmljYSIsImlhdCI6MTcyODkzMjUzMiwiZXhwIjoxNzI4OTUwNTMyfQ.2oWk_BTD1HBr06gW-ZB6NsjvhbIwdkqRv5EuUe_LfSNQeRAnDtuODk8iNfQ6kZkdy3zMvcbxio5jTkxqdTIVWA"
              },
              "errorResponse": {
                  "errorMessage": null,
                  "statusCode": 0
              }
          },
          "paymentInitiationResponse": {
              "status": "00",
              "paymentTokenExpiry": "2024-10-14T21:17:12.000+02:00",
              "paymentTokenDescription": "Request successful",
              "paymentToken": "eyJhbGciOiJIUzUxMiJ9.eyJqdGkiOiIxYWY2NTQ2My0yYzhiLTQzYmUtOGFlYS1mNmZkMjVmODgyMWUiLCJzdWIiOiJTbWF0ZWNoR3JvdXBDbGllbnQxQ090b2l4WTpjOTkwMmE1NC1mMTE3LTRhMGQtOWZhMy00MzExZTdlMjQ5ZWUiLCJpcCI6IjY1LjEwOC43NS42OSwgMTYyLjE1OC4yMzkuOTEiLCJ1c2VyVHlwZSI6Ik1FUkNIQU5UIiwiY2hhbm5lbCI6IkFQSSIsImlzcyI6IkFQSSBHYXRld2F5IiwiaWF0IjoxNzI4OTMyNTMyLCJleHAiOjE3Mjg5MzM0MzIsInN1cHBvcnRlZFRyYW5UeXBlcyI6WyJDT0RFX1BBWU1FTlQiXSwiYWNjb3VudCI6IjIwMDQwMDM3MjQ4MDQifQ.JPpHaY3y2GbSWzkHVL1ppOYRNDPz_sRL7j5fbowcEI_WsEBc0hGhGlhubUVF9fb3-XF07t-az4iPrZHBVo7BFg",
              "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 2025-03-10 20:49:15
      Previous
      Test Webhook Production
      Next
      Pay Innbucks Sandbox Bulk
      Built with