A tranzakció visszavonása az alapvető fizetési műveletek közé tartozik, amely biztosítja a már végrehajtott fizetési tranzakció visszatervezését a kártyatulajdonos számlájára.
A lemondás menete a következő:
Visszavonás létrehozása
A tranzakciót a következő parancs kiadásával indítható el:
gptom://transaction/cancel?…
ahol a jelentés összeállításához a következő paramétereket használják, beleértve az amsID, amelyet minden fizetéshez hozzárendelnek:
Változó/mező
Formátum
Leírás
Példa
clientID
string
amsID
KÖTELEZŐ
KÖTELEZŐ
string
CZ: Az egyedi amsID, amelyet a fizetéskor kap meg.
EN: Az egyedi amsID, amelyet a fizetés után kap meg.
EN: Az egyedi amsID, amelyet a fizetés után kap meg.
átirányítási URL
string
CZ: Az alkalmazás URL-címe, ahová a visszavonás befejezése után átirányítjuk az ügyfelet.
EN: Az alkalmazás URL-címe, ahová a lemondás befejezése után átirányítjuk az ügyfelet.
EN: Az alkalmazás URL-címe, ahová a lemondás befejezése után átirányítjuk az ügyfelet.
fb://Success
preferableReceiptType
enum (sms, e-mail, QR-kód, nyomtatás)
HU: Ha a számlát a GP 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
printByPaymentApp
bool
CZ: Meghatározza, hogy az alkalmazásod vagy a GP tom adja-e át a számlát az ügyfélnek. Az alapértelmezett érték true (vagyis a GP tom 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.
EN: Meghatározza, hogy az alkalmazásod vagy a GP továbbítja-e a nyugtát az ügyfélnek. Az alapértelmezett érték "true" (azaz a GP biztosítja a nyugta továbbításának lehetőségé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 az Ön feladata a nyugta továbbítása.
EN: Meghatározza, hogy az alkalmazásod vagy a GP továbbítja-e a nyugtát az ügyfélnek. Az alapértelmezett érték "true" (azaz a GP biztosítja a nyugta továbbításának lehetőségé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 az Ön feladata a nyugta továbbítása.
igaz/hamis
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
Hívási példa:
gptom://transaction/cancel?amsID=123&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/cancel&clientEmail=info@gptom.com
A válasz a következő mezőket fogja tartalmazni:
Mező/Field
Leírás/Decription
Példa
FELADAT ÁLLAPOTA
HU: 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.
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
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óval együtt).
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 = befejezve
-1 = elutasítva
-1 = elutasítva
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: 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
authorizationCode
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
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
pinOk
igaz/hamis
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
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.
jóváhagyott