Tartalom 1 i tételes forgalmi listák rekordleírásai... 2 1.1 CSVD formátum... 2 1.1.1 Általános információk... 2 1.1.2 Fejrekord... 2 1.1.3 Adatrekord... 3 1.1.4 Zárórekord... 3 1.2 K01D formátum... 4 1.2.1 Általános információk... 4 1.2.2 Fejrekord... 4 1.2.3 Adatrekord... 5 1.2.4 Zárórekord... 6 1.3 K04D formátum... 7 1.3.1 Általános információk... 7 1.3.2 Fejrekord... 7 1.3.3 Adatrekord... 8 1.3.4 Zárórekord... 9 1.4 K05D formátum... 10 1.4.1 Általános információk... 10 1.4.2 Fejrekord... 10 1.4.3 Adatrekord... 11 1.4.4 Zárórekord... 12 2 Melléklet... 13
1 i tételes forgalmi listák rekordleírásai 1.1 CSVD formátum 1.1.1 Általános információk Kódlap: File formátum: Összeg mezők: Megjegyzés: ISO-8859-2 csv (pontosvesszővel ( ; ) tagolt) Az elszámolás pénznemében értendők (lásd fejrekord), 2 tizedest tartalmaznak tizedesvesszővel elválasztva. Eredeti vásárlás tranzakciónál (pozitív összegnél) nincs előjel Áruvisszavét esetén (negatív összegnél) előjel A 2015.11.09-ig ECSV kódon futó analitikából, a tranzakciót terhelő díj oszlopokkal bővített formátum. 1.1.2 Fejrekord Megnevezés Max Magyarázat Konstans FH 2 "FH" - File Header kódja 9 Az OTP Bank által adott egyedi azonosítószám neve 30 Iktatószám 10 Az OTP Bank rendszerében használt iktatószám, felépítése: éééé.hh.nn Dátum 10 Az állomány készítésének napja, számlaszáma 30 Formátum: 99999999-99999999-99999999, 99999999-99999999 vagy HU9999999999-99999999-99999999 fixen 30 karakter hosszon Elszámolás 3 pénzneme HUF, EUR vagy USD 2
1.1.3 Adatrekord Megnevezés Max Magyarázat OTP egyedi 16 azonosító Az OTP Bank által (könyveléskor) adott egyedi tranzakcióazonosító Terminál kód 8 A POS terminál OTP-s azonosítója Authorizációs kód 6 Az authorizációs rendszer által generált egyedi azonosító 8 dátuma Formátuma: ééééhhnn 6 időpontja Formátuma: óóppmm 19 Maximum 19 jegyű kártyaszám Kártyaszám Az első 6 és az utolsó 4 jegy megjelenítve, a többi jegy * -al behelyettesítve. 10 összege A tranzakció összege az elszámolás pénznemében Bankközi díj 8 A bankközi díj (interchange díj) összege az elszámolás pénznemében Kártyatársasági díj 8 A kártyatársasági díj összege az elszámolás pénznemében Banki marzs 8 A banki marzs összege az elszámolás pénznemében Jutalék 8 A jutalék összege az elszámolás pénznemében Nettó összeg 10 = (tranzakció összege jutalék), az elszámolás pénznemében jelző 1 Értéke Cashback tranzakció esetén: K, DCC tranzakció esetén: D Partner program tr. esetén P, partner kedvezmény tr. esetén R Egyéb esetben: (space) Üzlet neve 30 Külső egyedi 32 azonosító A kereskedő által előállított és OTP felé küldött azonosító BINF 2 Kártyatípus (értékkészletet lásd külön) 1.1.4 Zárórekord Megnevezés Max Magyarázat Konstans FT 2 "FT" - File Trailer kódja 9 Az OTP Bank által adott egyedi azonosítószám Dátum 10 Az állomány készítésének napja Feldolgozott 8 A file-ban szereplő tranzakció sorok száma rekordok száma Összes nettó összeg 10 A file tranzakció soraiban szereplő nettó összegek együttes értéke az elszámolás pénznemében 3
1.2 K01D formátum 1.2.1 Általános információk Kódlap: char típusú mezők: num típusú mezők: Összeg mezők: ISO-8859-2 Balra igazított, jobbról szóközzel feltöltött mezők (a kivételek az adott mezőnél jelezve) Jobbra igazított, balról 0-kkal feltöltött mezők Forintban értendők, tizedes nélkül. Pozitív összeg esetén az előjel helyén space van. Negatív összeg esetén előjel szerepel. Az adatrekordokban az összeg mezők (megelőző szóköz és előjel mezővel vett együttes) hossza: 15 karakter Megjegyzés: A 2015.11.09-ig K001, SHEL, TESC, TOBA, WEBS kódon futó analitikákból, a tranzakciót terhelő díj oszlopokkal bővített formátum. 1.2.2 Fejrekord 1-2 2 char Konstans FH "FH" - File Header 3 1 char Filler Szóköz 4-12 9 char Az OTP Bank által adott egyedi azonosítószám kódja 13-15 3 char Filler Szóköz 16-45 30 char neve 46-49 4 char Filler Szóköz 50-59 10 char Iktatószám Az OTP Bank rendszerében használt iktatószám, felépítése: éééé.hh.nn 60-66 7 char Filler Szóköz 67-76 10 char Dátum Az állomány készítésének napja 77-79 3 char Filler Szóköz Formátum: 80-109 30 num HU9999999999-99999999-99999999 99999999-99999999-99999999, számlaszáma 99999999-99999999 vagy 110-112 3 char Elszámolás pénzneme HUF 4
1.2.3 Adatrekord 1-16 16 char OTP egyedi Az OTP Bank által (könyveléskor) adott egyedi azonosító tranzakcióazonosító 17-19 3 char Filler Szóköz 20-27 8 char Terminál kód A POS terminál OTP-s azonosítója 28-29 2 char Filler Szóköz 30-35 6 char Authorizációs Az authorizációs rendszer által generált egyedi kód azonosító 36-38 3 char Filler Szóköz 39-46 8 date dátuma Formátuma: ééééhhnn 47-48 2 char Filler Szóköz 49-54 6 char időpontja Formátuma: óóppmm 55-56 2 char Filler Szóköz 57-75 19 char Kártyaszám Maximum 19 jegyű kártyaszám Az első 6 és az utolsó 4 jegy megjelenítve, a többi jegy * -al behelyettesítve. Jobbra igazítva. 76-79 4 char Filler Szóköz 80 1 char Előjel Szóköz vagy a következő mezőtől függően 81-90 10 num összege A tranzakció összege forintban 91-96 6 char Filler Szóköz 97 1 char Előjel Szóköz vagy a következő mezőtől függően 98-105 8 num Bankközi díj A bankközi díj (interchange díj) összege forintban 106-111 6 char Filler Szóköz 112 1 char Előjel Szóköz vagy a következő mezőtől függően 113-120 8 num Kártyatársasági A kártyatársasági díj összege forintban díj 121-126 6 char Filler Szóköz 127 1 char Előjel Szóköz vagy a következő mezőtől függően 128-135 8 num Banki marzs A banki marzs összege forintban 136-141 6 char Filler Szóköz 142 1 char Előjel Szóköz vagy a következő mezőtől függően 143-150 8 num Jutalék A jutalék összege forintban 151-154 4 char Filler Szóköz 155 1 char Előjel Szóköz vagy a következő mezőtől függően 156-165 10 num Nettó összeg = (tranzakció összege jutalék) forintban 166-168 3 char Filler Szóköz 169 1 char jelző 170-172 3 char Filler Szóköz 173-202 30 char Üzlet neve 203-205 3 char Filler Szóköz Értéke Cashback tranzakció esetén: K, DCC tranzakció esetén: D Partner program tr. esetén P, partner kedvezmény tr. esetén R Egyéb esetben (space) 5
206-237 32 char Külső egyedi A kereskedő által előállított és OTP felé küldött azonosító azonosító 238-240 3 char Filler Szóköz 241-242 2 char BINF Kártyatípus (értékkészletet lásd külön) 243 1 char Filler Szóköz 1.2.4 Zárórekord 1-2 2 char Konstans FT "FT" - File Trailer 3 1 char Filler Szóköz 4-12 9 char kódja Az OTP Bank által adott egyedi azonosítószám 13-15 3 char Filler Szóköz 16-25 10 date Dátum Az állomány készítésének napja 26-28 3 char Filler Szóköz 29-36 8 num Feldolgozott A file-ban szereplő tranzakció sorok száma, rekordok előnullázva száma 37-43 7 char Filler Szóköz 44 1 char Előjel Szóköz vagy a következő mezőtől függően 45-54 10 num Összes nettó A file tranzakció soraiban szereplő nettó összegek összeg együttes értéke forintban 6
1.3 K04D formátum 1.3.1 Általános információk Kódlap: char típusú mezők: num típusú mezők: Összeg mezők: ISO-8859-2 Balra igazított, jobbról szóközzel feltöltött mezők (a kivételek az adott mezőnél jelezve) Jobbra igazított, balról 0-kkal feltöltött mezők A fejrekordban lévő Elszámolás pénzneme mező értékének megfelelő pénznemben értendők, két tizedes jeggyel Pozitív összeg esetén az előjel helyén space van. Negatív összeg esetén előjel szerepel. Az adatrekordokban az összeg mezők (megelőző szóköz és előjel mezővel vett együttes) hossza: 15 karakter Megjegyzés: A 2015.11.09-ig K004 kódon futó analitikából, a tranzakciót terhelő díj oszlopokkal bővített formátum. 1.3.2 Fejrekord 1-2 2 char Konstans FH "FH" - File Header 3 1 char Filler Szóköz 4-12 9 char Az OTP Bank által adott egyedi azonosítószám kódja 13-15 3 char Filler Szóköz 16-45 30 char neve 46-49 4 char filler Szóköz 50-59 10 char Iktatószám Az OTP Bank rendszerében használt iktatószám, felépítése: éééé.hh.nn 60-66 7 char Filler Szóköz 67-76 10 char Dátum Az állomány készítésének napja 77-79 3 char Filler Szóköz Formátum: 80-109 30 num HU9999999999-99999999-99999999 99999999-99999999-99999999, számlaszáma 99999999-99999999 vagy 110-112 3 char Elszámolás pénzneme EUR vagy USD 7
1.3.3 Adatrekord 1-16 16 char OTP egyedi Az OTP Bank által (könyveléskor) adott egyedi azonosító tranzakcióazonosító 17-19 3 char Filler Szóköz 20-27 8 char Terminál kód A POS terminál OTP-s azonosítója 28-29 2 char Filler Szóköz 30-35 6 char Authorizációs Az authorizációs rendszer által generált egyedi kód azonosító 36-38 3 char Filler Szóköz 39-46 8 date dátuma Formátuma: ééééhhnn 47-48 2 char Filler Szóköz 49-54 6 char időpontja Formátuma: óóppmm 55-56 2 char Filler Szóköz 57-75 19 char Kártyaszám Maximum 19 jegyű kártyaszám Az első 6 és az utolsó 4 jegy megjelenítve, a többi jegy * -al behelyettesítve. Jobbra igazítva. 76-79 4 char Filler Szóköz 80 1 char Előjel Szóköz vagy a következő mezőtől függően 81-90 10 num A tranzakció összege az elszámolás összege pénznemében 91-96 6 char Filler Szóköz 97 1 char Előjel Szóköz vagy a következő mezőtől függően 98-105 8 num Bankközi díj A bankközi díj (interchange díj) összege az elszámolás pénznemében 106-111 6 char Filler Szóköz 112 1 char Előjel Szóköz vagy a következő mezőtől függően 113-120 8 num Kártyatársasági A kártyatársasági díj összege az elszámolás díj pénznemében 121-126 6 char Filler Szóköz 127 1 char Előjel Szóköz vagy a következő mezőtől függően 128-135 8 num Banki marzs A banki marzs összege az elszámolás pénznemében 136-141 6 char Filler Szóköz 142 1 char Előjel Szóköz vagy a következő mezőtől függően 143-150 8 num Jutalék A jutalék összege az elszámolás pénznemében 151-154 4 char Filler Szóköz 155 1 char Előjel Szóköz vagy a következő mezőtől függően 156-165 10 num Nettó összeg = (tranzakció összege jutalék), az elszámolás pénznemében 166-168 3 char Filler Szóköz 169 1 char jelző 170-172 3 char Filler Szóköz 173-202 30 char Üzlet neve Cashback tranzakció esetén értéke: K, Partner program tr. esetén P, partner kedvezmény tr. esetén R Egyéb esetben (space) 8
203-205 3 char Filler Szóköz 206-237 32 char Külső egyedi A kereskedő által előállított és OTP felé küldött azonosító azonosító 238-240 3 char Filler Szóköz 241-242 2 char BINF Kártyatípus (értékkészletet lásd külön) 243-245 3 char Filler Szóköz 1.3.4 Zárórekord 1-2 2 char Konstans FT "FT" - File Trailer 3 1 char Filler Szóköz 4-12 9 char kódja Az OTP Bank által adott egyedi azonosítószám 13-15 3 char Filler Szóköz 16-25 10 date Dátum Az állomány készítésének napja 26-28 3 char Filler Szóköz 29-36 8 num Feldolgozott A file-ban szereplő tranzakció sorok száma, rekordok előnullázva száma 37-43 7 char Filler Szóköz 44 1 char Előjel Szóköz vagy a következő mezőtől függően 45-54 10 num Összes nettó A file tranzakció soraiban szereplő nettó összegek összeg együttes értéke az elszámolás pénznemében 9
1.4 K05D formátum 1.4.1 Általános információk Kódlap: char típusú mezők: num típusú mezők: Összeg mezők: ISO-8859-2 Balra igazított, jobbról szóközzel feltöltött mezők (a kivételek az adott mezőnél jelezve) Jobbra igazított, balról 0-kkal feltöltött mezők Forintban értendők, tizedes nélkül. Pozitív összeg esetén az előjel helyén space van. Negatív összeg esetén előjel szerepel. Az adatrekordokban az összeg mezők (megelőző szóköz és előjel mezővel vett együttes) hossza: 15 karakter Megjegyzés: A 2015.11.09-ig K005 kódon futó analitikából, a tranzakciót terhelő díj oszlopokkal bővített formátum. 1.4.2 Fejrekord 1-2 2 char Konstans FH "FH" - File Header 3 1 char Filler Szóköz 4-12 9 char Az OTP Bank által adott egyedi azonosítószám kódja 13-15 3 char Filler Szóköz 16-45 30 char neve 46-49 4 char Filler Szóköz 50-59 10 char Iktatószám Az OTP Bank rendszerében használt iktatószám, felépítése: éééé.hh.nn 60-66 7 char Filler Szóköz 67-76 10 char Dátum Az állomány készítésének napja 77-79 3 char Filler Szóköz Formátum: 80-109 30 num HU9999999999-99999999-99999999 99999999-99999999-99999999, számlaszáma 99999999-99999999 vagy 110-112 3 char Elszámolás pénzneme HUF 10
1.4.3 Adatrekord 1-16 16 char OTP egyedi Az OTP Bank által (könyveléskor) adott egyedi azonosító tranzakció azonosító 17-19 3 char Filler Szóköz 20-27 8 char Terminál kód A POS terminál OTP-s azonosítója 28-29 2 char Filler Szóköz 30-35 6 char Authorizációs Az authorizációs rendszer által generált egyedi kód azonosító 36-38 3 char Filler Szóköz 39-46 8 date dátuma Formátuma: ééééhhnn 47-48 2 char Filler Szóköz 49-54 6 char időpontja Formátuma: óóppmm 55-56 2 char Filler Szóköz 57-75 19 char Kártyaszám Maximum 19 jegyű kártyaszám Az első 6 és az utolsó 4 jegy megjelenítve, a többi jegy * -al behelyettesítve. Jobbra igazítva. 76-79 4 char Filler Szóköz 80 1 char Előjel Szóköz vagy a következő mezőtől függően 81-90 10 num összege A tranzakció összege forintban 91-96 6 char Filler Szóköz 97 1 char Előjel Szóköz vagy a következő mezőtől függően 98-105 8 num Bankközi díj A bankközi díj (interchange díj) összege forintban 106-111 6 char Filler Szóköz 112 1 char Előjel Szóköz vagy a következő mezőtől függően 113-120 8 num Kártyatársasági A kártyatársasági díj összege forintban díj 121-126 6 char Filler Szóköz 127 1 char Előjel Szóköz vagy a következő mezőtől függően 128-135 8 num Felár A felár összege forintban 136-141 6 char Filler Szóköz 142 1 char Előjel Szóköz vagy a következő mezőtől függően 143-150 8 num Jutalék A jutalék összege forintban 151-154 4 char Filler Szóköz 155 1 char Előjel Szóköz vagy a következő mezőtől függően 156-165 10 num Nettó összeg = (tranzakció összege jutalék) forintban 166-168 3 char Filler Szóköz 169 1 char jelző 170-172 3 char Filler Szóköz 173-202 30 char Üzlet neve 203-205 3 char Filler Szóköz Értéke Cashback tranzakció esetén: K, DCC tranzakció esetén: D, Partner program tr. esetén P, partner kedvezmény tr. esetén R Egyéb esetben (space) 11
206-237 32 char Külső egyedi A kereskedő által előállított és OTP felé küldött azonosító azonosító 238-240 3 char Filler Szóköz 241-242 2 char BINF Kártyatípus (értékkészletet lásd külön) 243 1 char Filler Szóköz 244-247 4 char Program kód Interchange fee program code 248-251 4 char Int. kártyatípus Interchange kártya típus most konstans space 1.4.4 Zárórekord 1-2 2 char Konstans FT "FT" - File Trailer 3 1 char Filler Szóköz 4-12 9 char kódja Az OTP Bank által adott egyedi azonosítószám 13-15 3 char Filler Szóköz 16-25 10 date Dátum Az állomány készítésének napja 26-28 3 char Filler Szóköz 29-36 8 num Feldolgozott A file-ban szereplő tranzakció sorok száma, rekordok előnullázva száma 37-43 7 char Filler Szóköz 44 1 char Előjel Szóköz vagy a következő mezőtől függően 45-54 10 num Összes nettó A file tranzakció soraiban szereplő nettó összegek összeg együttes értéke forintban 12
2 Melléklet BINF mező értékkészlete BINF mező értéke BINF megnevezés 9 OTP Mastercard Maestro kártya 10 OTP Mastercard debit kártya 11 OTP Mastercard credit kártya 12 OTP Mastercard commercial kártya 13 OTP Amex kártya 14 OTP saját logós kártya 15 OTP Visa Electron kártya 16 OTP Visa debit kártya 17 OTP Visa credit kártya 18 OTP Visa VPAY kártya 19 OTP Visa commercial kártya 20 Belföldi Mastercard Maestro kártya 21 Belföldi Mastercard debit kártya 22 Belföldi Mastercard credit kártya 23 Belföldi Amex kártya 24 Belföldi Mastercard commercial kártya 25 Belföldi Visa Electron kártya 26 Belföldi Visa debit kártya 27 Belföldi Visa credit kártya 28 Belföldi Visa VPAY kártya 29 Belföldi Visa commercial kártya 30 Külföldi Mastercard Maestro kártya 31 Külföldi Mastercard debit kártya 32 Külföldi Mastercard credit kártya 33 Külföldi Amex kártya 34 Külföldi Mastercard commercial kártya 35 Külföldi Visa Electron kártya 36 Külföldi Visa debit kártya 37 Külföldi Visa credit kártya 38 Külföldi Visa VPAY kártya 39 Külföldi Visa commercial kártya 45 JCB kártya 55 CUP kártya 13