Tranzacția de rambursare permite returnarea banilor pe orice card al clientului, fără a fi necesară identificarea tranzacției de vânzare anterioare.
Etapele procesului de returnare sunt următoarele:
Crearea unei returnări
Tranzacția poate fi inițiată prin apel:
gptom://transaction/refund?…
unde se utilizează următorii parametri pentru generarea raportului, inclusiv amsID-ul atribuit fiecărei plăți:
Variabilă/câmp
Format/Format
Descriere/Descriere
Exemplu
sumă
lung
CZ: Valoarea tranzacției cu două zecimale.
RO: Valoarea tranzacției cu două zecimale.
RO: Valoarea tranzacției cu două zecimale.
1000 (=10CZK/EURO)
clientID
șir
CZ: ID-ul unic al companiei, pe care îl veți primi în aplicație sau în e-mailul de bun venit.
EN: Codul unic al companiei pe care îl veți primi în aplicație sau în e-mailul de bun venit.
EN: Codul unic al companiei pe care îl veți primi în aplicație sau în e-mailul de bun venit.
redirectUrl
șir
CZ: URL-ul aplicației dvs. către care vom redirecționa clientul după finalizarea anulării.
EN: Adresa URL a aplicației dumneavoastră către care vom redirecționa clientul după finalizarea anulării.
EN: Adresa URL a aplicației dumneavoastră către care vom redirecționa clientul după finalizarea anulării.
fb://Success
origineNumReferință
ș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.
EN: Număr de referință de până la 20 de caractere – potrivit pentru numărul facturii, plăți – poate fi utilizat pentru corelarea plăților cu vânzările sau comenzile.
EN: Număr de referință de până la 20 de caractere – potrivit pentru numărul facturii, plăți – poate fi utilizat pentru corelarea plăților cu vânzările sau comenzile.
abc123
preferabilReceiptType
enum (sms,email,qr,print)
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
IMPRIMARE
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
IMPRIMARE
text
printarePaymentApp
bool
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: Stabilește dacă chitanța este transmisă clientului de către aplicația dvs. sau de către GP. Valoarea implicită este "true" (adică GP va oferi o modalitate de a transmite chitanța clientului). Dacă trimiteți valoarea „false”, redirecționăm utilizatorul către aplicația dvs. imediat după tranzacție și rămâne la latitudinea dvs. să transmiteți chitanța.
EN: Stabilește dacă chitanța este transmisă clientului de către aplicația dvs. sau de către GP. Valoarea implicită este "true" (adică GP va oferi o modalitate de a transmite chitanța clientului). Dacă trimiteți valoarea „false”, redirecționăm utilizatorul către aplicația dvs. imediat după tranzacție și rămâne la latitudinea dvs. să transmiteți chitanța.
adevărat/fals
clientPhone
șir
CZ: Numărul de telefon al clientului.
RO: Numărul de telefon al clientului.
RO: Numărul de telefon al clientului.
+420606505404
clientEmail
șir
CZ: Adresa de e-mail a clientului.
RO: Adresa de e-mail a clientului.
RO: Adresa de e-mail a clientului.
info@gptom.com
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
Descriere/Decription
Exemplu/Exemplu
STAREA SARCINII
CZ: Indică starea finală a cererii respective.
RO: Oferă informații despre statul în care s-a încheiat cererea dumneavoastră.
RO: Oferă informații despre statul în care s-a încheiat cererea dumneavoastră.
COMPLETAT
ANULAT
ERROR
ANULAT
ERROR
terminalID
CZ: ID-ul terminalului pe care sunt prelucrate tranzacțiile. Identifică terminalul în sistemele GP.
RO: ID unic al terminalului, pe baza căruia este procesată tranzacția.
RO: ID unic al terminalului, pe baza căruia este procesată tranzacția.
12345678
sumă
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.
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.
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.
10
Numărul lotului
CZ: identifică numărul de închidere. Se completează în cazul în care se solicită un termen limită.
RO: Definește numărul lotului. Prezent în timpul tranzacției de închidere a lotului.
RO: Definește numărul lotului. Prezent în timpul tranzacției de închidere a lotului.
1
emvAppLabel
CZ: numele EMV utilizat pentru plată.
RO: Eticheta cardului utilizat
RO: Eticheta cardului utilizat
Visa Debit
amsID
CZ: Numărul unic al tranzacției.
RO: Numărul unic al tranzacției.
RO: Numărul unic al tranzacției.
Număr de referință
CZ: Numărul de referință introdus la solicitarea plății.
RO: Numărul de referință introdus în timpul plății
RO: Numărul de referință introdus în timpul plății
ABC123
Numărul secvenței
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.
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.
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.
001000000
Tipul tranzacției
RO: definește tipul de tranzacție.
RO: definește tipul de tranzacție.
RO: definește tipul de tranzacție.
CARD
data
CZ: Indică ora tranzacției.
RO: Indicați data tranzacției.
RO: Indicați data tranzacției.
2024-10-29T12:14:00.112Z
cod valută
CZ: Coduri valutare ISO din trei cifre - consultați pagina Wiki pentru o listă.
RO: Cod ISO al monedei din trei caractere.
RO: Cod ISO al monedei din trei caractere.
EUR
MerchantID
CZ: ID unic al comerciantului, reprezentând de obicei un ID al locației.
RO: ID unic al comerciantului, de obicei ID al locației
RO: ID unic al comerciantului, de obicei ID al locației
TipAmount
CZ: Sfaturi. Se completează în cazul în care a fost introdus.
EN: Sfat. Se completează dacă este necesar
EN: Sfat. Se completează dacă este necesar
2
suma totală
CZ: Indică suma totală a tranzacției (inclusiv bacșișul).
RO: Indică valoarea totală a tranzacției (inclusiv bacșișul)
RO: Indică valoarea totală a tranzacției (inclusiv bacșișul)
12
rezultat
CZ: Răspuns la cerere.
RO: Rezultatul solicitării.
RO: Rezultatul solicitării.
0 = finalizat
-1 = refuzat
-1 = refuzat
cardEntryMode
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.
RO: Definește modul în care cardul a fost citit: bandă magnetică, cip sau fără contact.
FĂRĂ CONTACT
ID tranzacție
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.
RO: ID unic generat de aplicația de plată în timpul procesului de înregistrare a tranzacției.
001000000
cod de autorizare
CZ: A se completa numai în cazul în care tranzacția este aprobată.
RO: Este prezent doar dacă tranzacția este procesată.
RO: Este prezent doar dacă tranzacția este procesată.
123456
Numărul cardului
CZ: Numărul cardului (PAN). Este prezent în formă mascată.
RO: Numărul cardului (PAN). Este prezent în formă mascată.
RO: Numărul cardului (PAN). Este prezent în formă mascată.
0001
pinOk
adevărat/fals
COD
CZ: Afișează rezultatul tranzacției privind autorizarea.
RO: Afișează rezultatul tranzacției pe partea de autorizare.
RO: Afișează rezultatul tranzacției pe partea de autorizare.
aprobat
emvAid
CZ: identifică aplicația EMV utilizată pentru a procesa tranzacția.
RO: Identifică aplicația EMV utilizată pentru procesarea tranzacțiilor.
RO: Identifică aplicația EMV utilizată pentru procesarea tranzacțiilor.
A0000000031010
tip card
CZ: identifică tipul de card utilizat.
RO: Identifică tipul de card utilizat.
RO: Identifică tipul de card utilizat.
VISA
MASTER
MASTER