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

add-credit-note

POST
/api/credit-note

Request

Header Params

Body Params application/json

Example
{
  "invoiceNo": "INV-39",
  "deviceID": "27322",
  "receiptNotes": "Reverse the invoice"
}

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 '/api/credit-note' \
--header 'X-Merchant-Id: 311722504951049' \
--header 'X-Merchant-Api-Key: V8S5M2C3L0nYPz8ZDVRhq' \
--header 'X-Merchant-Key: 959d936d-c79a-4711-9528-2d0dc4399142' \
--header 'Content-Type: application/json' \
--data-raw '{
  "invoiceNo": "INV-39",
  "deviceID": "27322",
  "receiptNotes": "Reverse the invoice"
}'

Responses

🟢200add-debit-note-example
application/json
Body

Example
{
    "statusCode": 200,
    "message": "Successfully submitted receipt",
    "data": {
        "receiptID": 6405613,
        "serverDate": "2025-09-10T16:01:28",
        "receiptServerSignature": {
            "certificateThumbprint": "967C31EBE3BCE74C0255848E999A727A539FC719",
            "hash": "HEuNQQjxIoXGPcKq5HukzkFsRwQMZn7eTbVKuUjmA9s=",
            "signature": "jbfRBb1znAcfYtfwWUdYDHzftxkoqRj56IOlKLbigJokeZJcTsvuGAGkSNdrnXYZ+OTE9sc7FKvW6IlW5hXPcsqA/s1Stumpe1AfrR2TZAyo5Cc/GbtAxGRhA4lnbQX71sGarOIVk7RQ3X1eGUdpBfhnL4HjoGNZcbSOS2U8t+hlzKEHWhGc9WSFW4GKmTsuMqe4vPVg93Lk7o2hhHXiWIHwbzyNV6RSR3lmkBgy1sW2VRsaDtiwSGXsLGM8KDlY6UtXVP1HOQg27twOTBRxpbpG89vVv0bJoETNP6Cm5nLwqeYsLwZMqIw1BzpQMZDUp2xkKxYsm8spXMtGVZd7gg=="
        },
        "validationErrors": [
            {
                "validationErrorCode": "RCPT041",
                "validationErrorColor": "Yellow"
            }
        ],
        "operationID": "0HNFGCGSSTA4C:00000001"
    },
    "list": null,
    "qrData": "https://fdmstest.zimra.co.zw/Receipt/Result?ReceiptGlobalNo=0000000034&ReceiptDate=2025-09-10&DeviceId=0000027322&ReceiptQrData=5190-BF4E-936E-C9D0"
}
Modified at 2025-09-11 11:06:10
Previous
add-debit-note
Next
money-type-list
Built with