Az értékesítési tranzakció egy olyan alapvető fizetési művelet, amely egy meghatározott összeget utal át a kártyabirtokos bankszámlájáról a kereskedő számlájára.
Ami a fizetési folyamatot illeti, az eljárás a következő:
Tranzakció létrehozása
A tranzakciót a következő hívással lehet kezdeményezni:
gptom://transaction/create?…
ahol a következő paramétereket használjuk a jelentés összeállításához:
Változó/Mező
Formátum/Formátum
Leírás/leírás
Példa
összeg
KÖTELEZŐ
KÖTELEZŐ
hosszú
CZ: Tranzakció összege két tizedesjegy pontossággal.
HU: Tranzakció összege két tizedesjegy pontossággal.
HU: Tranzakció összege két tizedesjegy pontossággal.
1000 (=10CZK/EURO)
clientID
string
originReferenceNum
string
CZ: Hivatkozási szám legfeljebb 20 karakter - alkalmas számlaszámra, fizetésre - használható az értékesítéshez vagy megrendelésekhez tartozó fizetésekhez.
Hivatkozási szám legfeljebb 20 karakter - alkalmas számlaszámhoz, kifizetéshez - használható a kifizetések és az eladások vagy megrendelések összevetéséhez.
Hivatkozási szám legfeljebb 20 karakter - alkalmas számlaszámhoz, kifizetéshez - használható a kifizetések és az eladások vagy megrendelések összevetéséhez.
printByPaymentApp
bool
CZ: Meghatározza, hogy a nyugtát az Ön alkalmazása vagy a GP tom adja át az ügyfélnek. Az alapértelmezett érték true (azaz a GP tom felajánlja a nyugta átadásának módszerét az ügyfélnek). Ha a "false" értéket küldöd, akkor a tranzakció után azonnal visszaadjuk a felhasználónak az alkalmazásodnak, és a nyugta átadása már a te feladatod.
Meghatározza, hogy a nyugtát az Ön alkalmazása vagy a GP tom adja át az ügyfélnek. Az alapértelmezett érték true (azaz a GP tom felajánlja a nyugta átadásának módját az ügyfélnek). Ha "false" értéket küld, akkor a tranzakció után azonnal visszaadjuk a felhasználót az alkalmazásodnak, és a nyugta átadása rajtad múlik.
Meghatározza, hogy a nyugtát az Ön alkalmazása vagy a GP tom adja át az ügyfélnek. Az alapértelmezett érték true (azaz a GP tom felajánlja a nyugta átadásának módját az ügyfélnek). Ha "false" értéket küld, akkor a tranzakció után azonnal visszaadjuk a felhasználót az alkalmazásodnak, és a nyugta átadása rajtad múlik.
igaz/hamis
TipAmount
hosszú
CZ: Éttermekben megkérheti a vendéget, hogy adjon borravalót, ahol a borravaló az Ön rendszeréből kerül bevitelre. Ez az összeg aztán hozzáadódik a kereskedő által eredetileg beírt összeghez.
HU: Éttermekben kérheti a vásárlót, hogy adjon borravalót, ahol a borravaló az Ön rendszerében kerül beírásra. Ez az összeg ezután hozzáadódik a kereskedő által eredetileg bevitt összeghez.
HU: Éttermekben kérheti a vásárlót, hogy adjon borravalót, ahol a borravaló az Ön rendszerében kerül beírásra. Ez az összeg ezután hozzáadódik a kereskedő által eredetileg bevitt összeghez.
1000 (=10CZK/EURO)
redirectUrl
string
CZ: Az alkalmazás URL címe, ahová a fizetés befejezése után átirányítjuk az ügyfelet.
HU: Az Ön alkalmazásának URL címe, amelyre a fizetés befejezése után átirányítjuk az ügyfelet.
HU: Az Ön alkalmazásának URL címe, amelyre a fizetés befejezése után átirányítjuk az ügyfelet.
fb://success
tipCollect
bool
CZ: Választható mező, amely a GP tom alkalmazásban megjeleníti a borravaló beviteli képernyőt. Miután beírta a borravalót az alkalmazásban, megjelenik a kártya csatolásának képernyője. Ahhoz, hogy ez a képernyő megjelenjen, az alkalmazásban is engedélyezve kell lennie a borravalónak.
HU: Egy opcionális mező, amely a borravaló beviteli képernyőt jeleníti meg a GP tom alkalmazásban. A borravalónak az alkalmazásban történő beírása után megjelenik a kártya csatolásának képernyője. Ehhez a képernyő megjelenítéséhez az alkalmazásban is engedélyezve kell lennie a borravalónak.
HU: Egy opcionális mező, amely a borravaló beviteli képernyőt jeleníti meg a GP tom alkalmazásban. A borravalónak az alkalmazásban történő beírása után megjelenik a kártya csatolásának képernyője. Ehhez a képernyő megjelenítéséhez az alkalmazásban is engedélyezve kell lennie a borravalónak.
igaz / hamis
preferableReceiptType
enum (sms,email,qr,print)
CZ: A GP tom alkalmazásból történő nyugta küldés esetén lehetőség van a nyugta API-n keresztül történő küldésének módját előre meghatározni.
Lehetséges értékek: HU: A GP tom alkalmazásból történő nyugta küldés esetén lehetőség van a nyugta API-n keresztül történő küldésének módját előre meghatározni.
A lehetséges értékek: PHONE EMAIL QR PRINT
Lehetséges értékek: HU: A GP tom alkalmazásból történő nyugta küldés esetén lehetőség van a nyugta API-n keresztül történő küldésének módját előre meghatározni.
A lehetséges értékek: PHONE EMAIL QR PRINT
szöveg
ügyfélTelefon
string
CZ: Az ügyfél telefonszáma.
HU: Az ügyfél telefonszáma.
HU: Az ügyfél telefonszáma.
+420606505404
clientEmail
string
CZ: Az ügyfél e-mail címe.
HU: Az ügyfél e-mail címe.
HU: Az ügyfél e-mail címe.
info@gptom.com
transactionType
string
HU: A tranzakció típusa határozza meg a kezdeményezni kívánt tranzakció típusát.
A rendelkezésre álló értékek a következők: HU: Tranzakció típusa meghatározza a kezdeményezni kívánt tranzakció típusát.
A rendelkezésre álló értékek: KÉSZPÉNZKÁRTYA
A rendelkezésre álló értékek a következők: HU: Tranzakció típusa meghatározza a kezdeményezni kívánt tranzakció típusát.
A rendelkezésre álló értékek: KÉSZPÉNZKÁRTYA
KÉSZPÉNZ/KÁRTYA
Példa hívás:
gptom://transaction/create?originReferenceNum=12345&amount=2&clientID=123&tipCollect=true&preferableReceiptType=QR&redirectUrl=gp://transaction/create&printByPaymentApp=true&clientPhone=+420606505404&clientEmail=info@gptom.com&tipAmount=1
A válasz a következő mezőket tartalmazza:
Mező/Mező
Formátum
Leírás/leírás
Példa/példa
FELADAT ÁLLAPOT
HU: Információt ad arról, hogy melyik államban ért véget a kérése. HU: Információt ad arról, hogy melyik államban ért véget a kérése.
BEFEJEZETT TÖRÖLT HIBA
terminalID
CZ: annak a terminálnak az azonosítója, amelyen a tranzakciókat feldolgozzák.
Azonosítja a terminált a GP rendszerekben. HU: Egyedi terminálazonosító, amelyen a tranzakciót feldolgozzák.
Azonosítja a terminált a GP rendszerekben. HU: Egyedi terminálazonosító, amelyen a tranzakciót feldolgozzák.
12345678
összeg
CZ: Az összeg határozza meg a tranzakció volumenét. Ez az összeg a terminál által használt hazai pénznemben kerül kiszámításra. Egy zárás esetében magában foglalja az összes kártyatranzakciót, jóváírva mínusz terhelve.
HU: Az összeg határozza meg a tranzakció volumenét. Ez az összeg a terminál által használt hazai pénznemben kerül kiszámításra. Zárónapon tartalmazza az összes kártyatranzakciót, jóváírva mínusz terhelve.
HU: Az összeg határozza meg a tranzakció volumenét. Ez az összeg a terminál által használt hazai pénznemben kerül kiszámításra. Zárónapon tartalmazza az összes kártyatranzakciót, jóváírva mínusz terhelve.
10
batchNumber
CZ: A zárószámot azonosítja. Akkor kell kitölteni, ha határidőt kérnek.
HU: Meghatározza a tételszámot. Jelen van a záró tétel tranzakció során.
HU: Meghatározza a tételszámot. Jelen van a záró tétel tranzakció során.
1
emvAppLabel
CZ: A fizetés során használt EMV neve.
HU: A használt kártya címkéje
HU: A használt kártya címkéje
Visa Debit
amsID
CZ: Egyedi tranzakciós szám.
HU: Egyedi tranzakciós szám.
HU: Egyedi tranzakciós szám.
emvAid
CZ: A tranzakció feldolgozásához használt EMV-alkalmazást azonosítja.
HU: A tranzakció feldolgozásához használt EMV-alkalmazást azonosítja.
HU: A tranzakció feldolgozásához használt EMV-alkalmazást azonosítja.
A0000000031010
referenceNumber
CZ: A kifizetés igénylésekor megadott hivatkozási szám.
HU: A kifizetési kérelem során megadott hivatkozási szám.
HU: A kifizetési kérelem során megadott hivatkozási szám.
ABC123
sequenceNumber
CZ: Törlési tranzakciókhoz használatos. Használja azt a kapott értéket, amely a törlendő tranzakció része volt.
HU: Tranzakció törléséhez használatos. Azt a kapott értéket használja, amely a törlendő tranzakció része volt.
HU: Tranzakció törléséhez használatos. Azt a kapott értéket használja, amely a törlendő tranzakció része volt.
001000000
cardType
CZ: A használt kártya típusát azonosítja.
HU: A használt kártya típusát azonosítja.
HU: A használt kártya típusát azonosítja.
VISA MASTER
transactionType
HU: Meghatározza a tranzakció típusát.
HU: Meghatározza a tranzakció típusát.
HU: Meghatározza a tranzakció típusát.
KÁRTYA
dátum
CZ: A tranzakció időpontját jelzi.
HU: A tranzakció dátumát adja meg.
HU: A tranzakció dátumát adja meg.
2024-10-29T12:14:00.112Z
currencyCode
CZ: Háromjegyű ISO valutakódok - a listát lásd a Wiki oldalon.
HU: Háromjegyű valuta ISO-kód.
HU: Háromjegyű valuta ISO-kód.
EUR
merchantID
CZ: Egyedi kereskedői azonosító, általában helyazonosító. HU: Egyedi kereskedői azonosító, általában helyazonosító.
TipAmount
CZ: Tippek. Kitöltve, ha már be lett írva.
HU: Borravaló. Szükség esetén kitöltve.
HU: Borravaló. Szükség esetén kitöltve.
2
totalAmount
CZ: A tranzakció teljes összegét jelzi (borravalóval együtt) HU: A tranzakció teljes összegét jelzi (borravalóval együtt)
12
eredmény
CZ: Válasz a kérésre.
HU: A kérelemre adott válasz.
HU: A kérelemre adott válasz.
0 - jóváhagyott tranzakció -1 - elutasított tranzakció
cardEntryMode
CZ: Meghatározza, hogy a kártyaadatokat hogyan adták meg, például chip, érintésmentes, magisztrális csík stb. HU: Meghatározza, hogy a kártyát hogyan olvasták le: magisztrális csík, chip vagy érintésmentes.
KAPCSOLATLAN
transactionID
CZ: Csak akkor kell kitölteni, ha a tranzakciót végül jóváhagyják.
HU: Csak akkor van jelen, ha a tranzakciót feldolgozták.
HU: Csak akkor van jelen, ha a tranzakciót feldolgozták.
123456
authorizationCode
CZ: A fizetési alkalmazás által a tranzakció regisztrációja során generált egyedi azonosító.
HU: A fizetési alkalmazás által a tranzakció regisztrációja során generált egyedi azonosító.
HU: A fizetési alkalmazás által a tranzakció regisztrációja során generált egyedi azonosító.
001000000
pinOk
igaz/hamis
cardNumber
CZ: Kártyaszám (PAN). Maszkolt formában van jelen.
HU: Kártyaszám (PAN). maszkolt formában van jelen.
HU: Kártyaszám (PAN). maszkolt formában van jelen.
0001
CODE
CZ: Megjeleníti a tranzakció eredményét az engedélyezéskor.
HU: Megjeleníti a tranzakció eredményét az engedélyezési oldalon.
HU: Megjeleníti a tranzakció eredményét az engedélyezési oldalon.
elfogadott