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
Tranzacția poate fi inițiată prin apel:
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:
Variabilă/câmp
Format/Format
Descriere/Descriere
Exemplu
sumă
lung
CZ: Valoarea tranzacției cu două zecimale.
1000 (=10CZK/EURO)
clientID
șir
RO: Valoarea tranzacției cu două zecimale.
redirectUrl
șir
CZ: Unikátní amsID, které dostanete při platbě.
fb://Success
origineNumReferință
șir
EN: The unique amsID that you will receive upon payment.
abc123
preferabilReceiptType
enum (sms,email,qr,print)
CZ: URL vaší aplikace na kterou přesměrujeme klienta po dokončení storna.
text
printarePaymentApp
bool
EN: The URL of your application to which we will redirect the client after the cancellation is complete.
adevărat/fals
clientPhone
șir
CZ: Număr de referință de până la 20 de caractere - potrivit pentru numărul facturii, al plății - poate fi utilizat pentru a vă corela plata cu vânzările sau comenzile.
+420606505404
clientEmail
șir
EN: Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
info@gptom.com
CZ: În cazul trimiterii unei chitanțe din aplicația GP tom, este posibil să se predefinească metoda de trimitere a chitanței prin API. Valorile posibile sunt:
RO: În cazul trimiterii unei chitanțe din aplicația GP tom, este posibil să se predefinească metoda de trimitere a chitanței prin API. Valorile posibile sunt:
TELEFON
EMAIL
QR
IMPRIMARE
CZ: Definește dacă chitanța este transmisă clientului de aplicația dvs. sau de GP tom. Valoarea implicită este true (adică GP tom va oferi metoda de transmitere a chitanței către client). Dacă trimiteți valoarea “false”, vom returna utilizatorul către aplicația dvs. imediat după tranzacție și depinde de dvs. să transmiteți chitanța.
EN: Defines whether the receipt is passed to the client by your application or GP tom. The default value is true (i.e. GP will offer a way to pass the receipt to the client). If you send a value of "false", we return the user to your app immediately after the transaction and it's up to you to pass the receipt.
CZ: Numărul de telefon al clientului.
RO: Numărul de telefon al clientului.
CZ: Adresa de e-mail a clientului.
RO: Adresa de e-mail a clientului.
Exemplu de apel:
gptom://transaction/refund?amount=1000&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/refund&clientEmail=info@gptom.com
Răspunsul va conține următoarele câmpuri:
Câmp/câmp
Popis/Decription
Exemplu/Exemplu
STAREA SARCINII
CZ: Dává odpověď v jakém stavu skončil daný požadavek.
COMPLETAT
terminalID
RO: Oferă informații despre statul în care s-a încheiat cererea dumneavoastră.
ANULAT
sumă
CZ: ID-ul terminalului pe care sunt prelucrate tranzacțiile. Identifică terminalul în sistemele GP.
ERROR
Numărul lotului
RO: ID unic al terminalului, pe baza căruia este procesată tranzacția.
12345678
emvAppLabel
CZ: Suma determină volumul tranzacției. Această sumă este calculată în moneda națională utilizată de terminal. Pentru o închidere, aceasta include toate tranzacțiile cu cardul, creditate minus debitate.
10
amsID
RO: Suma determină volumul tranzacției. Această sumă este calculată în moneda națională utilizată de terminal. La închiderea zilei, aceasta conține toate tranzacțiile cu cardul, creditate minus debitate.
1
Număr de referință
CZ: identifică numărul de închidere. Se completează în cazul în care se solicită un termen limită.
Visa Debit
Numărul secvenței
RO: Definește numărul lotului. Prezent în timpul tranzacției de închidere a lotului.
Tipul tranzacției
CZ: numele EMV utilizat pentru plată.
ABC123
data
RO: Eticheta cardului utilizat
001000000
cod valută
CZ: Numărul unic al tranzacției.
CARD
MerchantID
RO: Numărul unic al tranzacției.
2024-10-29T12:14:00.112Z
TipAmount
CZ: Numărul de referință introdus la solicitarea plății.
EUR
suma totală
RO: Numărul de referință introdus în timpul plății
rezultat
CZ: utilizat pentru tranzacțiile de anulare. Utilizați valoarea primită care făcea parte din tranzacția pe care doriți să o anulați.
2
cardEntryMode
RO: Utilizat pentru anularea tranzacției. Se utilizează valoarea primită care făcea parte din tranzacția pe care doriți să o anulați.
12
ID tranzacție
RO: definește tipul de tranzacție.
0 = completed
cod de autorizare
RO: definește tipul de tranzacție.
-1 = declined
Numărul cardului
CZ: Indică ora tranzacției.
FĂRĂ CONTACT
pinOk
RO: Indicați data tranzacției.
001000000
COD
CZ: Coduri valutare ISO din trei cifre - consultați pagina Wiki pentru o listă.
123456
emvAid
RO: Cod ISO al monedei din trei caractere.
0001
tip card
CZ: ID unic al comerciantului, reprezentând de obicei un ID al locației.
adevărat/fals
RO: ID unic al comerciantului, de obicei ID al locației
approved
CZ: Sfaturi. Se completează în cazul în care a fost introdus.
A0000000031010
RO: Sfat. Completat dacă este necesar.
VISA
CZ: Udává celkovou čásku transakce (včetně spropitného).
MASTER
RO: Indică valoarea totală a tranzacției (inclusiv bacșișul)
CZ: Răspuns la cerere.
RO: Rezultatul solicitării.
CZ: identifică metoda de introducere a datelor cardului, cum ar fi cip, contactless, Magstripe etc.
RO: Definește modul în care cardul a fost citit: bandă magnetică, cip sau fără contact.
CZ: ID unic generat de aplicația de plată în timpul procesului de înregistrare a tranzacției.
RO: ID unic generat de aplicația de plată în timpul procesului de înregistrare a tranzacției.
CZ: A se completa numai în cazul în care tranzacția este aprobată.
RO: Este prezent doar dacă tranzacția este procesată.
CZ: Numărul cardului (PAN). Este prezent în formă mascată.
RO: Numărul cardului (PAN). Este prezent în formă mascată.
CZ: Afișează rezultatul tranzacției privind autorizarea.
RO: Afișează rezultatul tranzacției pe partea de autorizare.
CZ: identifică aplicația EMV utilizată pentru a procesa tranzacția.
RO: Identifică aplicația EMV utilizată pentru procesarea tranzacțiilor.
CZ: identifică tipul de card utilizat.
RO: Identifică tipul de card utilizat.