SmatPay Merchant Public Api
  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 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
  • Fiscalization
    • add-invoice
    • add-debit-note
    • add-credit-note
    • money-type-list
  1. Payments

Generate Recurring Payment Sandbox

POST
/sandbox/api/addRecurringPayment

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json

Example
{
    "recurringMerchantId": "{{merchantId}}",
    "recurringIntervalId": "{{PaymentIntervalId}}",
    "recurringIntervalName": "{{PaymentIntervalName}}",
    "recurringPaymentToken": "{{Paymenttoken}}",
    "recurringReference": "{{Reference}}",
    "recurringDescription": "{{recurringDescription}}",
    "recurringPaymentProfileId": {{profileId}},
    "recurringPaymentAccountId": {{accountId}},
    "recurringStartDate": "{{StartDate}}",
    "recurringExpiryDate": "{{ExpiryDate}}",
    "recurringCurrency":"{{currency}}",
    "recurringAmount":"{{amount}}"
}

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/sandbox/api/addRecurringPayment' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "recurringMerchantId": "{{merchantId}}",
    "recurringIntervalId": "{{PaymentIntervalId}}",
    "recurringIntervalName": "{{PaymentIntervalName}}",
    "recurringPaymentToken": "{{Paymenttoken}}",
    "recurringReference": "{{Reference}}",
    "recurringDescription": "{{recurringDescription}}",
    "recurringPaymentProfileId": {{profileId}},
    "recurringPaymentAccountId": {{accountId}},
    "recurringStartDate": "{{StartDate}}",
    "recurringExpiryDate": "{{ExpiryDate}}",
    "recurringCurrency":"{{currency}}",
    "recurringAmount":"{{amount}}"
}'

Responses

🟢200Generate Recurring Payment Sandbox
text/plain
Body

Example
{
    "status": "Success",
    "message": "Recurring payment added successfully"
}
Modified at 2025-03-10 20:49:15
Previous
Payment Status Mastercard Production
Next
Generate Payment Token Sandbox
Built with