6 min czytaniaFunkcje

Kod QR EPC: standard płatności SEPA w kodzie QR

Kod QR EPC koduje przelew SEPA, a nie adres URL, więc aplikacja bankowa wypełnia formularz. Co zawiera ładunek i dlaczego nie da się go śledzić.

Marius Voß
DevRel · edge infra

Kod QR EPC nie zawiera linku. To przelew SEPA zapisany jako krótki blok zwykłego tekstu, a aplikacja bankowa, która rozpoznaje ten format, odczytuje go i wypełnia formularz przelewu. Żaden serwer nie jest kontaktowany, nic nie jest wyszukiwane i nic o skanie do Ciebie nie dociera.

Ten jeden fakt rozstrzyga o całej reszcie sposobu używania takich kodów. Nie skrócisz go, nie przekierujesz i nie policzysz skanów, bo w całym przepływie nie ma żadnego żądania. Standard, który za tym stoi, to EPC069-12 European Payments Council, w krajach niemieckojęzycznych kody te zwykle nazywa się GiroCode, a format warto dokładnie zrozumieć, zanim wydrukujesz tysiące takich kodów na fakturach. Ogólny przypadek tego, co kod może nieść, omawia czym jest kod QR w kwestii ładunku.

Co faktycznie zawiera ładunek

Ładunek to sekwencja wierszy w stałej kolejności, a każdy wiersz to osobny element. Parser czyta wiersz 1, oczekuje BCD, czyta wiersz 4, oczekuje SCT i poddaje się, jeśli któregoś brakuje.

WierszZawartośćLimit
Znacznik usługiBCDstały, 3 znaki
Wersja001 lub 002002 czyni BIC opcjonalnym
Zestaw znaków1 dla UTF-8, do 8jedna cyfra
IdentyfikacjaSCTstały, 3 znaki
BICidentyfikator banku odbiorcy11 znaków, często pomijany
Nazwa odbiorcywłaściciel rachunku70 znaków
IBANrachunek odbiorcy34 znaki
KwotaEUR i wartość0.01 do 999999999.99, w EUR
Kod celucel ISO, rzadko używany4 znaki
Referencja strukturalnareferencja wierzyciela, albo35 znaków
Tekst niestrukturalnyswobodny tytuł zamiast niej140 znaków
Od odbiorcy do zleceniodawcynotatka widoczna dla płatnika70 znaków

Dwie zasady zbijają ludzi z tropu. Referencja strukturalna i tekst niestrukturalny wzajemnie się wykluczają: wypełnij jedno, drugie zostaw puste. A kwota jest opcjonalna, co jest właściwym wyborem dla kodu na darowizny, gdzie płatnik sam decyduje, i złym dla faktury, gdzie chcesz mieć wstępnie wypełnioną dokładną kwotę.

Cały blok jest ograniczony do 331 bajtów, a elementy rozdziela line feed lub CRLF, bez separatora po ostatnim. Te 331 bajtów liczy się w bajtach UTF-8, więc nazwy z diakrytykami zajmują więcej niż liczba znaków. Nazwa, IBAN, BIC i referencja strukturalna są oznaczone jako stałe, czyli aplikacja płatnika nie powinna pozwalać ich edytować. Wytyczne EPC069-12, wersja 3.1 z 19 marca 2024 (dostęp 2026-10-25; powyższa tabela pól jest z nimi sprawdzona) ustalają też poziom korekcji błędów na M i ograniczają symbol do wersji 13 (69 modułów na bok). Przykładowy ładunek z samego dokumentu ma 96 bajtów i daje kod wersji 6 o 41 modułach. Jeśli budujesz to w kodzie, dokumentacja biblioteki Segno (dostęp 2026-10-25) pokazuje kolejność pól, a jej funkcja pomocnicza ustala poziom błędów na M i wersję na 13 lub niższą, zgodnie ze specyfikacją.

Cztery bloki ładunku kodu QR EPC, od stałego znacznika usługi przez dane odbiorcy i kwotę po tytuł przelewu

Dlaczego nie da się go skrócić ani śledzić

Śledzony kod QR działa, kodując adres URL, który należy do Ciebie. Skan otwiera ten URL, Twoje przekierowanie odpowiada, liczysz żądanie, a odwiedzający ląduje tam, gdzie akurat kierujesz link. Kody QR dynamiczne i statyczne opisują ten mechanizm w całości.

Nic z tego tu nie obowiązuje i nie ma obejścia. Aplikacja bankowa nie jest przeglądarką. Parsuje tekst, dopasowuje format i otwiera formularz płatności lokalnie na urządzeniu. Nie ma żądania HTTP do przechwycenia, więc:

  • Nigdzie nie istnieje liczba skanów. Ani w Twoim narzędziu, ani w banku.
  • Niczego nie da się przekierować. Błędny IBAN oznacza ponowny druk.
  • Opakuj ładunek w krótki link, a przestanie działać, bo parser widzi https tam, gdzie oczekuje BCD.

