Skip to content

Commit bfa7647

Browse files
authored
Merge pull request #19 from fiskaltrust/sidebar-updated
Added Experience Middleware to sidebar
2 parents 1c565a2 + 4711efc commit bfa7647

5 files changed

Lines changed: 287 additions & 186 deletions

File tree

poscreators/middleware-doc/appendix-me/appendix-me.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ title: Introduction
66
# Fiscalization in Montenegro
77
This chapter expands on the information provided in the _General_ chapter by adding details specific to the fiscalization for Montenegro. This additional information is provided only where applicable. The remaining chapters, for which there is no extra information required, were omitted.
88

9-
Legal regulations and further information can be found [on the website of the Montenegran tax authority](https://www.gov.me/upravaprihoda/elektronska-fiskalizacija).
9+
Legal regulations and further information can be found on the website of the Montenegran tax authority.
1010

1111

1212
<div class="alert alert--warning" role="alert">Please note that this information is only complete when combined with the <b>General</b> part. To implement the Middleware, users should get themselves familiar with the general information first and then refer to the country-specific details listed here.</div>
Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
title: Introduction
3+
slug: /poscreators/experience-middleware/introduction
4+
---
5+
6+
# Introduction
7+
8+
The **Experience Middleware** extends the fiskaltrust.Middleware with features that improve the checkout experience for merchants and consumers, without changing existing POS workflows.
9+
10+
While the compliance stack focuses on fiscal requirements such as receipt signing, journaling, and reporting, the Experience Middleware builds on top of these core capabilities to enable modern, customer-facing features, such as **digital receipts**, **customer interaction**, and **integrated payment flows**.
11+
12+
## Included Experience Components
13+
14+
The Experience Middleware consists of the following components:
15+
16+
- **Payment**: Integrates payment flows into the fiskaltrust platform using a unified payment endpoint, while keeping POS systems independent of specific payment providers.
17+
18+
- **Digital Receipt**: Enables receipts to be delivered digitally via QR code, link, message, or other channels after a transaction has been fiscalized.
19+
20+
- **InStore App**: A customer-facing application that displays receipts, QR codes, and receipt interaction options at the point of sale.
21+
22+
Each component can be used independently or combined, depending on the business case and market requirements.
23+
24+
## Intended Audience
25+
26+
This documentation is primarily for **PosCreators** and integrators who want to:
27+
- Enhance checkout flows with digital receipts and customer interactions.
28+
- Integrate customer-facing devices or displays.
29+
- Combine fiscalization and payments through a single middleware layer.
Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,43 @@
1+
---
2+
title: Payment
3+
slug: /poscreators/experience-middleware/payment
4+
---
5+
6+
# Payment
7+
8+
The **Payment** component of the Experience Middleware allows POS systems to integrate payments through fiskaltrust without being tied to a single payment service provider.
9+
10+
Rather than replacing existing POS payment logic, fiskaltrust provides a **unified payment endpoint** that can be used alongside fiscalization and digital receipt features. This keeps integrations flexible and avoids vendor lock-in.
11+
12+
Payments are integrated through the **InStore App** and the POS System API, allowing transactions, fiscal receipts, and optional digital receipts to be handled in a coordinated flow.
13+
14+
## Key Design Principles
15+
16+
The payment solution follows these core principles:
17+
18+
- **Single POS integration**: POS systems integrate once with the fiskaltrust payment endpoint and remain independent of specific payment providers.
19+
20+
- **Optional usage**: Payments can be used with or without fiskaltrust fiscalization, depending on the market and setup.
21+
22+
- **No mandatory lock-in**: Merchants and partners are not forced into a single PSP (Payment Service Provider) or hardware setup.
23+
24+
- **Experience-driven**: Payment flows can be combined with digital receipts and InStore App interactions to create a smoother checkout experience.
25+
26+
## Payment Integration Flow in the Experience Stack
27+
28+
A typical payment-enabled flow consists of the following steps:
29+
30+
1. The POS initiates a payment using the unified fiskaltrust payment endpoint.
31+
2. The selected payment provider processes the transaction.
32+
3. fiskaltrust links payment data with the fiscalized receipt.
33+
4. The receipt can optionally be displayed or handed over via InStore App, QR code, or Digital receipt channels.
34+
35+
This approach ensures that fiscalization, receipts, and payments remain technically linked while staying modular.
36+
37+
## Intended Audience for Payment Integration
38+
39+
Payment integration is primarily relevant for:
40+
41+
- **PosCreators** who want to support multiple payment providers with a single integration.
42+
- **PosDealers** managing merchant rollouts across markets.
43+
- **PosOperators** who want simpler setups, fewer devices, or hardware-free payment options where available.
Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
---
2+
title: Terminology
3+
slug: /poscreators/experience-middleware/terminology
4+
---
5+
6+
# Terminology
7+
8+
The following table contains descriptions and explanations of terms commonly used in the context of the **Experience Middleware**.
9+
10+
These terms relate to customer-facing features such as Digital Receipt, InStore App, and payment integrations.
11+
12+
| Term | Description |
13+
|------|-------------|
14+
| Bundle | A predefined configuration package that groups digital receipt features and behavior for simplified rollout and setup. |
15+
| Digital Receipt | A receipt generated after fiscalization and delivered to the consumer in a digital format (for example via QR code or HTTPS link), while remaining linked to the fiscal receipt. |
16+
| HTTPS Receipt | A digitally accessible receipt delivered via a secure HTTPS link, typically accessed through a QR code displayed at checkout. |
17+
| InStore App | A customer-facing application provided by **fiskaltrust** that displays receipts and receipt interaction options on a device at the point of sale. |
18+
| Multi-Terminal Setup | A configuration where multiple InStore App instances receive receipts from one or more CashBoxes, typically distinguished by terminal identification. |
19+
| Payment Provider (PSP) | A third-party service responsible for processing payment transactions, which can be accessed through the fiskaltrust payment integration. |
20+
| POS (Point of Sale) | The system used by merchants to process sales, initiate payments, and communicate with the fiskaltrust.Middleware. |
21+
| QR Code | A machine-readable code displayed on a customer-facing device that allows consumers to access a digital receipt using a mobile device. |
22+
| Receipt Identifier | A unique reference that allows a digital receipt to be securely resolved and accessed after fiscalization. |
23+
| Receipt Link | A URL that points to a digital receipt hosted by the digital receipt backend, typically encoded as a QR code. |
24+
| Terminal Identification | A configuration value used to associate receipts from a specific CashBox or terminal with an InStore App instance. |
25+
| Unified Payment Endpoint | A standardized interface provided by fiskaltrust to initiate and process payments while remaining independent of specific payment service providers. |
26+
27+
*Table 1: Experience Middleware Terminology*

0 commit comments

Comments
 (0)