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

      Fast Checkout

      POST
      /api/merchant/fastCheckOut
      Fast Checkout types ONCE_OFF_FIXED,OPEN_FIXED_AMOUNT,OPEN_DYNAMIC_AMOUNT

      Request

      Authorization
      Provide your bearer token in the
      Authorization
      header when making requests to protected resources.
      Example:
      Authorization: Bearer ********************
      Body Params multipart/form-data
      id
      string 
      required
      Id of payment Link when updating
      paymentLinkName
      string 
      required
      Name of Payment Link
      Example:
      {{name}}
      paymentLinkDescription
      string 
      required
      Description of payments
      Example:
      {{Description}}
      paymentLinkReference
      string 
      required
      Example:
      {{Reference}}
      paymentLinkAmount
      string 
      required
      Default Amount
      Example:
      {{Amount}}
      paymentLinkType
      string 
      required
      ONCE_OFF_FIXED,OPEN_FIXED_AMOUNT,OPE
      Example:
      ONCE_OFF_FIXED
      paymentLinkImageType
      string 
      required
      Image Attachment
      Example:
      NEW
      paymentLinkProfileId
      string 
      required
      NEW/UPDATE/NONE
      Example:
      {{profileId}}
      paymentLinkStartDate
      string 
      required
      Payment profile Id
      Example:
      {{startDate}}
      paymentLinkEndDate
      string 
      required
      Start Date formart yyyy-MM-dd
      Example:
      {{endDate}}
      paymentLinkCurrency
      string 
      required
      End Date formart yyyy-MM-dd
      Example:
      {{currency}}
      paymentLinkCurrencyId
      string 
      required
      Example:
      {{currencyId}}
      paymentLinkOtherCurrencies
      string 
      required
      Example:
      {{true or false}}
      paymentLinkCustomerRedirectUrl
      string 
      required
      Example:
      {{url}}
      paymentCustomerFailRedirectUrl
      string 
      required
      Image Attachment
      Example:
      {{url}}
      paymentLinkEmail
      string 
      required
      Example:
      {{email}}
      paymentLinkImage
      file 
      required
      Image Attachment
      paymentPayerFullNames
      string 
      required
      Example:
      {{Payer Names}}
      paymentPayerEmailAddress
      string 
      required
      Example:
      {{Payer Email Address}}
      paymentPayerAddress
      string 
      required
      Example:
      {{Payer Address }}
      paymentPayerMobile
      string 
      required
      Example:
      {{Payer Mobile}}

      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/api/merchant/fastCheckOut' \
      --form 'id=""' \
      --form 'paymentLinkName="{{name}}"' \
      --form 'paymentLinkDescription="{{Description}}"' \
      --form 'paymentLinkReference="{{Reference}}"' \
      --form 'paymentLinkAmount="{{Amount}}"' \
      --form 'paymentLinkType="ONCE_OFF_FIXED"' \
      --form 'paymentLinkImageType="NEW"' \
      --form 'paymentLinkProfileId="{{profileId}}"' \
      --form 'paymentLinkStartDate="{{startDate}}"' \
      --form 'paymentLinkEndDate="{{endDate}}"' \
      --form 'paymentLinkCurrency="{{currency}}"' \
      --form 'paymentLinkCurrencyId="{{currencyId}}"' \
      --form 'paymentLinkOtherCurrencies="{{true or false}}"' \
      --form 'paymentLinkCustomerRedirectUrl="{{url}}"' \
      --form 'paymentCustomerFailRedirectUrl="{{url}}"' \
      --form 'paymentLinkEmail="{{email}}"' \
      --form 'paymentLinkImage=@""' \
      --form 'paymentPayerFullNames="{{Payer Names}}"' \
      --form 'paymentPayerEmailAddress="{{Payer Email Address}}"' \
      --form 'paymentPayerAddress="{{Payer Address }}"' \
      --form 'paymentPayerMobile="{{Payer Mobile}}"'

      Responses

      🟢200Fast Checkout
      text/plain
      Body
      status
      string 
      required
      paymentLink
      object 
      required
      paymentProfileName
      string 
      required
      paymentProfileDescription
      string 
      required
      paymentLinkReference
      string 
      required
      paymentLinkUrl
      string 
      required
      paymentLinkAmount
      integer 
      required
      paymentLinkType
      string 
      required
      paymentLinkToken
      string 
      required
      paymentLinkImageUrl
      string 
      required
      paymentLinkStartDate
      string 
      required
      paymentLinkEndDate
      string 
      required
      paymentLinkIsActive
      boolean 
      required
      createdAt
      string 
      required
      id
      integer 
      required
      message
      string 
      required
      Example
      {
        "status": "Success",
        "paymentLink": {
          "paymentProfileName": "Church Offering",
          "paymentProfileDescription": "Offering for every Sunday Service",
          "paymentLinkReference": "Pay00001",
          "paymentLinkUrl": "https://staging-payments.smatpay.africa/global?token=yr1d_ljcPzFpHV3eRRP57rbwvdj7mITG",
          "paymentLinkAmount": 10,
          "paymentLinkType": "ONCE_OFF_FIXED",
          "paymentLinkToken": "yr1d_ljcPzFpHV3eRRP57rbwvdj7mITG",
          "paymentLinkImageUrl": "https://smatpay.s3.af-south-1.amazonaws.com/20240805150004-VPN.png",
          "paymentLinkStartDate": "2024-07-26T00:00:00.000+00:00",
          "paymentLinkEndDate": "2024-07-26T00:00:00.000+00:00",
          "paymentLinkIsActive": true,
          "createdAt": "2024-08-05T15:00:05.045+00:00",
          "id": 14
        },
        "message": "Payment link created successfully! Image URL: https://smatpay.s3.af-south-1.amazonaws.com/20240805150004-VPN.png"
      }
      Modified at 2025-03-10 20:49:15
      Previous
      Cancel Recurring Payment Sandbox
      Next
      Fast Checkout Sandbox
      Built with