Skip to main content
PDF4me APIIntegrationsKnowledge BaseExtensionsAPI TesterBlog

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.

Related Blog Posts(2)

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.

Parameters​

The module exposes 26 fields grouped into four logical blocks: connection + source file, payment essentials, creditor block, debtor block, and payment reference. The screenshots below mirror the exact field order in the Make UI.

Required (red asterisk in the UI): Connection, Format Type, Paging Options, Currency, Reference Type, Language, Separator Line, Amount, IBAN, Creditor Address Type, Creditor Name, Ultimate Debtor AddressType. Conditional: File Name + Document when File is set to Map; Page Number only when Paging Options is set to Custom (page number). Optional: all remaining creditor / debtor address fields plus Reference, Unstructured Message, Billing Info, and AV1/AV2 Parameters.

Make Create SwissQR Bill module: Block 1: Connection, Format Type, File source, Paging Options, Currency
Block 1: Connection, Format Type, File source, Paging Options, Currency
Make Create SwissQR Bill module: Block 2: Reference Type, Language, Separator Line, Amount, IBAN
Block 2: Reference Type, Language, Separator Line, Amount, IBAN
Make Create SwissQR Bill module: Block 3: Creditor Address Type, Name, AddressLine1 and 2, PostalCode
Block 3: Creditor Address Type, Name, AddressLine1 and 2, PostalCode
Make Create SwissQR Bill module: Block 4: Creditor City, Ultimate Debtor AddressType, Name, AddressLine1 and 2
Block 4: Creditor City, Ultimate Debtor AddressType, Name, AddressLine1 and 2
Make Create SwissQR Bill module: Block 5: Ultimate Debtor PostalCode and City, Reference, Unstructured Message, Billing Info, AV1 Parameters
Block 5: Ultimate Debtor PostalCode and City, Reference, Unstructured Message, Billing Info, AV1 Parameters
ParameterRequiredWhat it doesExample
ConnectionYesPDF4me connection. Click Add and paste your API key the first time, then reuse the connection across every PDF4me module.test prod account
Format TypeYesOutput container format. PDF for printable invoices and email attachments; PNG, JPEG, or TIFF for image output (no Paging Options applies in image modes). Empty falls back to the connector default. See the dropdown reference card below.PDF
FileConditionalHow the source PDF arrives. Radio: Dropbox - Download a File (or any other storage module), PDF4me Dev - Create Swiss QR Bill (chain from a prior PDF4me action), or Map (bind File Name and Document from a prior module manually). Skip the source file entirely for a standalone payment slip.Map
File NameConditionalFilename of the source PDF including .pdf extension. Required when File is set to Map. Mapped from the prior module File Name output.1. File Name
DocumentConditionalBinary content of the source PDF. Required when File is set to Map. Mapped from the prior module Data / binary output.1. Data
Paging OptionsYesWhere the Swiss QR-bill page is inserted (PDF Format Type only). Options: Empty (default), First (new page 1), Last (appended), Add page at the end (alias for Last), Custom (page number) (insert at the page number you supply in the Page Number field). See the dropdown reference card below.Custom (page number)
Page NumberConditionalThe 1-based page number where the Swiss QR-bill is inserted. Required when Paging Options is Custom (page number); ignored for every other Paging Options value. Page indexing starts at 1.3
CurrencyYesPayment currency. Only CHF and EUR are permitted by the Swiss Payment Standards.CHF
Reference TypeYesFormat of the payment reference. QRR (Swiss QR Reference, 27-digit numeric, used with QR-IBAN), SCOR (ISO 11649 creditor reference), NON (no reference).QRR
LanguageYesLanguage for the printed QR-bill text (Payment part labels: Account / Payable to, Reference, Currency, Amount). German, French, Italian, English.English
Separator LineYesSeparator line style displayed in the QR-bill section. Line With Scissor (line + scissor pictogram, standard print), Only Line (line, no pictogram), or No Line (eBill / e-invoice). Note: the Make UI labels the field "Seperator Line" (the engine accepts either spelling.Line With Scissor
AmountYesPayment amount in two decimal places without leading zeroes. Use the locale decimal separator your Culture & Language Settings expect.35345436
IBANYesIBAN or QR-IBAN of the creditor. Maximum 21 characters with CH or LI country codes only. QR-IBAN required when Reference Type is QRR.CH4431999123000889012
Creditor Address TypeYesAddress format for the creditor: S (Structured, separate PostalCode and City fields) or K (Combined, two free-text AddressLine fields).S
Creditor NameYesCreditor name or company according to the bank account. Maximum 70 characters.Var Schneider AG
Creditor AddressLine1NoCreditor primary address line. Maximum 70 characters.Var Schneider AG
Creditor AddressLine2NoCreditor secondary address line. 16 characters when address type is S; 70 characters when type is K.23
Creditor PostalCodeNoCreditor postal code. Maximum 16 characters.2501
Creditor CityNoCreditor town or city. Maximum 35 characters.biel
Ultimate Debtor AddressTypeYesAddress format for the debtor: S (Structured) or K (Combined). Same rules as Creditor Address Type.S
Ultimate Debtor NameNoDebtor name or company according to the bank account. Maximum 70 characters.Pia-Maria Rutschmann-Schnyder
Ultimate Debtor AddressLine1NoDebtor primary address line. Maximum 70 characters.Grosse Marktgasse
Ultimate Debtor AddressLine2NoDebtor secondary address line. 16 characters (S) or 70 characters (K).32
Ultimate Debtor PostalCodeNoDebtor postal code. Maximum 16 characters.9400
Ultimate Debtor CityNoDebtor town or city. Maximum 35 characters.Rorschach
ReferenceNoPayment reference number. Maximum 27 characters. Format depends on Reference Type (QRR: 27-digit numeric with mod-10 check; SCOR: ISO 11649; NON: leave empty).210000000003139471430009017
Unstructured MessageNoFree-text payment description shown in the Additional information block. Maximum 140 characters.Instruction of 15.09.2019
Billing InfoNoStructured billing information (Swico, etc) shown alongside the Unstructured Message. Maximum 140 characters.S1/01/20170309/11/10201409/20/14000000/22/36958/30/CH106017086/40/1020/41/3010
AV1 ParametersNoAlternative scheme parameter 1 (e.g. eBill identifier). Maximum 100 characters. Convention: "Name AV1: UV;…".Name AV1: UV;UltraPay005;12345
AV2 ParametersNoAlternative scheme parameter 2. Maximum 100 characters. Same convention as AV1 when a second alternative scheme is required.Name AV2: XY;Service002;67890

Format Type options​

The Make UI exposes 5 values. Choose PDF for printable invoices and email attachments; the image formats are useful when you embed the QR slip into a templated PDF later or render it inline in an email body.

PDF
Standard. Hybrid PDF/A-compatible page appended to the source invoice. Use with the Paging Options field below to choose where the slip lands.
PNG
Raster image of the QR-bill slip alone. Useful for inline email images or web previews.
JPEG
Compressed raster output. Slightly smaller than PNG; the QR code stays scannable.
TIFF
Lossless raster archive format. Best when the recipient needs print-grade quality.
Empty
No value set; the connector falls back to its default (PDF).

Paging Options reference​

Applies only when Format Type is PDF. The image Format Types (PNG, JPEG, TIFF) ignore Paging Options because there is no multi-page document to insert into.

First
Insert the QR-bill as the new page 1 of the output. The original first page becomes page 2.
Last
Insert the QR-bill at the end, after the original last page.
Add page at the end
Functional alias for Last. Picks whichever phrasing matches your downstream documentation.
Custom (page number)
Insert the QR-bill at a specific 1-based page index. Requires the Page Number field to be filled with the desired index (e.g. 3 inserts the slip as the new page 3).
Empty
No value set; the connector falls back to its default (First).

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 Format Type to PDF (or PNG / JPEG / TIFF for image output). Set Paging Options to First, Last, Add page at the end, or Custom (page number). If you pick Custom (page number), also fill Page Number with the 1-based index where the slip should land (e.g. 3).
  4. Set File to a storage module like Dropbox - Download a File, or pick Map and bind File Name and Document from the prior step. Skip the File group entirely for a standalone QR slip.
  5. Fill the required payment fields with values from the screenshots above: Currency (CHF or EUR), Reference Type (QRR), Language (English), Separator Line (Line With Scissor), Amount, IBAN (max 21 chars, CH or LI), Creditor Address Type (S or K), Creditor Name, and Ultimate Debtor AddressType.
  6. Add creditor and debtor address fields, then optionally fill Reference, Unstructured Message, Billing Info, and AV1 / AV2 Parameters for richer payment data.
  7. Save and run. The module output Doc Data contains the source PDF with the Swiss QR-bill page inserted at the position chosen in step 3 (or a standalone QR slip when no source file was supplied).

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.

Get Help​

Make IntegrationGet your API KeyMake Documentation