Transakce storno patří mezi základní platební operace, která zajišťuje storno již provedené platební transakce zpět na účet držitele karty.
Průběh storna je následující:
Vytvoření storna
Tranzacția poate fi inițiată prin apel:
gptom://transaction/cancel?…
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
clientID
șir
amsID
OBLIGATORIU
OBLIGATORIU
șir
CZ: Unikátní amsID, které dostanete při platbě.
EN: The unique amsID that you will receive upon payment.
EN: The unique amsID that you will receive upon payment.
redirectUrl
șir
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
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
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: 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.
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.
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/cancel?amsID=123&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/cancel&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.
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.
RO: Sfat. Completat dacă este necesar.
RO: Sfat. Completat dacă este necesar.
2
suma totală
CZ: Udává celkovou čásku transakce (včetně spropitného).
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 = completed
-1 = declined
-1 = declined
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.
approved