Back to QR Generator

API Documentation

Generate EPC QR codes programmatically via URL parameters

Table of Contents

Overview

PaymeMay.be provides a simple URL-based API for generating payment QR codes that comply with the European Payments Council (EPC) standard. These QR codes are compatible with all major European banking apps and payment systems.

Banking App Required

Important: These QR codes must be scanned with a banking app, not a regular camera app. The EPC format is specifically designed for banking applications and will not work with standard QR code readers.

Quick Example

Generate a QR code for a €25.50 payment to John Doe:

https://paymemay.be/?name=John%20Doe&iban=DE89370400440532013000&amount=25.50&description=Pizza%20delivery

Parameters

Parameter Type Required Description Example
name String Required Recipient's full name (minimum 2 characters) John Doe
iban String Required Valid IBAN account number (15-34 characters) DE89370400440532013000
amount Number Required for images Payment amount in EUR (up to 2 decimal places) 25.50
description String Optional Payment description/reference (max 140 characters) Pizza delivery
format String Optional Response format: "image" for QR code only image
type String Optional Image delivery method: "blob" for redirect blob

Usage Modes

1. Form Pre-filling Mode

Opens the QR generator with fields pre-filled. Perfect for sharing payment links with users.

https://paymemay.be/?name=John%20Doe&iban=DE89370400440532013000&amount=25.50

2. Image Mode

Returns just the QR code image. Requires the amount parameter.

https://paymemay.be/?name=John%20Doe&iban=DE89370400440532013000&amount=25.50&format=image

3. Blob Redirect Mode

Redirects to a blob URL for true image file response. Best for programmatic usage.

https://paymemay.be/?name=John%20Doe&iban=DE89370400440532013000&amount=25.50&format=image&type=blob

Examples

Basic Payment Request

https://paymemay.be/?name=Coffee%20Shop&iban=DE89370400440532013000&amount=4.50&description=Cappuccino

E-commerce Order

https://paymemay.be/?name=Online%20Store&iban=FR1420041010050500013M02606&amount=299.99&description=Order%20%2312345&format=image

Invoice Payment

https://paymemay.be/?name=Company%20Ltd&iban=GB29NWBK60161331926819&amount=1250.00&description=Invoice%20INV-2024-001&format=image&type=blob

Integration Examples

<!-- Embed QR code as image -->
<img src="https://paymemay.be/?name=John%20Doe&iban=DE89370400440532013000&amount=25.50&format=image" 
     alt="Payment QR Code" 
     width="200" 
     height="200">

<!-- Link to payment form -->
<a href="https://paymemay.be/?name=John%20Doe&iban=DE89370400440532013000&amount=25.50">
    Pay John €25.50
</a>

Limitations

Web-Based Environments Only

This API is implemented using client-side JavaScript and only works in web-based environments such as:

  • Web Browsers: Chrome, Firefox, Safari, Edge, etc.
  • WebViews: Embedded browsers in mobile apps
  • Web Applications: Progressive Web Apps (PWAs)

Does NOT work in: Native mobile apps, server-side environments, or HTTP clients that don't execute JavaScript.

Need Native App Support?

If you need QR code generation for native mobile applications (iOS, Android, Flutter, etc.), please contact us for access to our API solution.

Email: [email protected]

Custom Branding

All generated QR codes include PaymeMay.be branding and payment details (recipient name, amount, description). If you need QR codes without branding or with custom branding for your business, please contact us for a tailored solution.

Email: [email protected]

Supported IBAN Countries

This API generates EPC QR codes compatible with SEPA payments across all European Union countries and associated territories, including but not limited to:

Austria (AT), Belgium (BE), Bulgaria (BG), Croatia (HR), Cyprus (CY), 
Czech Republic (CZ), Denmark (DK), Estonia (EE), Finland (FI), France (FR), 
Germany (DE), Greece (GR), Hungary (HU), Iceland (IS), Ireland (IE), 
Italy (IT), Latvia (LV), Liechtenstein (LI), Lithuania (LT), Luxembourg (LU), 
Malta (MT), Netherlands (NL), Norway (NO), Poland (PL), Portugal (PT), 
Romania (RO), Slovakia (SK), Slovenia (SI), Spain (ES), Sweden (SE), 
Switzerland (CH), United Kingdom (GB)

Support

Error Handling

The API provides user-friendly error messages for common issues:

Best Practices

Contact

For technical support, feature requests, or integration assistance: