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ő parancs kiadásával indítható el:
gptom://transaction/create?…
ahol a jelentés összeállításához a következő paramétereket használják:
Változó/mező
Formátum
Leírás
Példa
összeg
KÖTELEZŐ
KÖTELEZŐ
hosszú
CZ: A tranzakció összege két tizedesjegy pontossággal.
EN: A tranzakció összege két tizedesjegy pontossággal.
EN: A tranzakció összege két tizedesjegy pontossággal.
1000 (=10 CZK/EUR)
clientID
string
CZ: A bejelentkezett felhasználó opcionális ellenőrzése. Itt a terminál API-kulcsát ellenőrzik.
EN: A bejelentkezett felhasználó opcionális ellenőrzése. Itt a terminál API-kulcsát ellenőrzik.
EN: A bejelentkezett felhasználó opcionális ellenőrzése. Itt a terminál API-kulcsát ellenőrzik.
originReferenceNum
string
CZ: Legfeljebb 20 karakterből álló hivatkozási szám – alkalmas számlaszámokhoz, befizetésekhez – felhasználható a befizetések és az értékesítések vagy megrendelések közötti összekapcsoláshoz.
Hivatkozási szám (legfeljebb 20 karakter) – számlaszámhoz, fizetéshez alkalmas – felhasználható a fizetések és az értékesítések vagy megrendelések összehangolásához.
Hivatkozási szám (legfeljebb 20 karakter) – számlaszámhoz, fizetéshez alkalmas – felhasználható a fizetések és az értékesítések vagy megrendelések összehangolásához.
printByPaymentApp
bool
CZ: Meghatározza, hogy az alkalmazásod vagy a Genius mobile pay adja-e át a számlát az ügyfélnek. Az alapértelmezett érték true (vagyis a Genius mobile pay kínálja fel a számla átadásának módját az ügyfélnek). Ha “false” értéket ad meg, a tranzakciót követően azonnal visszavezetjük a felhasználót az Ön alkalmazásába, és a számla átadása az Ön feladata.
Meghatározza, hogy az alkalmazásod vagy a Genius mobile pay továbbítja-e a nyugtát az ügyfélnek. Az alapértelmezett érték "true" (azaz a GP biztosítja a nyugta ügyfélnek történő továbbításának lehetőségét). Ha „false” értéket ad meg, a tranzakciót követően azonnal visszavezetjük a felhasználót az Ön alkalmazásába, és az Ön feladata a nyugta továbbítása.
Meghatározza, hogy az alkalmazásod vagy a Genius mobile pay továbbítja-e a nyugtát az ügyfélnek. Az alapértelmezett érték "true" (azaz a GP biztosítja a nyugta ügyfélnek történő továbbításának lehetőségét). Ha „false” értéket ad meg, a tranzakciót követően azonnal visszavezetjük a felhasználót az Ön alkalmazásába, és az Ön feladata a nyugta továbbítása.
igaz/hamis
TipAmount
hosszú
CZ: Az éttermekben felkérheti a vendéget, hogy adjon borravalót, amennyiben a borravaló összege a rendszerében már be van állítva. Ez az összeg ezután hozzáadódik a pénztáros által eredetileg megadott összeghez.
EN: Az éttermekben megkérhetik a vendéget, hogy adjon borravalót, amelyet a rendszerbe rögzítenek. Ezt az összeget ezután hozzáadják a kereskedő által eredetileg megadott összeghez.
EN: Az éttermekben megkérhetik a vendéget, hogy adjon borravalót, amelyet a rendszerbe rögzítenek. Ezt az összeget ezután hozzáadják a kereskedő által eredetileg megadott összeghez.
1000 (=10 CZK/EUR)
átirányítási URL
string
CZ: Az alkalmazásod URL-je, ahová a fizetés befejezése után átirányítjuk az ügyfelet.
EN: Az alkalmazás URL-címe, ahová a fizetés befejezése után átirányítjuk az ügyfelet.
EN: Az alkalmazás URL-címe, ahová a fizetés befejezése után átirányítjuk az ügyfelet.
fb://success
Fő fogadásCollect
bool
CZ: Opcionális mező, amely a Genius mobile pay alkalmazásban megnyitja a borravaló megadására szolgáló képernyőt. Miután az alkalmazásban megadta a borravalót, megjelenik a kártya beolvasására szolgáló képernyő. E képernyő megjelenítéséhez az alkalmazásban a borravaló funkciót is engedélyezni kell.
EN: Egy opcionális mező, amely megnyitja a borravaló megadására szolgáló képernyőt a Genius mobile pay alkalmazásban. Miután megadta a borravalót az alkalmazásban, megjelenik a kártya csatolására szolgáló képernyő. Ahhoz, hogy ez a képernyő megjelenjen, az alkalmazásban engedélyeznie kell a borravaló adását is.
EN: Egy opcionális mező, amely megnyitja a borravaló megadására szolgáló képernyőt a Genius mobile pay alkalmazásban. Miután megadta a borravalót az alkalmazásban, megjelenik a kártya csatolására szolgáló képernyő. Ahhoz, hogy ez a képernyő megjelenjen, az alkalmazásban engedélyeznie kell a borravaló adását is.
igaz / hamis
preferableReceiptType
enum (sms, e-mail, QR-kód, nyomtatás)
HU: Ha a számlát a Genius mobile pay alkalmazásból küldi el, az API-n keresztül előre megadhatja a számla elküldésének módját. A lehetséges értékek a következők:
EN: Ha a háziorvos az alkalmazásnak küldi az igazolást, az API-n keresztül előre meg lehet határozni az igazolás elküldésének módját. A lehetséges értékek a következők:
TELEFON
EMAIL
QR
NYOMTATÁS
EN: Ha a háziorvos az alkalmazásnak küldi az igazolást, az API-n keresztül előre meg lehet határozni az igazolás elküldésének módját. A lehetséges értékek a következők:
TELEFON
QR
NYOMTATÁS
SMS
clientPhone
string
HU: Az ügyfél telefonszáma.
EN: Ügyfél telefonszáma.
EN: Ügyfél telefonszáma.
+420606505404
ügyfél e-mail címe
string
HU: Az ügyfél e-mail címe.
EN: Az ügyfél e-mail címe.
EN: Az ügyfél e-mail címe.
info@gptom.com
transactionType
string
CZ: A tranzakciótípus meghatározza, hogy milyen típusú tranzakciót kíván kezdeményezni. A rendelkezésre álló értékek a következők:
EN:A „Tranzakciótípus” meghatározza a kezdeményezni kívánt tranzakció típusát. A rendelkezésre álló értékek a következők:
KÉSZPÉNZ
KÁRTYA
ACCOUNT_PAYMENT
BLIK_FIZETÉS
PAYMENT_GATEWAY
EN:A „Tranzakciótípus” meghatározza a kezdeményezni kívánt tranzakció típusát. A rendelkezésre álló értékek a következők:
KÉSZPÉNZ
KÁRTYA
ACCOUNT_PAYMENT
BLIK_FIZETÉS
PAYMENT_GATEWAY
KÁRTYA
Hívási példa:
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 fogja tartalmazni:
Mező/Field
Formátum
Leírás
Példa
FELADAT ÁLLAPOTA
CZ: Megadja, hogy az adott kérelem milyen állapotban zárult le
EN: Információt nyújt arról, hogy a kérelem milyen státuszban van.
EN: Információt nyújt arról, hogy a kérelem milyen státuszban van.
TELJESÍTETT
ELMARAD
HIBA
ELMARAD
HIBA
terminálazonosító
CZ: Az a terminál azonosítója, amelyen a tranzakciókat feldolgozzák. Ez azonosítja a terminált a GP-rendszerekben.
EN: Az a egyedi terminál-azonosító, amelyen a tranzakció feldolgozásra kerül.
EN: Az a egyedi terminál-azonosító, amelyen a tranzakció feldolgozásra kerül.
12345678
összeg
CZ: Az összeg határozza meg a tranzakció értékét. Ezt az összeget a terminál által használt helyi pénznemben számolják ki. A napzáráskor ez tartalmazza az összes kártyás tranzakciót, a jóváírásokat és a terheléseket együttesen.
EN: Az összeg határozza meg a tranzakció volumenét. Ezt az összeget a terminál által használt helyi pénznemben számítják ki. A napzáráskor ez tartalmazza az összes kártyás tranzakciót, a jóváírásokat levonva a terhelésekből.
EN: Az összeg határozza meg a tranzakció volumenét. Ezt az összeget a terminál által használt helyi pénznemben számítják ki. A napzáráskor ez tartalmazza az összes kártyás tranzakciót, a jóváírásokat levonva a terhelésekből.
10
batchNumber
CZ: A zárási szám azonosítója. Zárás iránti kérelem esetén kell kitölteni.
EN: Meghatározza a tételszámot. A tétel lezárási művelet során jelen van.
EN: Meghatározza a tételszámot. A tétel lezárási művelet során jelen van.
1
emvAppLabel
CZ: A fizetés során használt EMV-kód neve.
EN: A használt kártya címkéje
EN: A használt kártya címkéje
Visa betéti kártya
amsID
CZ: Egyedi tranzakciós szám.
EN: Egyedi tranzakciós szám.
EN: Egyedi tranzakciós szám.
emvAid
CZ: Meghatározza a tranzakció feldolgozásához használt EMV-alkalmazást.
EN: Meghatározza a tranzakciók feldolgozásához használt EMV-alkalmazást.
EN: Meghatározza a tranzakciók feldolgozásához használt EMV-alkalmazást.
A0000000031010
referenceNumber
CZ: A fizetési kérelem benyújtásakor megadott hivatkozási szám.
EN: A fizetés során megadott hivatkozási szám
EN: A fizetés során megadott hivatkozási szám
ABC123
sequenceNumber
CZ: Tranzakciók visszavonására szolgál. Használja azt az értéket, amelyet a visszavonni kívánt tranzakcióban kapott.
EN: Tranzakció visszavonására szolgál. A visszavonni kívánt tranzakció részét képező, beérkezett értéket használja fel.
EN: Tranzakció visszavonására szolgál. A visszavonni kívánt tranzakció részét képező, beérkezett értéket használja fel.
001000000
cardType
CZ: Meghatározza a használt kártyatípust.
EN: Meghatározza a használt kártya típusát.
EN: Meghatározza a használt kártya típusát.
VISA
MASTER
MASTER
transactionType
CZ: Meghatározza a tranzakció típusát.
EN: Meghatározza a tranzakció típusát.
EN: Meghatározza a tranzakció típusát.
KÁRTYA
dátum
CZ: A tranzakció időpontját jelzi.
EN: Adja meg a tranzakció dátumát.
EN: Adja meg a tranzakció dátumát.
2024-10-29T12:14:00.112Z
currencyCode
CZ: Háromjegyű ISO-valutakódok – a listát a Wiki-oldalon találja meg.
EN: Három karakterből álló pénznem-ISO-kód.
EN: Három karakterből álló pénznem-ISO-kód.
EUR
merchantID
CZ: A kereskedő egyedi azonosítója, amely általában a telephely azonosítóját jelenti.
EN: Egyedi kereskedői azonosító, általában helyazonosító
EN: Egyedi kereskedői azonosító, általában helyazonosító
TipAmount
CZ: Borravaló. Akkor kerül kitöltésre, ha megadták.
EN: Tipp. Szükség esetén töltse ki.
EN: Tipp. Szükség esetén töltse ki.
2
totalAmount
CZ: A tranzakció teljes összegét jelzi (a borravalót is beleértve)
EN: A tranzakció teljes összegét jelzi (borravalóval együtt)
EN: A tranzakció teljes összegét jelzi (borravalóval együtt)
12
eredmény
CZ: Válasz a kérelemre.
EN: A kérésre adott válasz.
EN: A kérésre adott válasz.
0 – jóváhagyott tranzakció
-1 – elutasított tranzakció
-1 – elutasított tranzakció
cardEntryMode
CZ: Meghatározza a kártyaadatok megadásának módját, például chip, érintésmentes, mágnescsík stb.
EN: Meghatározza, hogy a kártyát hogyan olvasták be: mágnescsíkkal, chip segítségével vagy érintésmentesen.
EN: Meghatározza, hogy a kártyát hogyan olvasták be: mágnescsíkkal, chip segítségével vagy érintésmentesen.
CONTACTLESS
tranzakcióazonosító
CZ: Ezt a mezőt csak akkor kell kitölteni, ha a tranzakció jóváhagyottként zárul.
EN: Csak akkor van jelen, ha a tranzakció feldolgozásra került.
EN: Csak akkor van jelen, ha a tranzakció feldolgozásra került.
123456
authorizationCode
CZ: A fizetési alkalmazás által a tranzakció regisztrációja során generált egyedi azonosító.
EN: A fizetési alkalmazás által a tranzakció regisztrációja során generált egyedi azonosító.
EN: A fizetési alkalmazás által a tranzakció regisztrációja során generált egyedi azonosító.
001000000
pinOk
igaz/hamis
kártyaszám
CZ: Kártyaszám (PAN). Rejtett formában szerepel.
EN: Kártyaszám (PAN). Maszkolt formában szerepel.
EN: Kártyaszám (PAN). Maszkolt formában szerepel.
0001
dccData:
státusz
CZ: A DCC állapotát jelzi. Ha "ELFOGADVA", a tranzakció DCC-n keresztül történt, és a bizonylatot ki kell tölteni a DCC-adatokkal. Ha "NOT_ACCEPTED", akkor figyelmen kívül hagyhatja a DCC-adatokat.
HU: A DCC állapotát jelzi. Ha "ELFOGADVA", a tranzakció DCC-n keresztül történt, és a nyugtát ki kell töltenie a DCC-adatokkal. Ha "NOT_ACCEPTED", akkor figyelmen kívül hagyhatja a DCC-adatokat.
HU: A DCC állapotát jelzi. Ha "ELFOGADVA", a tranzakció DCC-n keresztül történt, és a nyugtát ki kell töltenie a DCC-adatokkal. Ha "NOT_ACCEPTED", akkor figyelmen kívül hagyhatja a DCC-adatokat.
ELFOGADVA
NOT_ACCEPTED
NOT_ACCEPTED
valuta
CZ: Ügyfélkártya pénzneme.
HU: Az ügyfélkártya pénzneme.
HU: Az ügyfélkártya pénzneme.
CZK
összeg
CZ: A tranzakció összege DCC-valutában – az ügyfél kártyájának valutájában. Ezt pontosan úgy kell megjeleníteni, ahogyan az az API-válaszban szerepel, a tizedesjegyek számát is beleértve.
EN: A tranzakció összege DCC-valutában – az ügyfél kártyájának valutájában. Ezt a nyugtán pontosan úgy kell feltüntetni, ahogyan az API-válaszban megkapta, a tizedesjegyek pontos megadásával együtt.
EN: A tranzakció összege DCC-valutában – az ügyfél kártyájának valutájában. Ezt a nyugtán pontosan úgy kell feltüntetni, ahogyan az API-válaszban megkapta, a tizedesjegyek pontos megadásával együtt.
61.02
jelölés
CZ: Az átváltási árfolyamhoz hozzáadott felár. Ezt pontosan úgy kell megjeleníteni, ahogyan az az API-válaszban szerepel, a tizedesjegyek számát is beleértve.
EN: A konverziós arány jelölése. Ezt a nyugtán pontosan úgy kell feltüntetni, ahogyan az API-válaszban megkapta, a tizedesjegyek pontos megadásával együtt.
EN: A konverziós arány jelölése. Ezt a nyugtán pontosan úgy kell feltüntetni, ahogyan az API-válaszban megkapta, a tizedesjegyek pontos megadásával együtt.
9.9
árfolyam
CZ: Az árfolyamot jelzi. Ez az érték a terminál helyi pénznemében van megadva. Pontosan úgy kell megjeleníteni, ahogyan az API-válaszban szerepel, a tizedesjegyek számát is beleértve.
EN: Az árfolyamot jelzi. Ez az érték a helyi terminál pénznemében van megadva. A nyugtán pontosan úgy kell feltüntetnie, ahogyan az API-válaszban megkapta, a tizedesjegyek pontos megadásával együtt.
EN: Az árfolyamot jelzi. Ez az érték a helyi terminál pénznemében van megadva. A nyugtán pontosan úgy kell feltüntetnie, ahogyan az API-válaszban megkapta, a tizedesjegyek pontos megadásával együtt.
24.567
regionSchemaIndicator
CZ: Megadja, hogy az ügyfél kártyáját az EU-n belül vagy azon kívül állították-e ki. Ha az érték "0" vagy "1", akkor a nyugtán fel kell tüntetni a "Markup" szöveget. Ha az érték "2", akkor a nyugtán fel kell tüntetni a "Markup over ECB rate” szöveget.
EN: Jelzi, hogy az ügyfél kártyáját az EU-n belül vagy kívül állították-e ki. Ha az érték "0" vagy "1", akkor a nyugtán fel kell tüntetni a "Felár" szöveget. Ha az érték "2", akkor a nyugtán fel kell tüntetni a "Felár az EKB-kamatláb felett" szöveget.
EN: Jelzi, hogy az ügyfél kártyáját az EU-n belül vagy kívül állították-e ki. Ha az érték "0" vagy "1", akkor a nyugtán fel kell tüntetni a "Felár" szöveget. Ha az érték "2", akkor a nyugtán fel kell tüntetni a "Felár az EKB-kamatláb felett" szöveget.
0
1
2
1
2
CODE
CZ: Megjeleníti az engedélyezési tranzakció eredményét.
EN: Megjeleníti a tranzakció eredményét az engedélyezési oldalon.
EN: Megjeleníti a tranzakció eredményét az engedélyezési oldalon.
elfogadva