authorization ptlf - ghdrako/doc_snipets GitHub Wiki

BASE24 PTLF – Struktura rekordu autoryzacji

Pole Typ Opis
FILE_ID CHAR(12) Identyfikator pliku wsadowego lub źródła transakcji.
TM_STAMP NUMBER(19) Znacznik czasu przetwarzania rekordu (UNIX timestamp / milisekundy).
B24_DT DATE Data wyciagnieta z TM_STAMP
REC_TYP VARCHAR2(2) Typ rekordu (np. '01' = autoryzacja).
CRD_LN VARCHAR2(4) Linia karty / segment systemowy.
CRD_FIID VARCHAR2(4) FIID instytucji karty.
CRD_PAN NUMBER(19) Numer karty (Primary Account Number).
CRD_PSN VARCHAR2(3) Numer sekwencyjny karty (dla EMV).
RT_LN VARCHAR2(4) Linia routingu.
RETL_FIID VARCHAR2(4) FIID detalisty / akceptanta.
RT_GRP VARCHAR2(4) Grupa routingu.
RT_REGN VARCHAR2(4) Region routingu.
RT_ID VARCHAR2(19) Identyfikator routingu.
RT_TRMID VARCHAR2(16) Identyfikator terminala w sieci.
TRX_SHIFT VARCHAR2(3) Numer zmiany w punkcie sprzedaży.
TRX_BATCH VARCHAR2(3) Numer paczki transakcji.
TRM_LN VARCHAR2(4) Linia terminala.
TRM_FIID VARCHAR2(4) FIID właściciela terminala.
TRM_ID VARCHAR2(16) Identyfikator terminala (DE41).
TRM_TIM VARCHAR2(8) Czas transakcji na terminalu (HHMMSS).
TKEY_TERM_ID VARCHAR2(16) Klucz terminala do mapowania.
TRX_RECTYP CHAR(1) Typ rekordu transakcji (np. Request/Response).
TRX_RTID VARCHAR2(19) Identyfikator transakcji w routingu.
TRX_CLERK NUMBER(6) Identyfikator kasjera.
USR_DAT_FL CHAR(1) Flaga danych użytkownika.
MSG_TYP NUMBER(4) MTI – Message Type Indicator (np. 0100, 0200).
RTE_STAT NUMBER(2) Status routingu.
RQT_FROM CHAR(1) Źródło żądania.
RSP_FROM CHAR(1) Źródło odpowiedzi.
TRX_ISSCD VARCHAR2(2) Kod systemu wydawcy.
RQTWE_TM NUMBER(19) Czas wysłania żądania (epoch).
RQTWY_TM NUMBER(19) Czas otrzymania żądania.
RSPWE_TM NUMBER(19) Czas wysłania odpowiedzi.
TRN_DT DATE Data transakcji.
TRN_MS NUMBER(2) Milisekundy transakcji.
POST_DAT DATE Data księgowania.
ACQ_DT DATE Data przejęcia transakcji przez akceptanta.
ISS_DT DATE Data przetwarzania przez wydawcę.
SEQ_NO VARCHAR2(12) Numer sekwencyjny transakcji.
TRM_NAMLOC VARCHAR2(25) Nazwa i lokalizacja terminala.
TRM_OWNER VARCHAR2(22) Właściciel / merchant.
TRM_CITY VARCHAR2(13) Miasto lokalizacji terminala.
TRM_STATE VARCHAR2(3) Kod stanu / województwa.
TRM_CNTRY VARCHAR2(2) Kod kraju ISO.
TRM_ODDZ VARCHAR2(4) Kod oddziału.
USER_FLD VARCHAR2(3) Pole użytkownika.
TRM_TMDIFF VARCHAR2(5) Różnica czasu terminala vs system.
ACQ_ID NUMBER(11) Identyfikator nabywcy (acquirer).
RCV_ID NUMBER(11) Identyfikator odbiorcy komunikatu.
TRM_TYP VARCHAR2(2) Typ terminala (POS, ATM, ECOM).
CLERK_ID VARCHAR2(6) Id kasjera.
CRT_USER VARCHAR2(8) Użytkownik tworzący rekord.
RT_MCC VARCHAR2(4) Merchant Category Code (branża).
AUTH_ORIG VARCHAR2(4) Skąd przyszła autoryzacja (system źródłowy).
AUTH_DEST VARCHAR2(4) Gdzie wysłano autoryzację (np. Visa/MasterCard).
TRAN_CDE VARCHAR2(2) Kod typu transakcji (Purchase, Cash, Reversal).
TRAN_CDE_T CHAR(1) Flaga transakcji (T = typ).
TRAN_CDE_AA VARCHAR2(2) Dodatkowy kod transakcji.
TRAN_CDE_C CHAR(1) Klasyfikacja transakcji.
CRD_TYP VARCHAR2(2) Typ karty (Debit/Credit).
ACCT VARCHAR2(19) Numer rachunku powiązanego z kartą.
RESP_CDE NUMBER(3) Kod odpowiedzi (00 = Approved).
AMNT_1 NUMBER(19,2) Kwota transakcji główna.
AMNT_2 NUMBER(19,2) Kwota dodatkowa / cashback.
EXP_DT VARCHAR2(4) Data ważności karty.
TRACK2 VARCHAR2(40) Dane z paska magnetycznego (DE35).
PIN_OFST1 VARCHAR2(16) Offset PIN-u (dla systemu HSM).
PREAUTH_SN VARCHAR2(12) Numer preautoryzacji.
INVOICE_NO VARCHAR2(10) Numer paragonu.
ORIG_INVCE VARCHAR2(10) Numer paragonu oryginalnego.
AUTHORIZER VARCHAR2(16) Osoba/system autoryzujący.
AUTH_IND CHAR(1) Flaga autoryzacji (Y/N).
SHIFT_NUM VARCHAR2(3) Numer zmiany kasjera.
BATCH_SN VARCHAR2(3) Numer batcha.
APROVAL_CD VARCHAR2(8) Kod akceptacji.
APRV_CDLEN NUMBER(1) Długość kodu akceptacji.
ICHG_RESP VARCHAR2(8) Kod odpowiedzi intercharge.
PSEUDO_TRM VARCHAR2(4) Pseudonim terminala.
RFRL_PHONE VARCHAR2(20) Numer telefonu do referencji.
DFT_CAP_FL NUMBER(1) Flaga domyślnego CAP.
SETL_FLAG NUMBER(1) Flaga rozliczenia.
RVRL_CD NUMBER(2) Kod reversalu.
CHG_RSNCD VARCHAR2(2) Kod powodu chargeback.
POS_CONDCD NUMBER(2) Point of Service Condition Code (np. 00 = normal).
POS_ENTRY NUMBER(3) Point of Service Entry Mode – sposób wprowadzenia (magstripe/chip/contactless).
AUTH_IND2 CHAR(1) Flaga dodatkowej autoryzacji.
ORG_TCURR NUMBER(3) Waluta oryginalna.
AUTH_CURR NUMBER(3) Waluta autoryzacji.
AUTH_RATE NUMBER(8) Kurs autoryzacji.
STL_CURR NUMBER(3) Waluta rozliczenia.
STL_RATE NUMBER(8) Kurs rozliczeniowy.
CONV_DT NUMBER(19) Data konwersji waluty.
FIID NUMBER(11) FIID instytucji finansowej.
AIID VARCHAR2(11) Id akceptanta.
IIID NUMBER(11) Id wydawcy.
ORG_MTI VARCHAR2(4) MTI oryginalnej transakcji.
ORG_TRX_TM VARCHAR2(8) Czas oryginalnej transakcji.
ORG_TRX_DT VARCHAR2(4) Data oryginalnej transakcji.
ORG_TRX_SN VARCHAR2(12) Numer sekwencyjny oryginalnej transakcji.
ORG_B24_DT VARCHAR2(4) Data BASE24 oryginału.
EXCP_RSNCD VARCHAR2(3) Kod powodu wyjątku.
OVRRDE_FL CHAR(1) Flaga nadpisania autoryzacji.
ADDR VARCHAR2(20) Adres akceptanta.
ZIP_CD VARCHAR2(9) Kod pocztowy.
ADR_VRFY CHAR(1) Flaga weryfikacji adresu (AVS).
PIN_IND CHAR(1) Czy użyto PIN-u (Y/N).
PIN_TRIES CHAR(1) Liczba prób PIN.
PREAUTH_DT DATE Data preautoryzacji.
PREAUTH_TM NUMBER(2) Czas preautoryzacji.
PREAUTH_FL CHAR(1) Flaga preautoryzacji.
PREAUTHLVL CHAR(1) Poziom preautoryzacji.
USER_FLD5 VARCHAR2(16) Pole użytkownika 5.
AUTH_DEST_CMPNT_ID VARCHAR2(16) Komponent docelowy autoryzacji.
DEST_NAME VARCHAR2(16) Nazwa komponentu docelowego.
DE22SE1–DE22SE12 CHAR(1) Składniki DE22 – metoda wejścia POS.
DE22_ACQ_POS_ENTRY_MDE VARCHAR2(3) Tryb wejścia POS (z DE22).
DE39_EXTERNAL_RSP_CDE VARCHAR2(2) Zewnętrzny kod odpowiedzi.
DE48_SE42_ECI VARCHAR2(7) E-commerce Indicator.
DE61_BNET_DATA VARCHAR2(26) Dane bankowe sieciowe.
BE_AMT1 / BE_AMT2 NUMBER(19,2) Kwoty bilansowe.
BE_CRNCY NUMBER(3) Waluta bilansu.
BE_CONV_RATE VARCHAR2(8) Kurs bilansowy.
BE_MICR_DATA VARCHAR2(64) Dane MICR (czeki).
B2_* różne Pola EMV (TVR, CVR, ARQC, AIP, ATC, itp.).
B4_* różne Dane terminala EMV – capability, entry mode, etc.
B5_* różne Dane autoryzacji VISA/ISS.
B6_* różne Dane skryptów EMV.
C0_* różne Dane dodatkowe POS / e-commerce / CVV.
C4_* różne Dane CVM (PIN, signature, contactless, method).
BP_* różne Dane płatności mobilnych (Blik, ApplePay, GooglePay).
BD_* różne Dane walutowe i kwotowe (billing).
SC_* różne Dane tokenizacji (PAN token, typ transakcji).
S8_* różne Dane dodatkowe konta / numeru.
O4_* różne Dane weryfikacji i błędów karty.
CB_* różne Dane chargeback.
S9_ID_EPARAGONU VARCHAR2(74) Identyfikator e-paragonu.
SCORING_AML VARCHAR2(3) Wynik scoringu AML.
FRAUD_FLAG CHAR(1) Flaga podejrzenia oszustwa.
FRAUD_SCORE VARCHAR2(3) Wynik scoringu fraudowego.
FRAUD_RESONE_CODE VARCHAR2(2) Kod powodu fraudu.
MSG_RSN_CDE VARCHAR2(4) Kod powodu komunikatu (DE24).
STIP_RSN_CDE VARCHAR2(4) Powód STIP (Stand-in Processing).
UCAF_DATA VARCHAR2(32) Dane UCAF (3D Secure).
UCAF_INDICATOR CHAR(1) Indykator UCAF.
SCA_EXEMPTION_IND VARCHAR2(2) Indykator wyłączenia SCA (Strong Customer Authentication).
DIRECTORY_SERVER_TRANSACTION_ID VARCHAR2(36) ID transakcji 3DS Directory Server.
TRANSACTION_CODE_DE3 VARCHAR2(2) Transaction Processing Code (DE3).
TYP_KARTY VARCHAR2(6) Typ karty wg banku.
FRAUD_RESONE_CODE VARCHAR2(2) Kod przyczyny fraudu.
ANI_STATUS CHAR(2) Status autoryzacji.
ANI_RESULT CHAR(2) Wynik autoryzacji.

