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 Sandbox

      POST
      /api/merchant/sandbox/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:
      Udean Mbano
      paymentLinkDescription
      string 
      required
      Description of payments
      Example:
      Test Description
      paymentLinkReference
      string 
      required
      Example:
      FastCheckout0002
      paymentLinkAmount
      string 
      required
      Default Amount
      Example:
      5.00
      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:
      4271941
      paymentLinkStartDate
      string 
      required
      Payment profile Id
      Example:
      2025-02-26
      paymentLinkEndDate
      string 
      required
      Start Date formart yyyy-MM-dd
      Example:
      2025-02-26
      paymentLinkCurrency
      string 
      required
      End Date formart yyyy-MM-dd
      Example:
      USD
      paymentLinkCurrencyId
      string 
      required
      Example:
      1
      paymentLinkOtherCurrencies
      string 
      required
      Example:
      false
      paymentLinkCustomerRedirectUrl
      string 
      required
      Example:
      https://google.com
      paymentCustomerFailRedirectUrl
      string 
      required
      Image Attachment
      Example:
      https://google.com
      paymentLinkEmail
      string 
      required
      Example:
      udean@smatechgroup.com
      paymentPayerFullNames
      string 
      required
      Image Attachment
      Example:
      Keith Chimeto
      paymentPayerEmailAddress
      string 
      required
      Example:
      udean@smatechgroup.com
      paymentPayerAddress
      string 
      required
      Example:
      55A
      paymentPayerMobile
      string 
      required
      Example:
      263779627951
      paymentLinkImage
      file 
      required
      Image Attachment

      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/sandbox/fastCheckOut' \
      --form 'id=""' \
      --form 'paymentLinkName="Udean Mbano"' \
      --form 'paymentLinkDescription="Test Description"' \
      --form 'paymentLinkReference="FastCheckout0002"' \
      --form 'paymentLinkAmount="5.00"' \
      --form 'paymentLinkType="ONCE_OFF_FIXED"' \
      --form 'paymentLinkImageType="NEW"' \
      --form 'paymentLinkProfileId="4271941"' \
      --form 'paymentLinkStartDate="2025-02-26"' \
      --form 'paymentLinkEndDate="2025-02-26"' \
      --form 'paymentLinkCurrency="USD"' \
      --form 'paymentLinkCurrencyId="1"' \
      --form 'paymentLinkOtherCurrencies="false"' \
      --form 'paymentLinkCustomerRedirectUrl="https://google.com"' \
      --form 'paymentCustomerFailRedirectUrl="https://google.com"' \
      --form 'paymentLinkEmail="udean@smatechgroup.com"' \
      --form 'paymentPayerFullNames="Keith Chimeto"' \
      --form 'paymentPayerEmailAddress="udean@smatechgroup.com"' \
      --form 'paymentPayerAddress="55A"' \
      --form 'paymentPayerMobile="263779627951"' \
      --form 'paymentLinkImage=@""'

      Responses

      🟢200Fast Checkout Sandbox
      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
      Fast Checkout
      Built with