Definicje prostym językiem terminów pojawiających się na tej stronie i w dokumentacji kanałów bankowych. Pisane najpierw dla skarbników i zespołów operacyjnych, dopiero potem dla inżynierów.
Komunikaty#
pain.001 — Customer Credit Transfer Initiation. Komunikat XML, który klient wysyła do banku, aby zlecić jedno lub więcej poleceń przelewu. Rodzina „pain” to payment initiation (inicjowanie płatności); .001 to numer komunikatu; końcowa wersja (.001.09) przypina schemat.
pain.002 — Customer Payment Status Report. Odpowiedź banku na Państwa pain.001 lub pain.008: przyjęty, częściowo przyjęty lub odrzucony, z kodami przyczyn ISO dla każdej transakcji.
pain.008 — Customer Direct Debit Initiation. Bliźniak pain.001 po stronie poboru: pobierają Państwo należne środki na podstawie mandatu, zamiast je wypychać na zewnątrz.
pacs.008 / pacs.009. Międzybankowe komunikaty rozliczeniowe, w które zamienia się Państwa instrukcja po przyjęciu przez bank. Korporacje nigdy ich nie tworzą; wymieniają je banki.
camt.052 / camt.053 / camt.054. Raportowanie rachunków: odpowiednio raport śróddzienny, wyciąg na koniec dnia i zawiadomienie o obciążeniu/uznaniu. camt.053 to plik, z którego zespoły uzgodnień korzystają każdego ranka.
MT101. Historyczny komunikat tekstowy SWIFT „Request for Transfer”, zastępowany przez pain.001. Międzybankowy przekaz MT101 zostaje wycofany 14 listopada 2026 r. na rzecz pain.001.001.09; MT101 w relacji korporacja–bank utrzymuje się wyłącznie według uznania danego banku.
Systemy i zbiory reguł#
SEPA SCT / SCT Inst. Systemy poleceń przelewu w euro (standardowy i natychmiastowy) regulowane zbiorami reguł European Payments Council. Przelewy natychmiastowe rozliczają się w sekundach, przez całą dobę.
SEPA SDD Core / B2B. Systemy poleceń zapłaty w euro — Core dla konsumentów (z prawem zwrotu), B2B dla firm (bez prawa zwrotu, ostrzejsze kontrole mandatów).
CBPR+. Cross-Border Payments and Reporting Plus: wytyczne użycia profilujące komunikaty ISO 20022 dla bankowości korespondenckiej SWIFT. Gdy mowa o „migracji SWIFT na ISO 20022”, chodzi o CBPR+.
HVPS+. Odpowiednik tego profilowania dla systemów płatności wysokokwotowych (T2, CHAPS, Fedwire i pokrewne).
CGI-MP. Common Global Implementation — Market Practice: grupa harmonizująca sposób, w jaki korporacje używają komunikatów pain u różnych banków, tak aby jeden format pliku mógł obsłużyć wielu partnerów bankowych.
Verification of Payee (VoP). Wymagana przez UE kontrola zgodności nazwy z IBAN, stosowana do wszystkich poleceń przelewu SEPA od 9 października 2025 r. Wykonywana przez dostawcę usług płatniczych w momencie realizacji; o dopasowaniu decydują czyste dane wierzyciela.
Identyfikatory i dane#
IBAN. Międzynarodowy numer rachunku bankowego (ISO 13616), samokontrolujący się dzięki sumie kontrolnej mod-97 — dlatego pojedyncza przestawiona cyfra jest wykrywalna przed wysłaniem.
BIC / BICFI. Kod identyfikacyjny instytucji finansowej wg ISO 9362. Element XML to pain.001.001.03, ale
LEI. Legal Entity Identifier (ISO 17442) — 20-znakowy globalny identyfikator podmiotu. Aktywnych jest ponad 3 miliony, a regulatorzy coraz częściej wymagają ich w płatnościach.
UETR. Unique End-to-end Transaction Reference — UUID, dzięki któremu płatność można śledzić w całym łańcuchu banków korespondentów (SWIFT gpi).
Adres ustrukturyzowany / hybrydowy. Adresy pocztowe jako odrębne elementy XML (ulica, miejscowość, kod pocztowy, kraj) zamiast wierszy dowolnego tekstu. Od 14 listopada 2026 r. CBPR+ odrzuca adresy w pełni nieustrukturyzowane; format hybrydowy — ustrukturyzowana miejscowość i kraj plus maksymalnie dwa 70-znakowe wiersze adresu — pozostaje ważny.
NbOfTxs / CtrlSum. Sumy kontrolne nagłówka grupy: liczba transakcji i suma kwot. Banki przeliczają je same; jeśli Państwa wartości się różnią, plik wraca. Pain001 zawsze wyprowadza je ze zwalidowanych rekordów.
Podział opłat (charge bearer). Kto płaci prowizje: DEBT (nadawca), CRED (odbiorca), SHAR (podział), SLEV (wg reguł systemu). Historyczne MT OUR/BEN/SHA odpowiadają pierwszym trzem.
Informacje o płatności (remittance information). Pole „za co jest ta płatność” — dowolny tekst (140 znaków) lub ustrukturyzowane referencje. To pole, o którego rzetelne wypełnianie zespoły uzgodnień proszą wszystkich.
Terminy narzędziowe używane na tej stronie#
Walidacja XSD. Sprawdzanie XML względem oficjalnej definicji schematu ISO 20022. Pain001 traktuje ją jako twardą bramkę przed zapisaniem jakiegokolwiek pliku.
MCP — Model Context Protocol. Otwarty standard, przez który asystenci AI wywołują zewnętrzne narzędzia. pain001-mcp udostępnia 17 narzędzi płatniczych dowolnemu klientowi MCP, lokalnie przez stdio.
LSP — Language Server Protocol. Standard integracji z edytorami stojący za diagnostyką IDE. pain001-lsp wykorzystuje go do walidacji plików płatności podczas pisania.
SBOM. Software Bill of Materials — odczytywalny maszynowo spis wszystkich zależności wydania, generowany w formacie CycloneDX dla wydań rdzenia Pain001.
Czegoś brakuje? Proszę zaproponować termin — ten słownik rośnie wraz z pytaniami, które ludzie naprawdę zadają.