🔍 Pola CVM / PIN – kluczowe do analizy autoryzacji

Pole Opis Wskazówka
POS_ENTRY DE22 – sposób wejścia (chip, magstripe, contactless) – cyfra 3. mówi o CVM (PIN/signature)
PIN_IND Flaga – czy użyto PIN-u (Y/N).
C4_CRDHLDR_ID_METHOD Metoda identyfikacji posiadacza karty (PIN, Signature, None).
B2_CVM_RSLTS EMV CVM Results – dokładny wynik metody (np. offline PIN OK, no CVM).
B4_TERM_ENTRY_CAP Zdolność terminala do obsługi PIN-u.
C0_E_COM_FLG E-commerce flag (1 = transakcja internetowa bez PIN).
C4_TERM_INPUT_CAP_IND Zdolność terminala do wprowadzania danych (np. PIN pad).

„PIN” vs „bez PIN”

Scenariusz Wartość pól (typowo) Znaczenie
Online PIN POS_ENTRY = 051 lub 901, B2_CVM_RSLTS = 4203 Karta chip, PIN zweryfikowany online
Offline PIN POS_ENTRY = 052, B2_CVM_RSLTS = 1E03 lub 1F03 Chip, PIN zweryfikowany przez kartę
Signature B2_CVM_RSLTS = 5E03 lub 1E02 Transakcja z podpisem
No CVM (Contactless Low Value) POS_ENTRY = 071 lub 072, B2_CVM_RSLTS = 1E00 Bez PIN, bez podpisu
E-commerce (no PIN) C0_E_COM_FLG = 1, POS_ENTRY = 081, PIN_IND = N Transakcja internetowa bez PIN

