Welcome to Cheqi Developer Documentation

Cheqi is a unified receipt platform with SDKs and APIs that let you generate and deliver digital receipts with minimal integration effort. You focus on creating receipts — Cheqi handles recipient resolution, secure delivery, and downstream integrations.

Building digital receipts is deceptively hard. As a developer you quickly run into the same problems:

• Customer identification (who should receive the receipt?)
• Reliable delivery (app, multiple devices, and fallbacks when the customer isn’t a user yet)
• Security and privacy requirements (you shouldn’t have to store or expose customer data)
• Downstream integrations (accounting/expense tools, webhooks, and verification)

• Sandbox Environment - Test your integration end-to-end
• Receipt Flow Overview - Learn how receipts are processed end-to-end
• Credit Notes - Process returns and issue credit notes
• Authentication - API Keys and OAuth 2.0
• Java SDK - Integrate Cheqi with Java/Spring Boot
• JavaScript SDK - Integrate Cheqi with JavaScript/TypeScript
• Python SDK - Integrate Cheqi with Python
• .NET SDK - Integrate Cheqi with C#/.NET
• CLI - Agent-first command-line tool for the receipt flow
• API Reference - Full endpoint reference

• Recipient resolution - Automatically route receipts using payment data, pairing codes, or email
• Reliable delivery - Deliver to customer apps across all devices, with optional PDF email fallback and a QR-code download fallback when enabled
• Zero-knowledge architecture - Receipt data is encrypted so only the intended recipients can read it (Cheqi can't)
• Privacy by default - Receipt delivery is designed so sensitive customer data stays protected
• Webhooks for integrations - Push receipts and credit notes to authorized third-party systems (accounting/expense tools)
• Selectable receipt formats - Deliver Cheqi JSON, UBL PurchaseReceipt, UBL Invoice, or the subset accepted by each recipient
• Credit notes - Full return and refund flow with credit notes linked to original receipts via parentCheqiReceiptId
• Cryptographic verification - RFC 8785 canonical JSON + SHA-256 hashing for tamper-proof receipts and credit notes

1. Try the sandbox - Go to sandbox.portal.cheqi.io to create a test account and test the full flow (Sandbox Guide)
2. Get credentials (API key or OAuth, depending on your use case)
3. Upload your public key - Generate an RSA key pair and upload the public key to your client application. Portal uploads accept PEM; direct API uploads send the PEM content Base64-encoded.
4. Install the SDK for your platform (Java, JavaScript, Python, or .NET)
5. Send identification details (webshop email and/or payment details from your provider)
6. Submit receipt data and let the SDK/flow handle delivery
7. Optionally subscribe to webhooks to receive receipts in third-party systems

• Email: support@cheqi.io
• Documentation: https://docs.cheqi.io