Transakce návrat umožňuje vrátit peníze na jakoukoliv kartu zákazníka bez potřeby dohledání předešlé prodejní transakce.
Průběh návratu je následující:
Vytvoření návratu
A tranzakciót a következő parancs kiadásával indítható el:
gptom://transaction/refund?…
kde jsou použity následující parametry pro sestavení zprávy včetně amsID, které je přiděleno pro každou platbu:
Változó/mező
Formátum
Leírás
Példa
összeg
long
CZ: Částka transakce s dvěma desetinnými místy.
EN: Transaction amount with two decimal places.
EN: Transaction amount with two decimal places.
1000 (=10CZK/EUR)
clientID
string
CZ: Unikátní ID společnosti, které získáte v aplikaci nebo ve welcome emailu.
EN: The unique ID of the company that you will receive in the application or welcome email.
EN: The unique ID of the company that you will receive in the application or welcome email.
átirányítási URL
string
CZ: URL vaší aplikace na kterou přesměrujeme klienta po dokončení storna.
EN: The URL of your application to which we will redirect the client after the cancellation is complete.
EN: The URL of your application to which we will redirect the client after the cancellation is complete.
fb://Success
originReferenceNum
string
CZ: Referenční číslo až 20 znaků - vhodné pro číslo faktury, platby - je možné použít pro vaše párování platby k prodejům či objednávkám.
EN: Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
EN: Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
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:
Pole/Field
Popis/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
terminalID
CZ: ID terminálu, na kterém jsou transakce zpracovávány. Identifikuje terminál v systémech GP.
EN: Unique terminal ID, on which the transaction is processed.
EN: Unique terminal ID, on which the transaction is processed.
12345678
összeg
CZ: Částka určuje objem transakce. Tato částka se počítá v domácí měně, kterou používá terminál. U uzávěrky obsahuje všechny karetní transakce, připsané mínus debetní.
EN: The amount determines the volume of the transaction. This amount is calculated in the domestic currency used by the terminal. At close day, it contains all card transactions, credited minus debit.
EN: The amount determines the volume of the transaction. This amount is calculated in the domestic currency used by the terminal. At close day, it contains all card transactions, credited minus debit.
10
batchNumber
CZ: Identifikuje číslo uzávěrky. Vyplňuje se v případě požadavku na uzávěrku.
EN: Defines batch number. Present during the close batch transaction.
EN: Defines batch number. Present during the close batch transaction.
1
emvAppLabel
CZ: Název EMV, které bylo použito při platbě.
EN: Card label of used card
EN: Card label of used card
Visa Debit
amsID
CZ: Unikátní číslo transakce.
EN: Unique transaction number.
EN: Unique transaction number.
referenceNumber
CZ: Referenční číslo zadané při požadavku na platbu.
EN: Reference number entered during the payment
EN: Reference number entered during the payment
ABC123
sequenceNumber
CZ: Používá se pro storno transakce. Použijte obdrženou hodnotu která byla součástí transakce, kterou chcete zrušit.
EN: Used for transaction cancellation. Used the received value which was a part of transaction you want to cancel.
EN: Used for transaction cancellation. Used the received value which was a part of transaction you want to cancel.
001000000
transactionType
CZ: Definuje typ transakce.
EN: Defines type of transaction.
EN: Defines type of transaction.
KÁRTYA
dátum
CZ: Udává čas transakce.
EN: Give date of transaction.
EN: Give date of transaction.
2024-10-29T12:14:00.112Z
currencyCode
CZ: Třímístné kódy ISO měny – seznam najdete na stránce Wiki.
EN: Three chars currency ISO code.
EN: Three chars currency ISO code.
EUR
merchantID
CZ: Jedinečné ID obchodníka, obvykle představuje ID lokality.
EN: Unique merchant ID, usually location ID
EN: Unique merchant ID, usually location ID
TipAmount
CZ: Spropitné. Vyplněno v případě, že bylo zadáno.
EN: Tip. Filled in if needed
EN: Tip. Filled in if needed
2
totalAmount
CZ: Udává celkovou čásku transakce (včetně spropitného).
EN: Indicates the total amount of transaction (including tip)
EN: Indicates the total amount of transaction (including tip)
12
eredmény
CZ: Odpověď na požadavek.
EN: Result to the request.
EN: Result to the request.
0 = completed
-1 = declined
-1 = declined
cardEntryMode
CZ: Identifikuje způsob zadávání údajů o kartě, jako je čip, bezkontaktní, Magstripe atd.
EN: Defines how the card was read: magstripe, chip or contactless.
EN: Defines how the card was read: magstripe, chip or contactless.
CONTACTLESS
transactionID
CZ: Jedinečné ID generované platební aplikací během procesu registrace transakce.
EN: Unique ID generated by payment app during the transaction registration process.
EN: Unique ID generated by payment app during the transaction registration process.
001000000
authorizationCode
CZ: Vyplňuje se pouze v případě, že transakce skončí jako schválená.
EN: Is present just if the transaction is processed.
EN: Is present just if the transaction is processed.
123456
cardNumber
CZ: Číslo karty (PAN). Je přítomen v maskované formě.
EN: Card Number (PAN). It is present in masked form.
EN: Card Number (PAN). It is present in masked form.
0001
pinOk
igaz/hamis
CODE
CZ: Zobrazuje výsledek transakce na autorizaci.
EN: Shows transaction result on the authorization side.
EN: Shows transaction result on the authorization side.
approved
emvAid
CZ: Identifikuje aplikaci EMV používanou pro zpracování transakce.
EN: Identifies the EMV app used for transaction processing.
EN: Identifies the EMV app used for transaction processing.
A0000000031010
cardType
CZ: Identifikuje použitý typ karty.
EN: Identifies used card type.
EN: Identifies used card type.
VISA
MASTER
MASTER