EPC SEPA payment QR code generator
Make an EPC QR code (also known as GiroCode) that banking apps scan to fill in a SEPA euro transfer.
Use it from code or an agent
curl -s https://setget.net/v1/tools/qr-epc \
-H 'Content-Type: application/json' \
-d '{"input":{"name":"Red Cross Germany","iban":"DE89 3704 0044 0532 0130 00","amount":25,"remittance":"Donation"}}'
import json, urllib.request
body = {'input': {'name': 'Red Cross Germany', 'iban': 'DE89 3704 0044 0532 0130 00', 'amount': 25, 'remittance': 'Donation'}}
request = urllib.request.Request("https://setget.net/v1/tools/qr-epc", json.dumps(body).encode(),
{"Content-Type": "application/json"})
print(json.load(urllib.request.urlopen(request))["result"])
const response = await fetch("https://setget.net/v1/tools/qr-epc", {
method: "POST",
headers: {"Content-Type": "application/json"},
body: JSON.stringify({"input":{"name":"Red Cross Germany","iban":"DE89 3704 0044 0532 0130 00","amount":25,"remittance":"Donation"}}),
});
console.log((await response.json()).result);
Tool: run_tool
Arguments:
{
"slug": "qr-epc",
"input": {
"name": "Red Cross Germany",
"iban": "DE89 3704 0044 0532 0130 00",
"amount": 25,
"remittance": "Donation"
}
}
{
"input": {
"name": "Red Cross Germany",
"iban": "DE89 3704 0044 0532 0130 00",
"amount": 25,
"remittance": "Donation"
}
}
Endpoint: POST /v1/tools/qr-epc. Over MCP: run_tool with slug: "qr-epc".
Machine-readable: input schema, Markdown. Connect an agent.
Inputs
| Name | Type | Required | What it does |
|---|---|---|---|
name |
string | yes | Who is being paid: the account holder name, at most 70 characters. |
iban |
string | yes | The IBAN of the account to pay into. |
amount |
number | no | The amount in euro. Leave out to let the payer enter it. From 0.01 to 999999999.99. |
bic |
string | no | The BIC of the bank. Optional within the SEPA area. |
purpose |
string | no | A four-letter purpose code, such as CHAR for charity. |
reference |
string | no | A structured creditor reference (starting RF) from the invoice. |
remittance |
string | no | Free text the payee sees, such as an invoice number. Use this or reference. |
information |
string | no | A note shown to the payer, at most 70 characters. |
error_correction |
string | no | How much damage the code survives: L about 7%, M 15%, Q 25%, H 30%. Higher levels hold less. Left out: M, or H when there is a logo. One of: L, M, Q, H. |
module_size |
integer | no | Width of one small square (module) in pixels. Default: 8. From 1 to 40. |
margin |
integer | no | Blank quiet zone around the code, in modules. Scanners expect at least 4. Default: 4. From 0 to 20. |
foreground |
string | no | Color of the dots: hex such as #000000, a basic color name, or a CSS linear-gradient(...) or radial-gradient(...). Left out: black. |
background |
string | no | Color behind the code: hex, a basic name, "transparent", or a CSS gradient. Left out: white. |
preset |
string | no | A ready-made look. Any style input you set yourself wins over the preset. One of: classic, rounded, liquid, dots, ocean, sunset, forest, grape, candy, ink, gold, midnight. |
dot_style |
string | no | Shape of the small squares (modules). Left out: square. One of: square, rounded, liquid, dots, diamond, star, vertical, horizontal, leaf, mosaic, plus, hexagon, heart, maze. |
dot_scale |
number | no | Size of each dot within its square, from 0.5 to 1. Thin shapes need more, such as diamond 0.7 and star 0.95 (the error names the least); liquid always fills its square. From 0.5 to 1. |
eye_frame_style |
string | no | Shape of the outer ring of the three corner eyes. One of: square, rounded, extra-rounded, circle, leaf, dotted. |
eye_ball_style |
string | no | Shape of the solid middle of the three corner eyes. One of: square, rounded, circle, diamond, leaf, octagon. |
eye_colour |
string | no | Color of the eye rings. Left out: the dot color. |
eye_ball_colour |
string | no | Color of the middle of the eyes. Left out: the eye ring color. |
eye_colours |
string | no | A color for each eye, separated by commas, in the order top-left, top-right, bottom-left: for instance "#b91c1c, #1d4ed8, #15803d". Plain colors only. An eye left out, or left empty between commas, keeps eye_colour. |
corner_radius |
number | no | Rounds the corners of the background, as a fraction of its side. From 0 to 0.5. |
shape |
string | no | Outline of the whole code: square, or a silhouette such as circle or heart. The code itself stays a complete square inside it, behind a clear ring as wide as margin, and matching dots fill the rest of the outline. Left out: square. One of: square, circle, squircle, octagon, hexagon, shield, bubble, heart. |
logo |
string | no | A picture for the middle of the code, as a data: URI (PNG, JPEG, WebP, GIF or SVG, up to about 290 KB). |
logo_size |
number | no | Largest logo width as a fraction of the code, from 0.1 to 0.4. It is made smaller when the code would not scan. Left out: 0.22. From 0.1 to 0.4. |
logo_padding |
number | no | Clear space around the logo, in modules. Left out: 1. From 0 to 3. |
logo_shape |
string | no | Shape of the clear area behind the logo. "none" leaves the background showing. One of: none, square, rounded, circle. |
logo_background |
string | no | Color of the clear area behind the logo. Left out: the background color. |
logo_text |
string | no | One to four characters for the middle of the code in place of a picture, such as initials. Drawn as outlines in the frame font, so they look the same everywhere. |
logo_icon |
string | no | A small symbol for the middle of the code in place of a picture. One of: heart, star, wifi, phone, mail, link, home, pin, cart, bag, camera, music, calendar, person, globe, lock, gift, cup, bolt, chat, play, info, tag, book. |
logo_colour |
string | no | Color of the center text or symbol. Left out: the eye color. |
background_image |
string | no | A photo shown behind the code, as a data: URI (up to about 440 KB). The dots are drawn over it so the code still scans. |
background_image_wash |
number | no | How much the photo is lightened, from 0 to 0.9. Left out: 0.35. From 0 to 0.9. |
frame |
string | no | A border with a short call to action under (or above) the code. One of: none, label, banner, banner-top, rounded. |
frame_text |
string | no | The words in the frame. Left out: SCAN ME. |
frame_colour |
string | no | Color of the frame. Left out: the dot color. |
frame_text_colour |
string | no | Color of the frame text. Left out: whichever of dark or light reads best. |
frame_font |
string | no | Letter style of the frame text. One of: sans, mono. |
Example
Input
{
"name": "Red Cross Germany",
"iban": "DE89 3704 0044 0532 0130 00",
"amount": 25,
"remittance": "Donation"
}Result
Different every time. Press the example button above to see one.
Questions
- Which apps can pay with it?
- Most banking apps in Germany, Austria, the Netherlands, Belgium, Finland and other SEPA countries scan EPC codes and fill in the transfer. The payer always confirms it.
- Is it safe?
- The code only fills in a form. Nothing is paid until the payer checks the details and confirms in their own bank app. Check the IBAN on printed invoices.
- Can I style it?
- Colors and shapes work, but keep strong contrast and no logo: banking apps are fussier than phone cameras. The classic look is the safest.
Related tools
- QR code generator
Make a scannable QR code from any text or link, styled your way: colors, gradients, dot shapes, a logo and a frame.
qr-generate - Card number (Luhn) and IBAN validatorCheck a card number with the Luhn checksum and name its network, or check an IBAN by length and mod-97.
luhn-iban-validate - .gitignore generatorBuild a .gitignore for the languages, editors and operating systems you use, merged without duplicates.
gitignore-generate - Animated QR code
Make a QR code that draws itself: an animated SVG in any style that ends as a complete, scannable code.qr-animate - ASCII banner text generatorTurn short text into large five-line banner letters for terminals, READMEs, logs and code comments.
ascii-banner - ASCII table generatorRender headers and rows as a box-drawing or plain ASCII table for terminals, logs and code comments.
ascii-table