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