Create SwissQR Bill
Barcode → Create SwissQR Bill
The Create SwissQR Bill API generates a Swiss QR-bill PDF that complies with the official Swiss standard. You send a base PDF (docContent, docName), creditor details (IBAN, name, address), debtor details, amount, currency, referenceType, languageType, seperatorLine, and optionally IsAsync. The API returns a PDF with the SwissQR Bill attached. Use the tester below to try it; more details are in the sections that follow.
Try the Create SwissQR Bill API
Endpoint: POST /api/v2/CreateSwissQrBill · Required: api-key, docContent, docName, iban, crName, crAddressType, crStreetOrAddressLine1/2, crPostalCode, crCity, amount, currency, udName, udAddressType, udStreetOrAddressLine1/2, udPostalCode, udCity, referenceType, languageType, seperatorLine, IsAsync
Use the form below to send your API key, PDF (Base64), and all creditor/debtor and payment fields. The response is the PDF with the Swiss QR-bill. No code required—fill the fields and click Send request.
Overview, parameters, and use cases
- Overview
- Parameters
- Use cases
What is Create SwissQR Bill?
This endpoint creates a Swiss QR-bill PDF that complies with the official Swiss standard (June 2020). You provide a base PDF and full payment data: creditor (IBAN, name, address), ultimate debtor, amount, currency, reference type, language, and separator style. The API returns a PDF with the Swiss QR-bill attached, ready for banking and digital payment.
Key features
- Swiss standard compliant – Structured payment info, creditor/debtor details, embedded QR code, and proper layout.
- Full payment data – IBAN, amount, currency (CHF, EUR, USD), reference type (QRR, NON, SCOR), language (English, German, French, Italian).
- Separator options – seperatorLine: LineWithScissor, DashedLineWithScissor, or SolidLine for cutting/tearing.
Use for Swiss invoices, bills, or any document that must carry a Swiss QR-bill. Combine with Read SwissQR Code to verify or extract payment data from existing Swiss QR-bills.
API parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| api-key | string | Yes | Your PDF4me API key, Base64 encoded. Get it from the dashboard. |
| docContent | base64 | Yes | PDF file content (Base64). |
| docName | string | Yes | PDF file name with .pdf extension. |
| iban | string | Yes | Swiss IBAN for the creditor (e.g. CH0200700110003765824). |
| crName, crAddressType, crStreetOrAddressLine1, crStreetOrAddressLine2, crPostalCode, crCity | string | Yes | Creditor name, address type (S/K), street, postal code, city. |
| amount | string | Yes | Payment amount (no leading zeroes). |
| currency | string | Yes | CHF, EUR, or USD. |
| udName, udAddressType, udStreetOrAddressLine1, udStreetOrAddressLine2, udPostalCode, udCity | string | Yes | Ultimate debtor name and address. |
| referenceType | string | Yes | QRR, NON, or SCOR. |
| languageType | string | Yes | English, German, French, or Italian. |
| seperatorLine | string | Yes | LineWithScissor, DashedLineWithScissor, or SolidLine. |
| IsAsync | boolean | Yes | Enable asynchronous processing. |
When to use Create SwissQR Bill
- Invoices and bills – Add Swiss QR-bills to invoices for digital payment in Switzerland.
- Payment processing – Generate compliant bills for automated payment workflows.
- Banking and accounting – Integrate Swiss QR-bill creation into banking or ERP systems.
- Regulatory compliance – Meet Swiss banking and payment standards with the official layout and QR code.
For request/response schemas and code samples, see Create SwissQR Bill in the PDF4me API docs.
Prerequisites
Before using this endpoint, make sure you have:
- A valid PDF4me API key (Get your API Key)
- A PDF document to attach the SwissQR Bill to
- All required payment information (IBAN, creditor details, debtor details, amount, currency)
- The PDF file encoded in Base64 format
Response Format
The API returns a PDF file with the SwissQR Bill. Status 200 returns the PDF in the response body; Status 202 means processing is asynchronous—poll the Location header URL until the PDF is ready.