Skip to main content
PDF4me APIIntegrationsKnowledge BaseExtensionsAPI TesterBlog

Create Swiss QR Bill using n8n action

PDF4me Create Swiss QR Bill generates compliant Swiss QR bills with embedded payment QR codes through n8n automation workflows. Process PDF invoices via n8n triggers, binary data, base64 strings, or public URLs to create standardized Swiss QR bills with creditor/debtor information, IBAN details, payment amounts, reference numbers, and customizable language options (English, German, French, Italian). This solution ensures full compliance with Swiss payment standards and is ideal for automated invoicing, payment processing, financial reconciliation, accounting system integration, and regulatory compliance workflows that require reliable Swiss QR bill generation.

Setup​

Add the PDF4me "Create Swiss QR Bill" node to your n8n workflow and configure the required parameters. For initial setup instructions, see our n8n Integration Guide.

Prerequisites:

  • PDF4me API credentials
  • n8n workflow access
Get Your API Key

Configuration:

  1. Add PDF4me node to workflow
  2. Select "Create Swiss QR Bill" action
  3. Configure input parameters (see below)
Create Swiss QR Bill

Parameters​

Complete list of parameters for the Create Swiss QR Bill action. Configure these parameters to generate compliant Swiss QR bills.

Important: Parameters marked with an asterisk (***) are required and must be provided for the action to function correctly.

ParameterTypeDescriptionExample
Input Data Type***StringPDF Input Format Selection
• Choose the format of your input data (PDF document)
• PDF4me supports multiple input types for Swiss QR bill creation
• Options: Binary Data, Base64 String, or URL		Binary Data
Binary PropertyStringBinary Input Property (Required if Binary Data)
• Reference the input file property from a previous n8n node
• PDF4me processes binary files with automatic format detection
• Required when Input Data Type is "Binary Data"		data
Base64 Document ContentStringBase64 Encoded Input (Required if Base64 String)
• Provide input data as a base64 encoded string
• PDF4me automatically decodes and processes the content
• Required when Input Data Type is "Base64 String"		UEsDBBQABgAI...
File URLStringPublic Input URL (Required if URL)
• Provide a public/open permission URL to the input file
• PDF4me downloads and processes the file from URL
• Required when Input Data Type is "URL"		https://abc.com/xyz.pdf
File Name***StringInput Filename
• Specify the name of the input PDF file
• PDF4me uses this for file identification and processing
• Essential for proper file handling and error tracking		document.pdf
Amount***NumberPayment Amount
• Set the payment amount for the Swiss QR bill in Swiss Francs
• Amount displayed on QR bill and embedded in QR code
• Must be positive number with up to 2 decimal places		1000
Currency***StringCurrency Selection
• Choose the currency for the Swiss QR bill
• Options: Swiss Franc (CHF), Euro (EUR)
• Swiss Franc is standard for Swiss payment processing		Swiss Franc
IBAN***StringCreditor IBAN
• Enter the creditor's International Bank Account Number
• Must be valid Swiss IBAN format (CH followed by 19 digits)
• Essential for payment processing and compliance		CH0200700110003765824
Creditor Name***StringCreditor Company Name
• Enter the name of the creditor company or individual
• Appears on the generated QR bill
• Must match the IBAN account holder		Test AG
Creditor Address Type***StringCreditor Address Format
• Choose the address format for creditor information
• Options: Structured (recommended), Combined
• Structured format provides better QR code compatibility		Structured
Creditor Address Line 1***StringCreditor Street Address
• Enter the street name and number for creditor's address
• Appears on the Swiss QR bill
• Must be accurate for payment processing		Test Strasse
Creditor Address Line 2StringCreditor Additional Address
• Enter additional address information (floor, apartment, building)
• Optional field for more detailed address information		1
Creditor Postal Code***StringCreditor Postal Code
• Enter the postal code for creditor's address
• Must be valid Swiss postal code format (4 digits)
• Essential for Swiss QR bill compliance		8000
Creditor City***StringCreditor City
• Enter the city name for creditor's address
• Must be a valid Swiss city name
• Essential for Swiss QR bill compliance		Zurich
Ultimate Debtor Name***StringDebtor Company Name
• Enter the name of the ultimate debtor company or individual
• Represents who will pay the bill		Test Debt AG
Ultimate Debtor Address Type***StringDebtor Address Format
• Choose the address format for debtor information
• Options: Structured (recommended), Combined
• Structured format provides better QR code compatibility		Structured
Ultimate Debtor Address Line 1***StringDebtor Street Address
• Enter the street name and number for debtor's address
• Appears on the Swiss QR bill
• Must be accurate for payment processing		Test Deb Strasse
Ultimate Debtor Address Line 2StringDebtor Additional Address
• Enter additional address information (floor, apartment, building)
• Optional field for more detailed address information		2
Ultimate Debtor Postal Code***StringDebtor Postal Code
• Enter the postal code for debtor's address
• Must be valid Swiss postal code format (4 digits)
• Essential for Swiss QR bill compliance		8000
Ultimate Debtor City***StringDebtor City
• Enter the city name for debtor's address
• Must be a valid Swiss city name
• Essential for Swiss QR bill compliance		Zurich
Reference Type***StringReference Type Selection
• Choose the type of reference for the Swiss QR bill
• Options: No Reference, QR Reference, Creditor Reference
• Determines payment reference handling		No Reference
Language Type***StringLanguage Selection
• Choose the language for Swiss QR bill text and labels
• Options: English, German, French, Italian
• Affects display language of generated QR bill		English
Separator Line***StringSeparator Line Style
• Choose the style of separator line
• Options: Line With Scissor, Simple Line, No Line
• Affects visual appearance and compliance		Line With Scissor
Output File Name***StringOutput Filename
• Specify the name for the generated Swiss QR bill PDF
• Must include .pdf extension
• PDF4me ensures unique naming and format validation		swissqr_bill.pdf
Output Binary Field Name***StringOutput Binary Field
• Specify the name for the binary data field
• Contains the PDF data for subsequent workflow steps
• Essential for workflow data flow		data

