Custom hardware integrations
Each diagram below illustrates one possible high-level integration flow, not a fixed specification. For the authoritative reference on each integration, see the the specific integration articles.
The message flow between the kiosk frontend, FO, the kiosk integration (cloud and on-device), and the POS depends on which capabilities your kiosk integration provides. This article gives one diagram per scenario, so find the heading that matches your integration rather than reading all of them.
Scanner integration
If your kiosk uses barcode or QR code scanning, refer to the following diagram. Scanning does not depend on, or change, the payment or printing flow.
This diagram shows the messages exchanged when the guest scans a barcode or QR code, independent of any payment or printing scenario below.
See Scanner service for the plugin-side implementation.
Without external payment terminal integration
Use this section if the kiosk does not integrate with a payment terminal — for example, if the guest pays with a mobile wallet, a stored value card, or another payment method that is not connected to the kiosk itself.
Non-fiscal country
Without receipt printing option selection
This diagram shows a kiosk order placed without any kiosk payment terminal integration, in a non-fiscal country, with no receipt printing option offered to the guest.
With receipt printing option selection
This diagram shows the same non-fiscal, no-payment-terminal scenario, but with the guest offered a receipt printing option after a successful order placement.
Fiscal country
When payment does not go through the kiosk's own payment terminal integration, there is no payment reservation or capture flow to anchor fiscalization to. Instead, Kiosk Integration Cloud listens for the order.placed_in_pos event from FO and fiscalizes based on that event.
Without receipt printing option selection
This diagram shows a kiosk order placed without any kiosk payment terminal integration, in a fiscal country, with no receipt printing option — Kiosk Integration Cloud fiscalizes directly off the order.placed_in_pos event.
With receipt printing option selection
This diagram shows the same fiscal, no-payment-terminal scenario, but with a receipt printing option offered to the guest. If a receipt option selection dialog is shown, fiscalization happens in line with that choice — with the print, or with the order cleared message if the guest declines. If neither of those is observed, for example because the dialog times out, Kiosk Integration Cloud must still fiscalize on its own once it has received the order.placed_in_pos event, since the fiscal obligation does not depend on whether a receipt was printed.
With external payment terminal integration
When a kiosk needs to accept card payment through a payment terminal Future Ordering does not already integrate with, you can connect that terminal by integrating the terminal as an External Payment Provider.
Use one of the following sections if the kiosk integrates with a payment terminal via a External Payment Provider. Pick the section matching whether the terminal supports AUTH separated from CAPTURE, whether the country is a fiscal country, and whether or not the integration also provides receipt printing options as well.
AUTH separated from CAPTURE
Non-fiscal country
Without receipt printing option selection
This diagram shows a payment terminal that supports AUTH separated from CAPTURE, in a non-fiscal country, with no receipt printing option offered to the guest — the terminal captures and prints the receipt automatically once the order is placed.
With receipt printing option selection
This diagram shows the same AUTH/CAPTURE-separated, non-fiscal scenario, but with the guest offered a receipt printing option after a successful order placement, instead of the receipt being printed automatically.
Fiscal country
Without receipt printing option selection
This diagram shows the AUTH/CAPTURE-separated scenario in a fiscal country with no receipt printing option offered to the guest — the terminal captures, prints, and fiscalizes automatically once the order is placed.
With receipt printing option selection
This diagram shows the AUTH/CAPTURE-separated scenario in a fiscal country with a receipt printing option offered to the guest — fiscalization happens in line with the guest's print or order-cleared choice instead of automatically at capture.
Single SALE operation (AUTH + CAPTURE together)
Non-fiscal country
Without receipt printing option selection
This diagram shows a payment terminal that performs AUTH and CAPTURE as a single SALE operation, in a non-fiscal country, with no receipt printing option offered to the guest.
With receipt printing option selection
This diagram shows the same single-SALE, non-fiscal scenario, but with the guest offered a receipt printing option after a successful order placement.
Fiscal country
Since AUTH and CAPTURE cannot be separated, the terminal must fiscalize and print the receipt as part of the single SALE operation, before FO knows whether the POS will accept the order (POS integrations can build POS-specific functionality to reduce risk of order placement failures, such as pre-loading the order to the POS before starting payment). If the POS later rejects the order, there is no automated way to reverse a fiscal receipt that has already been printed — this is why annulment in this scenario falls back to a manual store-side process.
Without receipt printing option selection
This diagram shows the single-SALE scenario in a fiscal country with no receipt printing option offered to the guest — fiscalization and printing happen upfront as part of the SALE, before FO knows whether the POS will accept the order (POS integrations can build POS-specific functionality to reduce risk of order placement failures, such as pre-loading the order to the POS before starting payment).
With receipt printing option selection
This diagram shows the single-SALE scenario in a fiscal country with a receipt printing option offered to the guest — the terminal fiscalizes upfront during the SALE, then again in line with the guest's later print or order-cleared choice.