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
Transakcja może zostać zainicjowana przez wywołanie:
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:
Zmienna/Pole
Format/Format
Opis/Description
Przykład
clientID
ciąg
amsID
OBOWIĄZKOWE
OBOWIĄZKOWE
ciąg
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
ciąg
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
preferableReceiptType
enum (sms,email,qr,print)
CZ: W przypadku wysyłania paragonu z aplikacji GP tom możliwe jest wstępne zdefiniowanie metody wysyłania paragonu przez API. Możliwe wartości to:
PL: W przypadku wysyłania paragonu z aplikacji GP tom możliwe jest wstępne zdefiniowanie metody wysyłania paragonu przez API. Możliwe wartości to:
TELEFON
EMAIL
QR
DRUK
PL: W przypadku wysyłania paragonu z aplikacji GP tom możliwe jest wstępne zdefiniowanie metody wysyłania paragonu przez API. Możliwe wartości to:
TELEFON
QR
DRUK
tekst
printByPaymentApp
bool
CZ: Określa, czy paragon jest przekazywany do klienta przez aplikację, czy przez GP tom. Domyślną wartością jest true (tj. GP tom zaoferuje metodę przekazania paragonu do klienta). Jeśli wyślesz wartość “false”, zwrócimy użytkownika do Twojej aplikacji natychmiast po transakcji i to do Ciebie należy przekazanie paragonu.
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.
prawda/fałsz
clientPhone
ciąg
CZ: Numer telefonu klienta.
PL: Numer telefonu klienta.
PL: Numer telefonu klienta.
+420606505404
clientEmail
ciąg
CZ: Adres e-mail klienta.
PL: Adres e-mail klienta.
PL: Adres e-mail klienta.
info@gptom.com
Przykład połączenia:
gptom://transaction/cancel?amsID=123&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/cancel&clientEmail=info@gptom.com
Odpowiedź będzie zawierać następujące pola:
Pole/Pola
Popis/Decription
Przykład
STATUS ZADANIA
CZ: Dává odpověď v jakém stavu skončil daný požadavek.
PL: Informuje, w którym stanie zakończyło się żądanie.
PL: Informuje, w którym stanie zakończyło się żądanie.
ZAKOŃCZONE
ODWOŁANE
BŁĄD
ODWOŁANE
BŁĄD
terminalID
CZ: Identyfikator terminala, na którym przetwarzane są transakcje. Identyfikuje terminal w systemach GP.
PL: Unikalny identyfikator terminala, na którym przetwarzana jest transakcja.
PL: Unikalny identyfikator terminala, na którym przetwarzana jest transakcja.
12345678
kwota
CZ: Kwota określa wielkość transakcji. Kwota ta jest obliczana w walucie krajowej używanej przez terminal. W przypadku zamknięcia obejmuje ona wszystkie transakcje kartą, uznane minus obciążone.
PL: Kwota określa wielkość transakcji. Kwota ta jest obliczana w walucie krajowej używanej przez terminal. W dniu zamknięcia zawiera ona wszystkie transakcje kartą, uznanie minus obciążenie.
PL: Kwota określa wielkość transakcji. Kwota ta jest obliczana w walucie krajowej używanej przez terminal. W dniu zamknięcia zawiera ona wszystkie transakcje kartą, uznanie minus obciążenie.
10
batchNumber
CZ: Identyfikuje numer zamknięcia. Należy wypełnić, jeśli wymagany jest termin.
PL: Określa numer partii. Występuje podczas zamykania transakcji wsadowej.
PL: Określa numer partii. Występuje podczas zamykania transakcji wsadowej.
1
emvAppLabel
CZ: nazwa karty EMV, która została użyta do płatności.
PL: Etykieta używanej karty
PL: Etykieta używanej karty
Visa Debit
amsID
CZ: Unikalny numer transakcji.
PL: Unikalny numer transakcji.
PL: Unikalny numer transakcji.
referenceNumber
CZ: Numer referencyjny wprowadzony podczas żądania płatności.
PL: Numer referencyjny wprowadzony podczas płatności
PL: Numer referencyjny wprowadzony podczas płatności
ABC123
sequenceNumber
CZ: Służy do anulowania transakcji. Użyj otrzymanej wartości, która była częścią transakcji, którą chcesz anulować.
PL: Służy do anulowania transakcji. Używa otrzymanej wartości, która była częścią transakcji, którą chcesz anulować.
PL: Służy do anulowania transakcji. Używa otrzymanej wartości, która była częścią transakcji, którą chcesz anulować.
001000000
transactionType
PL: Określa typ transakcji.
PL: Określa typ transakcji.
PL: Określa typ transakcji.
KARTA
data
CZ: Wskazuje czas transakcji.
PL: Podaj datę transakcji.
PL: Podaj datę transakcji.
2024-10-29T12:14:00.112Z
currencyCode
CZ: Trzycyfrowe kody walut ISO - lista znajduje się na stronie Wiki.
PL: kod ISO waluty składający się z trzech znaków.
PL: kod ISO waluty składający się z trzech znaków.
EUR
merchantID
CZ: Unikalny identyfikator sprzedawcy, zwykle reprezentujący identyfikator lokalizacji.
PL: unikalny identyfikator sprzedawcy, zazwyczaj identyfikator lokalizacji
PL: unikalny identyfikator sprzedawcy, zazwyczaj identyfikator lokalizacji
TipAmount
CZ: Wskazówki. Wypełnione, jeśli zostało wprowadzone.
PL: Wskazówka. Wypełnione w razie potrzeby.
PL: Wskazówka. Wypełnione w razie potrzeby.
2
totalAmount
CZ: Udává celkovou čásku transakce (včetně spropitného).
PL: Wskazuje całkowitą kwotę transakcji (w tym napiwek).
PL: Wskazuje całkowitą kwotę transakcji (w tym napiwek).
12
wynik
CZ: Odpowiedź na wniosek.
PL: Wynik żądania.
PL: Wynik żądania.
0 = completed
-1 = declined
-1 = declined
cardEntryMode
CZ: Określa metodę wprowadzania danych karty, taką jak chip, karta zbliżeniowa, Magstripe itp.
PL: Określa sposób odczytu karty: pasek magnetyczny, chip lub karta zbliżeniowa.
PL: Określa sposób odczytu karty: pasek magnetyczny, chip lub karta zbliżeniowa.
BEZKONTAKTOWY
transactionID
CZ: Unikalny identyfikator generowany przez aplikację płatniczą podczas procesu rejestracji transakcji.
PL: Unikalny identyfikator generowany przez aplikację płatniczą podczas procesu rejestracji transakcji.
PL: Unikalny identyfikator generowany przez aplikację płatniczą podczas procesu rejestracji transakcji.
001000000
authorizationCode
CZ: Należy wypełnić tylko wtedy, gdy transakcja zostanie zatwierdzona.
PL: Jest obecny tylko wtedy, gdy transakcja jest przetwarzana.
PL: Jest obecny tylko wtedy, gdy transakcja jest przetwarzana.
123456
cardNumber
CZ: Numer karty (PAN). Występuje w formie zamaskowanej.
PL: Numer karty (PAN), obecny w formie zamaskowanej.
PL: Numer karty (PAN), obecny w formie zamaskowanej.
0001
pinOk
prawda/fałsz
KOD
CZ: Wyświetla wynik transakcji podczas autoryzacji.
PL: Pokazuje wynik transakcji po stronie autoryzacji.
PL: Pokazuje wynik transakcji po stronie autoryzacji.
approved