Advanced Options​

The following parameters are available in the Advanced Options section and are optional:

ParameterTypeDescriptionExample
ReferenceStringPayment Reference
• Enter a custom payment reference number
• Embedded in QR code for payment tracking and reconciliation
• Must be valid reference format per Swiss payment standards
• Optional for advanced payment tracking		210000000003139471430009017
Unstructured MessageStringUnstructured Message
• Enter additional information or message for the QR bill
• Can contain payment purpose, invoice details, or other information
• Appears on the QR bill
• Optional field		for individuals
Billing InfoStringBilling Information
• Enter structured billing information in Swiss QR bill format
• Contains detailed payment information in standardized format
• Includes creditor details, amount, and reference data
• Optional for advanced billing		S1/01/20200109/33/123455/99/0/123258/30/CH2345677/40/1020/41/300
AV1 ParameterStringAV1 Parameter
• Enter additional parameter 1 for the Swiss QR bill
• Contains supplementary information or configuration
• For advanced Swiss QR bill processing
• Optional field		additional_param_1
AV2 ParameterStringAV2 Parameter
• Enter additional parameter 2 for the Swiss QR bill
• Contains supplementary information or configuration
• For advanced Swiss QR bill processing
• Optional field		additional_param_2
Custom ProfilesStringCustom Configuration Profiles
• Set additional options using custom profiles
• JSON-like format containing predefined parameters
• Enables advanced Swiss QR bill creation settings
• Optional for specialized requirements		{ "outputDataFormat": "pdf", "validateSwissStandards": true }

Output​

Output Parameters​

ParameterTypeDescriptionExample
fileNameStringPDF4me Swiss QR bill filename - The complete filename of the successfully generated Swiss QR bill PDF file with proper .pdf extension. PDF4me ensures unique naming and validates file format compliance for seamless integration with downstream processesswissqr_bill.pdf
mimeTypeStringPDF4me PDF MIME type - The MIME type of the generated Swiss QR bill PDF file, indicating the file format for proper handling in web applications and file systemsapplication/pdf
fileSizeNumberPDF4me PDF file size in bytes - The exact size of the generated Swiss QR bill PDF file in bytes, provided by PDF4me for storage planning, bandwidth optimization, and file transfer monitoring. Essential for enterprise document management and workflow automation245760
successBooleanPDF4me Swiss QR bill generation status indicator - Boolean flag indicating the success or failure of the Swiss QR bill creation process. PDF4me returns true for successful generation and false for any errors, enabling robust error handling in automated workflowstrue
messageStringPDF4me processing status message - Human-readable status message providing details about the Swiss QR bill creation process result. Includes success confirmation or error details for troubleshootingSwiss QR bill created successfully

N8N Action Response​

The PDF4me Create Swiss QR Bill API returns a response that can be viewed in multiple formats. Choose the view that best fits your needs:

JSON Response Format

The raw JSON response from the API:

{
  "fileName": "swissqr_bill.pdf",
  "mimeType": "application/pdf",
  "fileSize": 245760,
  "success": true,
  "message": "Swiss QR bill created successfully"
}

Use Cases​

Swiss Banking and Financial Services​

  • Automatically generate Swiss QR bills for invoice payments, utility bills, and service charges that comply with Swiss banking standards and enable instant payment processing through mobile banking apps
  • Process recurring payments and subscription services by creating standardized Swiss QR bills that integrate with Swiss banking systems and automated payment processing workflows
  • Generate payment requests for Swiss businesses and service providers that ensure compliance with Swiss financial regulations and provide seamless payment experiences for customers

Swiss Business and Invoice Management​

  • Create professional invoices and payment documents for Swiss companies that meet Swiss QR bill standards and integrate with Swiss accounting software and tax reporting systems
  • Process international transactions and cross-border payments by generating Swiss QR bills that facilitate payments from Swiss customers and comply with Swiss financial regulations
  • Generate payment documents for Swiss government services, healthcare providers, and educational institutions that enable digital payment processing and reduce administrative overhead

Swiss E-commerce and Digital Payments​

  • Integrate Swiss QR bill generation into e-commerce platforms and online stores to provide Swiss customers with familiar and secure payment options that work seamlessly with Swiss banking apps
  • Process subscription services and recurring billing for Swiss customers by generating automated Swiss QR bills that enable convenient payment processing and reduce payment friction
  • Create digital payment solutions for Swiss marketplaces and service platforms that leverage Swiss QR bill technology for secure, standardized payment processing across different Swiss financial institutions

Get Help​

n8n Integration Guiden8n SampleGetting Started