Create SwissQR Bill in Make

What this module does

PDF4me Create SwissQR Bill appends a compliant Swiss QR bill payment slip to an existing PDF document. It adds the complete standardized section required by Swiss Payment Standards (ISO 20022) for invoicing within Switzerland and Liechtenstein. Supply your invoice PDF, the creditor and debtor details, IBAN, amount, and reference, and the module returns the same document with the payment slip attached. Every Swiss bank accepts the output for payment initiation via mobile banking app.

Authenticating Your API Request

Every PDF4me module in Make requires a valid Connection. Create or select one that holds your PDF4me API key so the scenario can authenticate Swiss QR bill generation securely.

Get your API Key

Important Facts You Should Not Miss

Appends a payment slip to your existing PDF and does not create a standalone image

Unlike Create Barcode, which returns a Base64 image, this module modifies your source document by appending the full Swiss QR bill section with a QR code and human-readable payment fields directly to the PDF. Your invoice template goes in, and a ready-to-send Swiss invoice with payment slip comes out.

Address Type S and K require different fields

Both the Creditor and Ultimate Debtor have an Address Type field: S (Structured) or K (Combined). With S, fill separate PostalCode and City fields. With K, use the two AddressLine fields to write the full address as free text. The type you choose determines which address fields are validated, so fill only the fields that match your chosen type.

IBAN must be Swiss or Liechtenstein and currency is CHF or EUR only

The module hint states the IBAN must start with CH or LI, with a maximum of 21 characters. Currency is strictly limited to CHF or EUR. For European SEPA payments with non-Swiss IBANs, use Generate EPC QR Code for SEPA instead.

Required fields include Currency, Reference Type, Language Type, Seperator Line, Amount, IBAN, Creditor Address Type, and Ultimate Debtor AddressType. Creditor and Debtor detail fields fill the payment slip.

Parameters

Required: Connection, File (File Name + Document when using Map), Currency, Reference Type, Language Type, Seperator Line, Amount, IBAN, Creditor Address Type, and Ultimate Debtor AddressType. All other fields are optional but recommended for a complete payment slip.

Parameter	Required	What it does	Example
Connection	Yes	PDF4me API connection. Click Add and paste your API key if connecting for the first time.	Your PDF4me connection
File	Yes	Source PDF to append the QR bill to. Choose Dropbox - Download a File or Map to supply from a prior module.	Map
File Name	Yes (Map)	Filename of the source PDF including .pdf extension. Hint: "You can specify file name."	1. File Name
Document	Yes (Map)	Binary content of the source PDF. Hint: "PDF file where Swiss QR Bill should be added."	1. Data
Page Number	No	The page of the PDF where the QR bill section is added. Hint: "The page where SwissQR Bill is to be added."	3
Currency	Yes	Payment currency. Hint: "Only CHF and EUR are permitted."	CHF
Reference Type	Yes	Format of the payment reference. Options: QRR (QR Reference, 27-digit numeric), SCOR (ISO 11649 creditor reference), NON (no reference). Hint: "Type of Reference."	QRR
Language Type	Yes	Language for the QR bill text. Options: German, French, Italian, English. Hint: "Choose the language type."	German
Seperator Line	Yes	Separator line style displayed in the QR bill section. Hint: "Separator line type to be displayed in SwissQR Code." Note: field name uses "Seperator" spelling as shown in module.	Only Line
Amount	Yes	Payment amount in two decimal places without leading zeroes. Hint: "entered without leading zeroes, including decimal separators and two decimal places."	1250.00
IBAN	Yes	Swiss or Liechtenstein IBAN or QR-IBAN of the creditor. Hint: "Max 21 characters with CH or LI only."	CH4431999123000889012
Creditor Address Type	Yes	Address format for the creditor: S (Structured, separate PostalCode and City fields) or K (Combined, two free-text AddressLine fields).	S
Creditor Name	No	Creditor's company or personal name as it appears on the bank account. Hint: "The creditor's name or company according to the account name."	Acme Corporation AG
Creditor AddressLine1	No	Creditor's primary address line. Max 70 characters.	Bahnhofstrasse 1
Creditor AddressLine2	No	Creditor's secondary address line. Max 16 characters for type S, 70 for type K.	Building A
Creditor PostalCode	No	Creditor's postal code. Max 16 characters.	8001
Creditor City	No	Creditor's town or city. Max 35 characters.	Zürich
Ultimate Debtor AddressType	Yes	Address format for the debtor: S (Structured) or K (Combined). Same rules as Creditor Address Type.	S
Ultimate Debtor Name	No	Debtor's company or personal name. Hint: "The Ultimate Debtor's name or company according to the account name."	Max Mustermann GmbH
Ultimate Debtor AddressLine1	No	Debtor's primary address line. Max 70 characters.	Musterstrasse 10
Ultimate Debtor AddressLine2	No	Debtor's secondary address line. Max 16 characters (S) or 70 characters (K).	Apt 5
Ultimate Debtor PostalCode	No	Debtor's postal code. Max 16 characters.	3000
Ultimate Debtor City	No	Debtor's town or city. Max 35 characters.	Bern
Reference	No	Payment reference number. Max 27 characters. Format depends on Reference Type. Hint: "Reference, Maximum 27 characters permitted."	210000000003139471430009017
Unstructured Message	No	Free-text payment description shown on the bill. Max 140 characters.	Invoice #2024-001 - Monthly Services
Billing Info	No	Additional billing information. Max 140 characters.	Contract: ABC-123
AV1 Parameters	No	Alternative scheme parameter 1. Max 100 characters.	/S1/10/10201409/11/180512/20/1400.00
AV2 Parameters	No	Alternative scheme parameter 2. Max 100 characters.	Name AV1: UV.UltraPay005;12345

