MuteroDocs

Webhooks & Events Reference

Subscribe to real-time HTTP callbacks from Mutero for invoice fiscalization confirmations, ZIMRA submission errors, and Z-report day closures.

Webhook Signature Verification
All outgoing webhook events include an `X-Mutero-Signature` header signed with your webhook secret key to verify authenticity.

Supported Event Types

Event NameTrigger Condition
receipt.verifiedFired when an invoice is successfully signed by ZIMRA FDMS and receipt verification QR URL is issued.
receipt.failedFired when an invoice fails ZIMRA validation (e.g. invalid HS Code or missing customer TIN).
fiscal_day.openedFired when a Virtual Fiscal Device opens a new 24-hour ZIMRA fiscal day.
fiscal_day.closedFired when a fiscal day closes and the official Z-Report is generated.

Sample Webhook Event Payload

receipt.verified Event Payloadjson
{
  "id": "evt_98f4e3a2b1c",
  "event": "receipt.verified",
  "created_at": "2026-08-01T03:45:00Z",
  "data": {
    "receipt_number": "ZIMRA-2026-0098475",
    "invoice_number": "INV-2026-089",
    "verification_url": "https://fdms.zimra.co.zw/verify/ZIMRA-2026-0098475",
    "total_amount": 1200.00,
    "currency": "USD"
  }
}