Strona płatności i strona pomiaru to dwa różne kody. Jeśli układ ma miejsce tylko na jeden, wygrywa kod płatności. Zawsze umieściłbym kod płatności pierwszy, a śledzony link drugi.

Mierzyć można wszystko wokół niego. Jeśli przesyłka niesie fakturę z kodem płatności, umieść na liście osobny śledzony krótki link do portalu klienta, regulaminu lub strony wsparcia i odczytuj zaangażowanie z niego. Funkcje kodów QR w Elido obejmują śledzoną połowę arkusza, a kod płatności zostaje dokładnie taki, jakiego wymaga standard.

Gdzie działa, a gdzie nie

Obsługa leży w poszczególnych aplikacjach bankowych, dlatego listy krajów ją przeceniają. Dokument EPC jest wyraźnie informacyjny, a jego wdrożenie jest dla banków opcjonalne. Przetestuj, zanim zdecydujesz się na nakład.

Z kodem myli się dwóch sąsiadów. Szwajcarski QR-bill to inna specyfikacja ze szwajcarskim krzyżem w środku, a aplikacje ze strefy euro nie odczytają go jako płatności. Link płatniczy operatora kart to po prostu adres URL w kodzie QR z hostowanym checkoutem na końcu i śledzi się jak każdy link webowy.

W szerszej kwestii tego, co regulowana firma płatnicza lub kredytowa może pokazać klientom, skracacze URL dla fintech omawiają te części, w których występuje link.

Kod QR do płatności dekodowany offline do formularza przelewu w porównaniu z kodem QR z linkiem, który trafia do przekierowania i generuje analitykę

Czy można go zrobić w Elido?

Nie jako dedykowaną funkcję. Sprawdzone w kodzie 2026-10-25: darmowe narzędzie generatora QR ma sześć typów treści (URL, tekst, Wi-Fi, vCard, e-mail, SMS) i żaden nie jest typem EPC ani płatności. Projektant QR w panelu przyjmuje jednowierszowe pole treści, więc w ogóle nie pomieści wielowierszowego ładunku.

Obejściem jest typ Text darmowego narzędzia, który ma wielowierszowe pole i przekazuje Twój tekst bez zmian. Wklej dwanaście wierszy, zostaw korekcję błędów na M (domyślną w narzędziu) i pobierz PNG lub SVG. Dwie przestrogi. Nie ma walidacji, więc błędny IBAN albo dodatkowy końcowy znak nowej linii daje kod, który wygląda dobrze i zawodzi w aplikacji bankowej. Poza tym to kod statyczny bez śledzenia, czyli dokładnie to, czym kod płatności powinien być. Prawdziwy typ EPC ze sprawdzaniem IBAN jest w naszym backlogu.

Jak go przygotować bez żalu

Sześć kontroli, w kolejności, w jakiej oszczędzają pieniądze.

  1. Zwaliduj IBAN przed generowaniem, a nie po wydrukowaniu. Test sumy kontrolnej nic nie kosztuje, a ponowny druk kosztuje nakład.
  2. Zdecyduj o kwocie świadomie. Stała dla faktur, pusta dla plakatów z darowiznami, gdzie każda kwota powinna być możliwa.
  3. Wybieraj referencję strukturalną zamiast swobodnego tekstu. Jest krótsza, uzgadnia się automatycznie w Twojej księgowości i utrzymuje mały ładunek.
  4. Testuj w co najmniej trzech aplikacjach bankowych, na obu platformach telefonów. Parsery różnią się tym, jak ściśle traktują pola opcjonalne.
  5. Dobierz rozmiar wydrukowanego kodu do dystansu, z jakiego będzie skanowany, dokładnie jak przy każdym innym kodzie. Jak duży powinien być kod QR zawiera rachunki.
  6. Wybierz mat. Błyszczący lakier w świetle biurowym powoduje odblaski i nieudane skany.

Problem naklejki

Jest jeden realny wektor oszustwa i jest fizyczny, a nie cyfrowy. Statyczny kod płatności wydrukowany na fakturze, parkomacie, szyldzie na targu czy plakacie charytatywnym można zakleić naklejką z innym IBAN. Nic w kodzie nie jest w stanie się temu oprzeć, bo ładunkiem jest papier, a on niczego nie sprawdza.

