A visszatérítési tranzakció lehetővé teszi a pénz visszatérítését az ügyfél bármely kártyájára anélkül, hogy fel kellene kutatni a korábbi értékesítési tranzakciót.
A visszatérés menete a következő:
Visszatérés létrehozása
A tranzakciót a következő parancs kiadásával indítható el:
gptom://transaction/refund?…
ahol a jelentés összeállításához a következő paramétereket használják, beleértve az amsID-t is, amelyet minden egyes fizetéshez hozzárendelnek:
Változó/mező
Formátum
Leírás
Példa
összeg
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 vállalat egyedi azonosítója, amelyet az alkalmazásban vagy az üdvözlő e-mailben kap meg.
EN: A vállalat egyedi azonosítója, amelyet az alkalmazásban vagy az üdvözlő e-mailben kap meg.
EN: A vállalat egyedi azonosítója, amelyet az alkalmazásban vagy az üdvözlő e-mailben 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
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.
EN: 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 összekapcsolásához.
EN: 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 összekapcsolásához.
abc123
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
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
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/refund?amount=1000&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/refund&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
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
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
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