RECEIPT Integration Guide

RECEIPT Integration Guide

This guide walks you through integrating the fiskaly RECEIPT API to replace paper receipts with legally compliant digital receipts across all EU countries.

📘Detailed API specification

For the complete API reference including all endpoints, schemas, and parameters, see the RECEIPT API documentation. This guide covers the conceptual integration flow.

Prerequisites

Before you begin, ensure you have:

• A fiskaly organization with RECEIPT activated (contact sales@fiskaly.com or your account manager)
• API credentials (API Key and Secret) for the RECEIPT service
• A POS system or application capable of making HTTPS requests

Integration Overview

The RECEIPT flow works in three phases:

1. Create — Your POS sends transaction data to the RECEIPT API
2. Deliver — The API generates a digital receipt and returns a delivery mechanism (QR code, link, etc.)
3. Present — The customer receives the receipt via their preferred channel

Step-by-Step Integration

1. Authenticate

   Obtain an access token using your RECEIPT API credentials:

   curl -X POST https://receipt.fiskaly.com/api/v1/auth \
     -H "Content-Type: application/json" \
     -d '{
       "api_key": "YOUR_API_KEY",
       "api_secret": "YOUR_API_SECRET"
     }'

   The response includes an access_token valid for 24 hours. Include it as a Bearer token in all subsequent requests.

2. Configure your merchant profile

   Set up your merchant information which will appear on all generated receipts:

   • Company name and legal form
   • Address and contact information
   • Tax identification numbers
   • Logo (optional)
   • Receipt customization preferences
3. Create a receipt

   After each transaction, send the receipt data to the RECEIPT API:

   curl -X POST https://receipt.fiskaly.com/api/v1/receipts \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
       "items": [
         {
           "description": "Product A",
           "quantity": 2,
           "unit_price": 1299,
           "vat_rate": "19.00"
         }
       ],
       "payment": {
         "method": "card",
         "amount": 2598
       }
     }'

   Amounts are in the smallest currency unit (cents).

4. Present the receipt to the customer

   The API response includes delivery options:

   • QR Code — Display on the POS screen or print a small QR code for the customer to scan
   • Static Code — A persistent code linked to the merchant for repeat customers
   • Direct Link — A URL the customer can open in any browser

   The customer views their receipt on receipt.fiskaly.com — no app download required.

5. Connect with fiskaly SIGN (optional)

   If you use fiskaly SIGN for fiscal compliance, RECEIPT can automatically link receipts to signed transactions. This provides:

   • Automatic inclusion of fiscal signature data on the digital receipt
   • QR code validation support
   • End-to-end audit trail from transaction to receipt delivery

Delivery Channels

Channel	How It Works	Best For
QR Code	Customer scans a QR code displayed on screen or printed	In-store POS, quick service
Static Code	Persistent QR code linked to the merchant location	Counter displays, table tents
Email	Receipt sent directly to customer email	E-commerce, reservations
Link	Shareable URL to the hosted receipt	Any delivery channel

💡No app required

RECEIPT works entirely via the web. Customers view receipts in their browser at receipt.fiskaly.com — no app download, account creation, or registration needed.

Compliance

RECEIPT-generated digital receipts are legally compliant across all EU countries:

• Meets electronic document requirements under EU VAT Directive
• Compliant with country-specific receipt obligations (Germany, Austria, France, etc.)
• Data security guaranteed by fiskaly’s ISO 27001 certification
• Receipts are immutable once created — full audit trail maintained

Try It Now

Create a demo receipt to see the customer experience before integrating.

Resources

For more detailed technical information, download the full integration guide:

• Integration Guide (PDF) — Complete API reference with request/response examples
• RECEIPT API Reference — Full OpenAPI specification
• Quick Start — Minimal setup to create your first receipt
• FAQ — Common questions about RECEIPT