Receipt APICompliant receipts withone integration
The PosDealer API lets users manage entitlements, track installations, and provision compliant configurations across thousands of installations.
The fiskaltrust Receipt-API
The fiskaltrust Receipt-API is the central interface for managing the receipt lifecycle. It covers receipt creation, signing, issuing, transport, retrieval, and audit access in a consistent and regulated way. Receipts are treated as a core system component, independent of channel, device, or delivery method, and work the same across supported markets.
The API lets you focus on your system while fiskaltrust takes care of receipt infrastructure. Instead of building and maintaining country-specific formats, transport logic, and edge cases, you rely on a unified, open-source API that stays stable while regulations and operational requirements change.
Core API functionalities
Core API functionalities
- create – Receipt with items, payments, and totals.
- sign – Apply national fiscal rules, signatures, and hash chaining.
- issue – Deliver receipt in HTML, PDF, QR code, or via email/SMS.
- retrieve – Fetch receipts by ID, order reference, or time range.
- verify – Validate signatures and integrity.
- revoke – Mark a receipt as cancelled or corrected.
- journal – Export audit logs, closings, and reports.
Key Features
- Format Flexibility: You can get receipts as visualizations or raw data. Choose from formats like HTML, PDF, PNG, or JSON.
- Compliance: The API ensures your receipts meet legal requirements.
- Speed: Use the POS-API Helper to upload receipts instantly. Without this helper, uploads can take up to five minutes.
- Data Retrieval: The API provides a secure way to access receipt data. This lets you integrate receipts into your own applications.
Each operation maps to receipt lifecycle steps. A receipt is created from order and payment data, signed under national law, and issued to the consumer. It can be retrieved for returns, verified for audits, revoked if corrected, and exported as part of a journal. The entire process is deterministic, tamper-evident, and aligned with the rules of each country.
The Receipt-API provides a resilient foundation for receipt handling, making integration easy, reducing complexity and ensuring business continuity even when printers fail through compliant digital fallback.
Why Developers Use Receipt-API
The API lets you focus on your system while fiskaltrust takes care of receipt infrastructure. Instead of treating receipts as a side feature or a consumer add-on, the Receipt-API handles receipts as a first-class, regulated system component. You integrate once and rely on a unified, open-source API that is maintained as regulations and operational requirements evolve.
- Open-source: Transparent implementation with no vendor lock-in and full auditability.
- Unified receipt model: One data structure for items, payments, taxes, metadata, signatures, and lifecycle states.
- Hybrid receipt handling: Digital and paper receipts handled through the same API, including HTML, ESC/POS, PDF, and device-native formats.
- Multi-market support: Same payloads and lifecycle logic across AT, DE, FR, IT, ES, PT and more.
- Decoupled compliance logic: Fiscal rules, formats, and signing mechanisms evolve independently of your application code.
- Business continuity: Receipt creation, signing, and issuing remain deterministic and reliable across online, offline, and degraded network scenarios.
- Reduced integration time: No country-specific receipt rendering, printing logic, or transport flows to maintain in your own codebase.
- Receipt visualisation included: Standardised, compliant HTML receipt documents that work across devices and operating systems.
- Built-in transport channels: Receipt delivery via QR code, URL, email, SMS, or device handoff, without custom transport logic.
The Receipt API enables developers and resellers to build a consistent omnichannel receipt layer and expose receipt data as a reusable service.
Receipts become a secure, structured data source that can be reused across loyalty, accounting, and third-party integrations, turning transactions into extensible system touchpoints rather than isolated events.
Hosting Options
Hosting Options
- Local services: Windows, Linux, macOS, Android, iOS.
- Merchant data centre: Kubernetes clusters or IIS deployment.
- Cloud: European Azure regions with market-specific compliance.
- Offline fallback: Local IoT broker ensures receipt operations continue during outages.
The Receipt-API supports flexible deployment. It can be embedded in your POS, run as a local service, deployed at scale in a data centre, or used via fiskaltrust-hosted cloud services. All models follow the same API contract. Offline brokers make sure receipt creation and signing work even if the internet connection fails.
Sandbox Environment
You can test the system in our sandbox environment. Register as a partner in a fiskaltrust Market portal. Extend your endpoint to call the API. This process allows you to retrieve receipt data in your preferred format and visualize it.
How it works in 3 steps
1.
Sign up at the fiskaltrust.Portal.
2.
Create cashbox and connect it to your POS or ERP.
3.
Start creating and issuing receipts with the Receipt-API.
Explore more - Documentation, SDKs, and test environments are available here