Skip to main content
PDF4me APIIntegrationsKnowledge BaseExtensionsAPI TesterBlog

Read Swiss QR Code using n8n action

PDF4me Read Swiss QR Code extracts and parses payment data from Swiss QR codes embedded in PDF documents through n8n automation workflows. Process PDFs via n8n triggers, binary data, base64 strings, or public URLs to automatically decode Swiss QR bills and retrieve structured payment information including creditor/debtor details, IBAN, payment amounts, currency, reference numbers, and billing information with full compliance to Swiss payment standards. This solution is ideal for automated payment processing, invoice reconciliation, accounting system integration, financial workflows, and regulatory compliance that require accurate Swiss QR code data extraction.

Setup​

Add the PDF4me "Read Swiss QR Code" 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 "Read Swiss QR Code" action
  3. Configure input parameters (see below)
Read Swiss QR Code

Parameters​

Complete list of parameters for the Read Swiss QR Code action. Configure these parameters to extract Swiss QR code data.

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

ParameterTypeDescriptionExample
Input Data Type***StringQR Code Input Format Selection
• Choose the format of your QR code data input
• PDF4me supports multiple input types for Swiss QR code processing
• Options: Binary Data, Base64 String, or URL		Binary Data
Input Binary FieldBinaryBinary QR Code Image Input (Required if Binary Data)
• Reference QR code image file from previous n8n node or upload
• PDF4me processes binary images with automatic QR code recognition
• Required when Input Data Type is "Binary Data"		{{ $binary.data }}
Base64 Document ContentStringBase64 Encoded QR Code Input (Required if Base64 String)
• Provide QR code image data as base64 encoded string
• PDF4me automatically decodes and processes the QR code content
• Required when Input Data Type is "Base64 String"		UEsDBBQABgAI...
File URLStringPublic QR Code URL Input (Required if URL)
• Provide a public/open permission URL to the QR code image file
• PDF4me downloads and processes the file from URL
• Required when Input Data Type is "URL"		https://abc.com/qr.png
Output File Name***StringSwiss QR Data Output Filename
• Specify the name for the generated JSON file with extracted data
• Must include .json extension
• PDF4me ensures unique naming and format validation		swissqr_code_data.json
Async***BooleanAsynchronous Processing
• Enable asynchronous processing for Swiss QR code reading
• true = background processing for better performance
• false = synchronous processing for immediate results
• Ideal for high-volume operations		true

Advanced Options​

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

ParameterTypeDescriptionExample
Custom ProfilesStringCustom Configuration Profiles
• Set additional options using custom profiles
• JSON-like format containing predefined parameters
• Enables advanced Swiss QR code reading settings
• Optional for specialized requirements		{ "outputDataFormat": "json", "validateSwissStandards": true }

Output​

Output Parameters​

ParameterTypeDescriptionExample
fileNameStringPDF4me Swiss QR data filename - The complete filename of the successfully generated JSON file containing extracted Swiss QR code data with proper .json extension. PDF4me ensures unique naming and validates file format compliance for seamless integration with downstream processesswissqr_code_data.json
mimeTypeStringPDF4me JSON data MIME type - The MIME type of the generated JSON file containing Swiss QR code data, indicating the file format for proper handling in web applications and file systemsapplication/json
fileSizeNumberPDF4me JSON file size in bytes - The exact size of the generated JSON file in bytes, provided by PDF4me for storage planning, bandwidth optimization, and file transfer monitoring. Essential for enterprise document management and workflow automation1024
successBooleanPDF4me Swiss QR reading status indicator - Boolean flag indicating the success or failure of the Swiss QR code reading process. PDF4me returns true for successful reading and false for any errors, enabling robust error handling in automated workflowstrue
swissQrDataObjectPDF4me extracted Swiss QR data - Complete structured data extracted from the Swiss QR code including payment information, creditor details, and transaction data. Contains all relevant information according to Swiss QR code standards{"ucr_PostalCode": "", "ucr_City": "", "ucr_Country": null, "Amount": 30, "Currency": "CHF", "ud_AddressType": "S", "ud_Name": "Heinz Muster", "ud_StreetOrAddressLine1": "Tödistrasse", "ud_BuildNoOrAddressLine2": "1", "ud_PostalCode": "8000", "ud_City": "Zürich", "ud_Country": "Switzerland", "ReferenceType": "QRR", "Reference": "210000000003139471430009017", "UnstructuredMessage": "for individuals", "BillingInfo": "S1/01/20200109/33/123455/99/0/123258/30/CH2345677/40/1020/41/300", "av1_Parameters": "", "av2_Parameters": ""}

N8N Action Response​

The PDF4me Read Swiss QR Code 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_code_data.json",
  "mimeType": "application/json",
  "fileSize": 1024,
  "success": true,
  "swissQrData": {
    "ucr_PostalCode": "",
    "ucr_City": "",
    "ucr_Country": null,
    "Amount": 30,
    "Currency": "CHF",
    "ud_AddressType": "S",
    "ud_Name": "Heinz Muster",
    "ud_StreetOrAddressLine1": "Tödistrasse",
    "ud_BuildNoOrAddressLine2": "1",
    "ud_PostalCode": "8000",
    "ud_City": "Zürich",
    "ud_Country": "Switzerland",
    "ReferenceType": "QRR",
    "Reference": "210000000003139471430009017",
    "UnstructuredMessage": "for individuals",
    "BillingInfo": "S1/01/20200109/33/123455/99/0/123258/30/CH2345677/40/1020/41/300",
    "av1_Parameters": "",
    "av2_Parameters": ""
  }
}

Use Cases​

Swiss Payment Processing and Banking​

  • Automatically process Swiss QR bill payments by reading payment information from invoices, receipts, and payment documents to enable automated payment reconciliation and accounting integration
  • Extract payment details from Swiss QR codes embedded in invoices and bills to facilitate automated payment processing and reduce manual data entry in Swiss banking and financial systems
  • Process payment confirmations and transaction records by reading Swiss QR codes to verify payment amounts, recipient information, and transaction references for Swiss financial compliance

Swiss Business and Invoice Management​

  • Read Swiss QR codes from business invoices and payment documents to extract customer information, payment amounts, and transaction details for automated accounting and bookkeeping processes
  • Process Swiss government payments and official documents by reading Swiss QR codes to extract payment information and ensure compliance with Swiss financial regulations and tax reporting requirements
  • Extract payment data from Swiss QR codes in utility bills, service invoices, and subscription payments to enable automated payment processing and customer account management

Swiss E-commerce and Digital Transactions​

  • Process online payments and e-commerce transactions by reading Swiss QR codes from digital receipts and payment confirmations to enable automated order processing and customer service workflows
  • Extract payment information from Swiss QR codes in mobile payment apps and digital wallets to facilitate transaction verification and automated financial record keeping
  • Process subscription payments and recurring billing by reading Swiss QR codes to extract payment details and enable automated billing management for Swiss customers and businesses

Step-by-step guides to rename PDFs using Swiss QR code data:

Get Help​

n8n Integration GuideGet your API Keyn8n SampleGetting Started