O tranzacție de vânzare este o operațiune de plată de bază care transferă o anumită sumă din contul bancar al titularului cardului în contul comerciantului.
În ceea ce privește procesul de plată, procedura este următoarea:
Crearea unei tranzacții
Tranzacția poate fi inițiată prin apel:
gptom://transaction/create?…
unde următorii parametri sunt utilizați pentru a crea raportul:
Variabilă/câmp
Format/Format
Descriere/Descriere
Exemplu
sumă
OBLIGATORIU
OBLIGATORIU
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: Verificarea opțională a utilizatorului conectat. Cheia API a terminalului este verificată aici.
RO: Verificarea opțională a utilizatorului conectat. Aici este verificată cheia API a terminalului.
RO: Verificarea opțională a utilizatorului conectat. Aici este verificată cheia API a terminalului.
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.
Număr de referință de până la 20 de caractere - potrivit pentru numărul facturii, al plății - poate fi utilizat pentru corelarea plăților cu vânzările sau comenzile.
Număr de referință de până la 20 de caractere - potrivit pentru numărul facturii, al plății - poate fi utilizat pentru corelarea plăților cu vânzările sau comenzile.
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.
Definește dacă chitanța este transmisă clientului de aplicația dvs. sau de GP tom. Valoarea implicită este true (adică GP va oferi o modalitate de transmitere a chitanței către client). Dacă trimiteți o valoare de "false", returnăm utilizatorul în aplicația dvs. imediat după tranzacție și depinde de dvs. să transmiteți chitanța.
Definește dacă chitanța este transmisă clientului de aplicația dvs. sau de GP tom. Valoarea implicită este true (adică GP va oferi o modalitate de transmitere a chitanței către client). Dacă trimiteți o valoare de "false", returnăm utilizatorul în aplicația dvs. imediat după tranzacție și depinde de dvs. să transmiteți chitanța.
adevărat/fals
TipAmount
lung
CZ: În restaurante, puteți solicita clientului să adauge un bacșiș, care este introdus din sistemul dumneavoastră. Această sumă este apoi adăugată la suma inițială introdusă de comerciant.
RO: În restaurante, puteți solicita clientului să adauge un bacșiș, care este introdus în sistemul dumneavoastră. Această sumă este apoi adăugată la suma inițială introdusă de comerciant.
RO: În restaurante, puteți solicita clientului să adauge un bacșiș, care este introdus în sistemul dumneavoastră. Această sumă este apoi adăugată la suma inițială introdusă de comerciant.
1000 (=10CZK/EURO)
redirectUrl
șir
CZ: adresa URL a aplicației dvs. către care redirecționăm clientul după finalizarea plății.
RO: Adresa URL a aplicației dvs. către care vom redirecționa clientul după finalizarea plății.
RO: Adresa URL a aplicației dvs. către care vom redirecționa clientul după finalizarea plății.
fb://success
TipCollect
bool
CZ: câmp opțional care afișează ecranul de introducere a bacșișului în aplicația GP tom. După introducerea bacșișului în aplicație, este afișat ecranul pentru atașarea cardului. Pentru a afișa acest ecran, trebuie să aveți activată și funcția de bacșiș în aplicație.
RO: Un câmp opțional care afișează ecranul de introducere a bacșișului în aplicația GP tom. După introducerea bacșișului în aplicație, va fi afișat un ecran pentru atașarea cardului. De asemenea, pentru a afișa acest ecran, trebuie să aveți activată funcția de bacșiș în aplicație.
RO: Un câmp opțional care afișează ecranul de introducere a bacșișului în aplicația GP tom. După introducerea bacșișului în aplicație, va fi afișat un ecran pentru atașarea cardului. De asemenea, pentru a afișa acest ecran, trebuie să aveți activată funcția de bacșiș în aplicație.
adevărat / fals
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
QR
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
QR
IMPRIMARE
text
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
Tipul tranzacției
șir
RO: Tipul de tranzacție definește tipul de tranzacție pe care doriți să o inițiați. Valorile disponibile sunt:
RO:Tipul de tranzacție definește tipul de tranzacție pe care doriți să o inițiați. Valorile disponibile sunt:
CASH
CARD
CONT_PLATA
BLIK_PAYMENT
PAYMENT_GATEWAY
RO:Tipul de tranzacție definește tipul de tranzacție pe care doriți să o inițiați. Valorile disponibile sunt:
CASH
CARD
CONT_PLATA
BLIK_PAYMENT
PAYMENT_GATEWAY
CARD
Exemplu de apel:
gptom://transaction/create?originReferenceNum=12345&amount=2&clientID=123&tipCollect=true&preferableReceiptType=QR&redirectUrl=gp://transaction/create&printByPaymentApp=true&clientPhone=+420606505404&clientEmail=info@gptom.com&tipAmount=1
Răspunsul va conține următoarele câmpuri:
Câmp/câmp
Format
Descriere/Descriere
Exemplu/Exemplu
STAREA SARCINII
CZ: Oferă răspunsul la starea în care s-a încheiat cererea
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.
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
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
tip card
CZ: identifică tipul de card utilizat.
RO: Identifică tipul de card utilizat.
RO: Identifică tipul de card utilizat.
VISA
MASTER
MASTER
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.
RO: Sfat. Completat dacă este necesar.
RO: Sfat. Completat dacă este necesar.
2
suma totală
CZ: Indică linia 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 - tranzacție aprobată
-1 - tranzacție refuzată
-1 - tranzacție 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: 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
cod de autorizare
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
pinOk
adevărat/fals
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
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.
acceptat