Dane EMV (Chip)

Pole Opis
B2_ARQC Application Request Cryptogram.
B2_AIP Application Interchange Profile.
B2_ATC Application Transaction Counter.
B2_TVR Terminal Verification Results.
B2_CVR Card Verification Results.
B6_CVM_RSLTS EMV CVM Results – sposób weryfikacji (PIN, signature, none).

Dane o karcie

Pole Opis
CRD_PAN Numer karty (Primary Account Number).
CRD_PSN PAN Sequence Number – numer kolejny (dla chipów).
CRD_TYP Typ karty (np. kredytowa, debetowa).
EXP_DT Data ważności karty (MMYY).
TRACK2 Dane z paska magnetycznego (DE35).

Dane terminala

Pole Opis
TRM_ID Identyfikator terminala.
TRM_CITY / TRM_STATE / TRM_CNTRY Lokalizacja terminala.
TRM_TYP Typ terminala (POS, ATM, eCommerce, itp.).
TRM_OWNER Właściciel terminala / merchant.
RT_MCC Merchant Category Code (branża).

Dane transakcji

Pole Opis
TRAN_CDE Kod transakcji (np. 00 = Purchase).
AMNT_1 / AMNT_2 Kwoty transakcji / dodatkowe.
TRN_DT Data transakcji.
POST_DAT Data księgowania.
AUTH_RATE / STL_RATE Kursy wymiany walut.

Dane o weryfikacji (CVM / PIN / Signature)

Pole Opis
POS_ENTRY POS Entry Mode – określa metodę odczytu i CVM (np. 051 = chip + online PIN, 071 = contactless no CVM).
PIN_IND Czy użyto PIN-u.
PIN_TRIES Liczba prób PIN.
C4_CRDHLDR_ID_METHOD Metoda identyfikacji posiadacza karty.
B2_CVM_RSLTS CVM Results – wynik metody weryfikacji karty (EMV data).
B4_TERM_ENTRY_CAP Zdolność terminala do obsługi PIN-u.
C0_CVD_FLD CVV/CVC – dane weryfikacyjne dla transakcji card-not-present.
C0_E_COM_FLG Flaga transakcji e-commerce.
C4_TERM_INPUT_CAP_IND Możliwość wprowadzenia danych przez terminal (PIN pad).