Środki zaradcze są równie fizyczne. Drukuj kod wewnątrz układu faktury, gdzie etykieta byłaby widoczna, a nie na samoprzylepnej łatce. Pokaż nazwę odbiorcy i ostatnie cyfry IBAN tekstem obok kodu, aby płatnik mógł porównać. W instrukcji potwierdzenia płatności powiedz ludziom, by przeczytali nazwę wyświetlaną przez aplikację bankową przed potwierdzeniem, bo ten ekran to jedyne miejsce, w którym podmiana staje się widoczna. Czy kody QR są bezpieczne i czym naprawdę jest quishing opisuje szerszy wzorzec ataku, który w większości dotyczy kodów z linkami drukowanych gdzie indziej na tej samej stronie.

Uspokajające jest to, że płatność wciąż wymaga potwierdzenia przez człowieka w uwierzytelnionej aplikacji bankowej. Kod wypełnia formularz, nigdy nie przenosi pieniędzy. O tym, jak bank powinien zarządzać innymi kodami drukowanymi wokół kodu płatności, zobacz kody QR w bankowości.

Drukowany przebieg pracy wokół dowolnego kodu opisuje kampania z kodem QR od zera. Przewodnik po kodach QR w dokumentacji omawia rodzaj śledzony.

Powiązane na blogu

Najczęściej zadawane pytania

Czym jest kod QR EPC?

To kod QR, który koduje dane przelewu SEPA jako zwykły tekst, dzięki czemu aplikacja bankowa potrafi go odczytać i wypełnić formularz przelewu. Został ustandaryzowany przez European Payments Council w wytycznych EPC069-12 i jest też znany jako GiroCode. Ładunek to stała sekwencja wierszy zaczynająca się od znacznika usługi BCD i nie zawiera żadnego adresu internetowego.

Które kraje obsługują płatności GiroCode?

Obsługa leży po stronie aplikacji bankowej, nie kraju. EPC zaznacza, że schemat jest dla banków opcjonalny, a Wikipedia wymienia Austrię, Belgię, Finlandię, Niemcy, Holandię, Luksemburg, Estonię, Łotwę, Litwę i Włochy jako miejsca, gdzie takie kody są powszechnie używane (dostęp 2026-10-25). Nie testowaliśmy poszczególnych aplikacji, więc przetestuj swoją. Poza strefą euro kod nie ma znaczenia. Szwajcaria używa własnego standardu QR-bill, który wygląda podobnie i nie jest zgodny.

Czy kod QR EPC może być dynamiczny lub śledzony?

Nie. Dane płatności są wewnątrz wydrukowanego wzoru, a telefon dekoduje je offline bez kontaktu z żadnym serwerem, więc nie ma czego przekierować ani zliczyć. Jeśli musisz zmienić kwotę lub tytuł, generujesz nowy kod. Wszystko, co jest Ci sprzedawane jako dynamiczny kod QR do płatności, to link do strony płatności, czyli inny produkt.

Co się stanie, jeśli umieszczę krótki link w kodzie QR EPC?

Aplikacja bankowa nie zdoła go sparsować i albo pokaże błąd, albo potraktuje kod jak zwykły adres URL. Parser oczekuje, że pierwszy wiersz to BCD, a czwarty to SCT; adres URL nie spełnia żadnego z tych warunków. Kody QR do płatności i kody QR z linkiem to dwa osobne kody, które tylko mają ten sam kształt symbolu.

Jak duży może być ładunek?

331 bajtów, co według wytycznych EPC ogranicza kod QR do wersji 13 z korekcją błędów na poziomie M. W praktyce ładunek wypełnia tytuł przelewu, więc długie swobodne pole tytułu to element, który przekracza limit. Trzymaj tytuł strukturalny i krótki, a kod pozostanie na tyle rzadki, by dało się go zeskanować z wydrukowanej faktury.

Czy kody QR do płatności są bezpieczne na papierowych fakturach?

Sam kod nie niesie żadnej wykonywalnej treści, a płatnik potwierdza przelew w aplikacji bankowej, która pokazuje nazwę odbiorcy i IBAN, zanim cokolwiek zostanie przesłane. Prawdziwe ryzyko jest fizyczne: naklejka umieszczona na wydrukowanym kodzie, przekierowująca płatność na inne konto. Drukuj kod wewnątrz układu faktury, a nie na etykiecie, i powiedz płatnikom, by sprawdzali nazwę na ekranie potwierdzenia.

Wypróbuj Elido

Wklej URL, otrzymaj krótki link

Bez rejestracji. Link działa 30 dni. Zarejestruj się, aby zachować go na zawsze.

Wymagane darmowe konto. Darmowy plan zawiera łącznie 25 linków. Masz już konto? Zaloguj się

Wypróbuj Elido

Skracarka URL hostowana w UE: własne domeny, głęboka analityka i otwarte API. Darmowy plan - bez karty kredytowej.

Tagi
epc qr code
girocode
sepa payment qr code
qr code payment
static qr code
invoice qr code

Czytaj dalej