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.

1 What it holds

Who is being paid: the account holder name, at most 70 characters.
The IBAN of the account to pay into.
The amount in euro. Leave out to let the payer enter it.
The BIC of the bank. Optional within the SEPA area.
A four-letter purpose code, such as CHAR for charity.
A structured creditor reference (starting RF) from the invoice.
Free text the payee sees, such as an invoice number. Use this or reference.
A note shown to the payer, at most 70 characters.

2 Pick a look

Ready-made looks
A starting point. Anything you change below is kept on top of it.

Surprise me draws a random look and keeps it only if it passes the scan checks. Its number brings the same look back.

My designs

    Nothing saved yet. Saved looks stay in this browser: nothing is uploaded, and the content of a code is never saved.

    Dots and corners
    Dot style
    Shape of the small squares (modules). Left out: square.
    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.
    Eye frame style
    Shape of the outer ring of the three corner eyes.
    Eye ball style
    Shape of the solid middle of the three corner eyes.
    Shape
    Shape
    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.
    Colors
    Color of the dots: hex such as #000000, a basic color name, or a CSS linear-gradient(...) or radial-gradient(...). Left out: black.
    Color behind the code: hex, a basic name, "transparent", or a CSS gradient. Left out: white.
    Color of the eye rings. Left out: the dot color.
    Color of the middle of the eyes. Left out: the eye ring color.
    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.
    Rounds the corners of the background, as a fraction of its side.
    Logo
    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
    A small symbol for the middle of the code in place of a picture.
    One emoji for the middle of the code. Your browser draws it and sends it as the logo picture, so it looks the way this device shows emoji.
    Color of the center text or symbol. Left out: the eye color.
    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.
    Clear space around the logo, in modules. Left out: 1.
    Logo shape
    Shape of the clear area behind the logo. "none" leaves the background showing.
    Color of the clear area behind the logo. Left out: the background color.
    Photo background
    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.
    How much the photo is lightened, from 0 to 0.9. Left out: 0.35.
    Frame
    Frame
    A border with a short call to action under (or above) the code.
    The words in the frame. Left out: SCAN ME.
    Color of the frame. Left out: the dot color.
    Color of the frame text. Left out: whichever of dark or light reads best.
    Letter style of the frame text.
    Size and safety
    Error correction
    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.
    Blank quiet zone around the code, in modules. Scanners expect at least 4.
    Width of one small square (module) in pixels.

    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

    NameTypeRequiredWhat 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.