- Payments
- Introduction to the SmatPay API
- Integration Guide - Quick Start
- Integration Guide - Payments
- SmatPay WooCommerce
- .NET SDK
- Get Token SandboxPOST
- Get Token ProductionPOST
- Get CurrenciesGET
- Get BanksGET
- Get Payment intervalsGET
- Payment CalculatorPOST
- Test Webhook SandboxPOST
- Test Webhook ProductionPOST
- Pay Innbucks SandboxPOST
- Pay Innbucks Sandbox BulkPOST
- Pay Innbucks ProductionPOST
- Pay Innbucks Production BulkPOST
- Pay ZimSwitch SandboxPOST
- Pay Visa SandboxPOST
- Pay Visa ProductionPOST
- Pay Mastercard SandboxPOST
- Pay Mastercard ProductionPOST
- Pay Mastercard Sandbox BulkPOST
- Pay Mastercard Production BulkPOST
- Pay Visa Sandbox BulkPOST
- Pay Visa Production BulkPOST
- Pay ZimSwitch Sandbox BulkPOST
- Pay ZimSwitch ProductionPOST
- Pay ZimSwitch Production BulkPOST
- Pay Ecocash SandboxPOST
- Pay Ecocash Sandbox BulkPOST
- Bulk Payouts SandboxPOST
- Bulk Payouts ProductionPOST
- Pay Ecocash ProductionPOST
- Pay Ecocash Production BulkPOST
- Payment Status Innbucks SandboxGET
- Payment Status Innbucks ProductionGET
- Payment Status Ecocash SandboxGET
- Payment Status Ecocash ProductionGET
- Payment Status ZimSwitch SandboxGET
- Payment Status ZimSwitch ProductionGET
- Payment Status Visa SandboxGET
- Payment Status MasterCard Sandbox CopyGET
- Payment Status Visa ProductionGET
- Payment Status Mastercard ProductionGET
- Generate Recurring Payment SandboxPOST
- Generate Payment Token SandboxPOST
- Generate Payment Token With Payment SandboxPOST
- Cancel Recurring Payment SandboxPOST
- Fast CheckoutPOST
- Fast Checkout SandboxPOST
- Fiscalization
add-invoice
POST
/api/invoice
Request
Header Params
Body Params application/json
Example
{
"deviceID": "27322",
"invoiceNo": "INV30505",
"currency": "ZWG",
"moneyType": "Card",
"receiptLines": [
{
"productType": "Goods",
"product": "Laptop",
"amount": 6000.00,
"taxPercent": 15.00,
"quantity": 2
},
{
"productType": "Service",
"product": "Cleaning",
"amount": 30.00,
"taxPercent": 15.00,
"quantity": 1
}
]
}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/invoice' \
--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 '{
"deviceID": "27322",
"invoiceNo": "INV30505",
"currency": "ZWG",
"moneyType": "Card",
"receiptLines": [
{
"productType": "Goods",
"product": "Laptop",
"amount": 6000.00,
"taxPercent": 15.00,
"quantity": 2
},
{
"productType": "Service",
"product": "Cleaning",
"amount": 30.00,
"taxPercent": 15.00,
"quantity": 1
}
]
}'Responses
🟢200add-invoice-example
application/json
Body
Example
{
"statusCode": 200,
"message": "Successfully submitted receipt",
"data": {
"receiptID": 6405579,
"serverDate": "2025-09-10T15:56:38",
"receiptServerSignature": {
"certificateThumbprint": "967C31EBE3BCE74C0255848E999A727A539FC719",
"hash": "xGoogqiOTcKOBiLeeFfAdbMpq9Zzd8OjiTpjmx0CsAc=",
"signature": "nfmh6l8ehOvI80lS8YQtmyI1wVf7tr0YFSq9gv58JOzkFfgrKEbQnp+UGeO02IjUSBw/4YzARYXhXCToFR1OVbR4kJtKOYWYClw+xTGJTnJj4Yaowj2rCZuihI7cng8P5mFBiHPmOY7y31Lg/pAab96XOMgd4VMZsNBXGOowhYJm3CCjSk8Qjo3QV4tr7DxZ8X3w47fdO1idU1TmELMctnIfo7tv/Du/j6S/0PfgJntNtdCBxhMx6hsbQ0QZAtXXL5WWjKqsvlp+uovFYss6kq/6YZZd9GmSMd2ZdwyT7oaHd+T/lLFz5wHAwNCamYIX4ukHLn//5FrJR9yECp4ayA=="
},
"validationErrors": [
{
"validationErrorCode": "RCPT041",
"validationErrorColor": "Yellow"
}
],
"operationID": "0HNFGCGSST8J1:00000001"
},
"list": null,
"qrData": "https://fdmstest.zimra.co.zw/Receipt/Result?ReceiptGlobalNo=0000000033&ReceiptDate=2025-09-10&DeviceId=0000027322&ReceiptQrData=192E-C0AE-CB75-C13D"
}Modified at 2025-09-11 11:06:10