O tranzacție de vânzare este o operațiune de plată de bază care prevede transferul unei sume specificate din contul bancar al titularului cardului în contul comerciantului.
În ceea ce privește procesul de plată, procedura este după cum urmează:
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
amount
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
string
originReferenceNum
string
CZ: Numărul de referință de până la 20 de caractere - adecvat pentru numărul facturii, plată - poate fi utilizat pentru corelarea plăților cu vânzările sau comenzile.
Număr de referință de până la 20 de caractere - adecvat pentru numărul facturii, plată - poate fi utilizat pentru corelarea plăților cu vânzările sau comenzile.
Număr de referință de până la 20 de caractere - adecvat pentru numărul facturii, plată - poate fi utilizat pentru corelarea plăților cu vânzările sau comenzile.
printByPaymentApp
bool
GP tom GP tom RO: definește dacă chitanța este transmisă clientului de către aplicația dvs. sau de către . Valoarea implicită este true (adică va oferi metoda de transmitere a chitanței către client). Dacă trimiteți o valoare de "false", vom returna utilizatorul la aplicația dvs. imediat după tranzacție și va depinde de dvs. să predați chitanța.
GP tom Definește dacă chitanța este transmisă clientului de către aplicația dvs. sau . Valoarea implicită este true (adică GP va oferi o metodă de transmitere a chitanței către client). Dacă trimiteți o valoare de "false", vom returna utilizatorul la aplicația dvs. imediat după tranzacție și depinde de dvs. să transmiteți chitanța.
GP tom Definește dacă chitanța este transmisă clientului de către aplicația dvs. sau . Valoarea implicită este true (adică GP va oferi o metodă de transmitere a chitanței către client). Dacă trimiteți o valoare de "false", vom returna utilizatorul la 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 cere clientului să adauge un bacșiș, unde bacșișul este introdus în sistemul dvs. Această sumă este apoi adăugată la suma inițială introdusă de comerciant.
RO: În restaurante, puteți cere clientului să adauge un bacșiș, unde bacșișul este introdus în sistemul dvs. Această sumă este apoi adăugată la suma inițială introdusă de comerciant.
1000 (=10CZK/EURO)
redirectUrl
string
CZ: URL-ul aplicației dvs. către care redirecționăm clientul după finalizarea plății.
RO: URL-ul aplicației dvs. către care vom redirecționa clientul după finalizarea plății.
RO: URL-ul aplicației dvs. către care vom redirecționa clientul după finalizarea plății.
fb://success
TipCollect
bool
GP tomCZ: câmp opțional care afișează ecranul de introducere a bacșișului în aplicație. 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.
GP tom RO: Un câmp opțional care afișează ecranul de introducere a bacșișului în aplicație. 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.
GP tom RO: Un câmp opțional care afișează ecranul de introducere a bacșișului în aplicație. 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)
GP tom API CZ: În cazul trimiterii unei chitanțe din aplicație, este posibil să se predefinească metoda de trimitere a chitanței prin .
GP tom API
Valorile posibile sunt: RO: În cazul trimiterii unei chitanțe din aplicație, este posibil să se predefinească metoda de trimitere a chitanței prin . Valorile posibile sunt: PHONE EMAIL QR PRINT
GP tom API
Valorile posibile sunt: RO: În cazul trimiterii unei chitanțe din aplicație, este posibil să se predefinească metoda de trimitere a chitanței prin . Valorile posibile sunt: PHONE EMAIL QR PRINT
text
clientPhone
string
CZ: Numărul de telefon al clientului.
RO: Numărul de telefon al clientului.
RO: Numărul de telefon al clientului.
+420606505404
clientEmail
string
CZ: Adresa de e-mail a clientului.
EN: Adresa de e-mail a clientului.
EN: Adresa de e-mail a clientului.
info@gptom.com
transactionType
string
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 tranzacției definește tipul de tranzacție pe care doriți să îl inițiați.
Valorile disponibile sunt: CASH CARD
Valorile disponibile sunt: RO:Tipul tranzacției definește tipul de tranzacție pe care doriți să îl inițiați.
Valorile disponibile sunt: CASH CARD
CASH/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
RO: Oferă informații despre statul în care s-a încheiat solicitarea dumneavoastră. RO: Oferă informații despre statul în care s-a încheiat solicitarea dumneavoastră.
FINALIZAT ANULAT EROARE
terminalID
CZ: ID-ul terminalului pe care sunt procesate tranzacțiile.
Identifică terminalul în sistemele GP. RO: ID unic al terminalului pe care este prelucrată tranzacția.
Identifică terminalul în sistemele GP. RO: ID unic al terminalului pe care este prelucrată tranzacția.
12345678
amount
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 o zi de închidere, 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 o zi de închidere, aceasta conține toate tranzacțiile cu cardul, creditate minus debitate.
10
batchNumber
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 care a fost utilizat la plată.
RO: Eticheta cardului utilizat
RO: Eticheta cardului utilizat
Visa Debit
amsID
CZ: Număr unic de tranzacție.
RO: Număr unic de tranzacție.
RO: Număr unic de tranzacție.
emvaid
CZ: identifică aplicația EMV utilizată pentru procesarea tranzacției.
EN: Identifică aplicația EMV utilizată pentru procesarea tranzacției.
EN: Identifică aplicația EMV utilizată pentru procesarea tranzacției.
A0000000031010
referenceNumber
CZ: Numărul de referință introdus la solicitarea plății.
RO: Numărul de referință introdus în timpul cererii de plată
RO: Numărul de referință introdus în timpul cererii de plată
ABC123
sequenceNumber
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
cardType
CZ: identifică tipul de card utilizat.
RO: Identifică tipul de card utilizat.
RO: Identifică tipul de card utilizat.
VISA MASTER
transactionType
RO: Definește tipul de tranzacție.
RO: Definește tipul de tranzacție.
RO: Definește tipul de tranzacție.
CARD
date
CZ: Indică ora tranzacției.
RO: Indică data tranzacției.
RO: Indică data tranzacției.
2024-10-29T12:14:00.112Z
currencyCode
CZ: Coduri valutare ISO din trei cifre - consultați pagina Wiki pentru o listă.
EN: Cod valutar ISO cu trei caractere.
EN: Cod valutar ISO cu trei caractere.
EUR
merchantID
CZ: ID unic al comerciantului, de obicei ID al locației. RO: ID unic al comerciantului, de obicei ID al locației
tipAmount
CZ: Sfaturi. Completat în cazul în care a fost introdus.
RO: Sfat. Completat dacă este necesar.
RO: Sfat. Completat dacă este necesar.
2
totalAmount
CZ: Indică valoarea totală a tranzacției (inclusiv bacșișul) RO: Indică valoarea totală a tranzacției (inclusiv bacșișul)
12
result
CZ: Răspuns la cerere.
RO: Rezultat la cerere.
RO: Rezultat la cerere.
0 - tranzacție aprobată -1 - tranzacție refuzată
cardEntryMode
CZ: identifică modul în care au fost introduse datele cardului, cum ar fi cip, fără contact, bandă magnetică etc. RO: definește modul în care a fost citit cardul: bandă magnetică, cip sau fără contact.
CONTACTLESS
transactionID
CZ: Se completează 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
authorizationCode
CZ: ID unic generat de aplicația de plată în timpul procesului de înregistrare a tranzacției.
EN: ID unic generat de aplicația de plată în timpul procesului de înregistrare a tranzacției.
EN: ID unic generat de aplicația de plată în timpul procesului de înregistrare a tranzacției.
001000000
pinOk
adevărat/fals
cardNumber
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 pe partea de autorizare.
RO: Afișează rezultatul tranzacției pe partea de autorizare.
RO: Afișează rezultatul tranzacției pe partea de autorizare.
acceptat