Transakcja anulowania jest jedną z podstawowych operacji płatniczych, która zapewnia anulowanie już dokonanej transakcji płatniczej z powrotem na konto posiadacza karty.
Proces anulowania jest następujący:
Tworzenie anulowania
Transakcja może zostać zainicjowana poprzez wywołanie:
gptom://transaction/cancel?…
gdzie do utworzenia raportu używane są następujące parametry, w tym identyfikator amsID przypisany do każdej płatności:
Zmienna/Pole
Format/Format
Opis/Description
Przykład
clientID
ciąg
amsID OBOWIĄZKOWE
ciąg
CZ: Unikalny identyfikator amsID, który otrzymasz w momencie płatności.
PL: Unikalny identyfikator amsID, który otrzymasz w momencie płatności.
PL: Unikalny identyfikator amsID, który otrzymasz w momencie płatności.
redirectUrl
ciąg
CZ: Adres URL aplikacji, na który przekierujemy klienta po zakończeniu anulowania.
PL: Adres URL aplikacji, na który przekierujemy klienta po zakończeniu anulowania.
PL: Adres URL aplikacji, na który przekierujemy klienta po zakończeniu anulowania.
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: PHONE EMAIL QR PRINT
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: PHONE EMAIL QR PRINT
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", odeślemy użytkownika do Twojej aplikacji natychmiast po transakcji i to do Ciebie należy przekazanie paragonu.
PL: Określa, czy paragon jest przekazywany do klienta przez aplikację, czy przez GP Tom. Domyślną wartością jest true (tzn. GP zaoferuje sposób na przekazanie 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.
PL: Określa, czy paragon jest przekazywany do klienta przez aplikację, czy przez GP Tom. Domyślną wartością jest true (tzn. GP zaoferuje sposób na przekazanie 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.
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
Opis/Description
Przykład
STATUS ZADANIA
CZ: Daje odpowiedź, w którym stanie zakończyło się żądanie.
PL: Informuje, w którym stanie zakończyło się żądanie.
PL: Informuje, w którym stanie zakończyło się żądanie.
ZAKOŃCZONE ANULOWANE 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.
Identyfikuje terminal w systemach GP. 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 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 wszystkie transakcje kartą, uznane minus obciążone.
10
batchNumber
CZ: Identyfikuje numer zamknięcia. Należy wypełnić, jeśli wymagany jest termin.
PL: Określa numer partii. Obecny podczas zamykania transakcji wsadowej.
PL: Określa numer partii. Obecny podczas zamykania transakcji wsadowej.
1
emvAppLabel
CZ: nazwa karty EMV, która została użyta do płatności.
PL: Etykieta użytej karty
PL: Etykieta użytej 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 żądania płatności
PL: Numer referencyjny wprowadzony podczas żądania 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żyj otrzymanej wartości, która była częścią transakcji, którą chcesz anulować.
PL: Służy do anulowania transakcji. Użyj 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 godzinę transakcji.
PL: Podaje datę transakcji.
PL: Podaje datę transakcji.
2024-10-29T12:14:00.112Z
currencyCode
CZ: Trzycyfrowe kody walut ISO - lista znajduje się na stronie Wiki.
PL: Trzycyfrowy kod ISO waluty.
PL: Trzycyfrowy kod ISO waluty.
EUR
merchantID
CZ: 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: Napiwek. Wypełniane w razie potrzeby.
PL: Napiwek. Wypełniane w razie potrzeby.
2
totalAmount
CZ: Wskazuje całkowitą kwotę transakcji (w tym napiwek). PL: Wskazuje całkowitą kwotę transakcji (w tym napiwek).
12
wynik
CZ: Odpowiedź na żądanie.
PL: Wynik żądania.
PL: Wynik żądania.
0 = ukończone -1 = odrzucone
cardEntryMode
CZ: Określa sposób wprowadzenia danych karty, np. chip, karta zbliżeniowa, pasek magnetyczny itp. PL: Określa sposób odczytu karty: pasek magnetyczny, chip lub karta zbliżeniowa.
BEZKONTAKTOWY
transactionID
CZ: Unikalny identyfikator wygenerowany przez aplikację płatniczą podczas procesu rejestracji transakcji.
PL: Unikalny identyfikator wygenerowany przez aplikację płatniczą podczas procesu rejestracji transakcji.
PL: Unikalny identyfikator wygenerowany przez aplikację płatniczą podczas procesu rejestracji transakcji.
001000000
authorizationCode
CZ: Wypełniane tylko wtedy, gdy transakcja zostanie zatwierdzona.
PL: Wypełnia się tylko wtedy, gdy transakcja zostanie przetworzona.
PL: Wypełnia się tylko wtedy, gdy transakcja zostanie przetworzona.
123456
cardNumber
CZ: Numer karty (PAN). Występuje w formie zamaskowanej.
PL: Numer karty (PAN). Występuje w formie zamaskowanej.
PL: Numer karty (PAN). Występuje w formie zamaskowanej.
0001
pinOk
prawda/fałsz
KOD
CZ: Wyświetla wynik transakcji po stronie autoryzacji.
PL: Wyświetla wynik transakcji po stronie autoryzacji.
PL: Wyświetla wynik transakcji po stronie autoryzacji.
zatwierdzony