Quick Setup

1. Add PDF4me to Create SwissQR Bill in your Make scenario.
2. Select Connection (or click Add to create one with your API key).
3. Set File to Dropbox - Download a File or Map. If using Map, connect File Name and Document from the prior step.
4. Fill the required payment fields: Currency (CHF or EUR), Reference Type, Language Type, Seperator Line, Amount, IBAN, Creditor Address Type, and Ultimate Debtor AddressType.
5. Add creditor and debtor details in the remaining fields, then Save and run. The output Doc Data contains the source PDF with the Swiss QR bill section appended.

Workflow Examples

Workflow ExamplesCommon Make scenario patterns using Create SwissQR Bill.

Automate Swiss invoice generation from a Google Sheet

1. A new row added to a Google Sheets invoice register triggers the scenario.
2. Google Drive downloads the blank invoice PDF template.
3. Create SwissQR Bill maps all payment fields, including Amount, IBAN, Reference, and Creditor and Debtor details, directly from the sheet columns.
4. Gmail sends the completed invoice with the Swiss QR bill attached to the customer's email address from the sheet.

Monthly subscription billing for Swiss customers

1. A scheduled trigger runs on the 1st of each month.
2. Airtable returns all active subscription records.
3. An Iterator processes each subscriber individually. Create SwissQR Bill generates a personalized invoice with the subscription amount, the customer's details mapped as the Ultimate Debtor, and a unique Reference per record.
4. Gmail sends each customer their invoice. Airtable is updated with the sent timestamp.

Accounts receivable: attach QR bill on ERP approval

1. A webhook fires when an invoice is approved in the ERP system.
2. HTTP downloads the approved invoice PDF.
3. Create SwissQR Bill appends the payment slip using the ERP-supplied IBAN, amount, and reference number.
4. The completed invoice is uploaded to the SharePoint accounts receivable folder and the accounting team is notified via Microsoft Teams.

Frequently Asked Questions

What does this module actually add to my PDF?+

It appends the complete Swiss QR bill payment slip section to your existing PDF. This is a standardized block containing the QR code with all encoded payment data, plus the human-readable payment fields (amount, IBAN, reference, creditor details). The output is a ready-to-send invoice accepted by Swiss banks for payment via mobile banking app.

What is the difference between Address Type S and K?+

S (Structured) means you fill separate PostalCode and City fields alongside AddressLine1 for the street. K (Combined) means you write the complete address across two free-text AddressLine fields with no separate city or postal code. Choose whichever matches how your data is structured, since both are valid under Swiss Payment Standards.

What Reference Type should I use?+

QRR (QR Reference) is the most common and uses a 27-character numeric string with a check digit for automated bank reconciliation in Switzerland. SCOR follows the international ISO 11649 creditor reference format. NON means no reference is included. Check with your bank which format your account supports for incoming payment matching.

Why is the IBAN restricted to CH or LI?+

Swiss QR bills are a payment standard specific to Switzerland and Liechtenstein. The module hint confirms: "Max 21 characters with CH or LI only." For SEPA payments across the EU and EEA using other country IBANs, use the Generate EPC QR Code for SEPA module instead.

What does the module return?+

Name (the output filename) and Doc Data (the binary PDF buffer of your source document with the Swiss QR bill section appended). Route Doc Data into Gmail as an attachment, upload it to Dropbox or Google Drive, or POST it to your ERP system.

Related Modules

Generate EPC QR Code for SEPA

Generate a SEPA payment QR code for European invoices. This is the equivalent payment standard for EU and EEA banking outside Switzerland.

Create ZUGFeRD Invoice

Generate a hybrid XML+PDF invoice for German electronic invoicing. This is another structured payment document standard for European billing.

Create Barcode

Generate a standalone barcode or QR code image as Base64 for embedding barcodes in emails or databases without modifying an existing PDF.

Get Help

Make IntegrationGet your API KeyMake Documentation