Transakce návrat umožňuje vrátit peníze na jakoukoliv kartu zákazníka bez potřeby dohledání předešlé prodejní transakce.
Průběh návratu je následující:
Vytvoření návratu
Transakcja może zostać zainicjowana przez wywołanie:
gptom://transaction/refund?…
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
kwota
długi
CZ: Kwota transakcji z dwoma miejscami po przecinku.
1000 (=10CZK/EURO)
clientID
ciąg
PL: Kwota transakcji z dwoma miejscami po przecinku.
redirectUrl
ciąg
CZ: Unikátní amsID, které dostanete při platbě.
fb://Success
originReferenceNum
ciąg
EN: The unique amsID that you will receive upon payment.
abc123
preferableReceiptType
enum (sms,email,qr,print)
CZ: URL vaší aplikace na kterou přesměrujeme klienta po dokončení storna.
tekst
printByPaymentApp
bool
EN: The URL of your application to which we will redirect the client after the cancellation is complete.
prawda/fałsz
clientPhone
ciąg
CZ: Numer referencyjny do 20 znaków - odpowiedni dla numeru faktury, płatności - może być używany do dopasowywania płatności do sprzedaży lub zamówień.
+420606505404
clientEmail
ciąg
EN: Reference number up to 20 characters - suitable for invoice number, payment - can be used for your matching of payments to sales or orders.
info@gptom.com
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
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.
CZ: Numer telefonu klienta.
PL: Numer telefonu klienta.
CZ: Adres e-mail klienta.
PL: Adres e-mail klienta.
Przykład połączenia:
gptom://transaction/refund?amount=1000&preferableReceiptType=QR&clientPhone=+420606505404&clientID=123&printByPaymentApp=true&redirectUrl=gp://transaction/refund&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.
ZAKOŃCZONE
terminalID
PL: Informuje, w którym stanie zakończyło się żądanie.
ODWOŁANE
kwota
CZ: Identyfikator terminala, na którym przetwarzane są transakcje. Identyfikuje terminal w systemach GP.
BŁĄD
batchNumber
PL: Unikalny identyfikator terminala, na którym przetwarzana jest transakcja.
12345678
emvAppLabel
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.
10
amsID
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.
1
referenceNumber
CZ: Identyfikuje numer zamknięcia. Należy wypełnić, jeśli wymagany jest termin.
Visa Debit
sequenceNumber
PL: Określa numer partii. Występuje podczas zamykania transakcji wsadowej.
transactionType
CZ: nazwa karty EMV, która została użyta do płatności.
ABC123
data
PL: Etykieta używanej karty
001000000
currencyCode
CZ: Unikalny numer transakcji.
KARTA
merchantID
PL: Unikalny numer transakcji.
2024-10-29T12:14:00.112Z
TipAmount
CZ: Numer referencyjny wprowadzony podczas żądania płatności.
EUR
totalAmount
PL: Numer referencyjny wprowadzony podczas płatności
wynik
CZ: Służy do anulowania transakcji. Użyj otrzymanej wartości, która była częścią transakcji, którą chcesz anulować.
2
cardEntryMode
PL: Służy do anulowania transakcji. Używa otrzymanej wartości, która była częścią transakcji, którą chcesz anulować.
12
transactionID
PL: Określa typ transakcji.
0 = completed
authorizationCode
PL: Określa typ transakcji.
-1 = declined
cardNumber
CZ: Wskazuje czas transakcji.
BEZKONTAKTOWY
pinOk
PL: Podaj datę transakcji.
001000000
KOD
CZ: Trzycyfrowe kody walut ISO - lista znajduje się na stronie Wiki.
123456
emvAid
PL: kod ISO waluty składający się z trzech znaków.
0001
cardType
CZ: Unikalny identyfikator sprzedawcy, zwykle reprezentujący identyfikator lokalizacji.
prawda/fałsz
PL: unikalny identyfikator sprzedawcy, zazwyczaj identyfikator lokalizacji
approved
CZ: Wskazówki. Wypełnione, jeśli zostało wprowadzone.
A0000000031010
PL: Wskazówka. Wypełnione w razie potrzeby.
VISA
CZ: Udává celkovou čásku transakce (včetně spropitného).
MASTER
PL: Wskazuje całkowitą kwotę transakcji (w tym napiwek).
CZ: Odpowiedź na wniosek.
PL: Wynik żądania.
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.
CZ: Unikalny identyfikator generowany przez aplikację płatniczą podczas procesu rejestracji transakcji.
PL: Unikalny identyfikator generowany przez aplikację płatniczą podczas procesu rejestracji transakcji.
CZ: Należy wypełnić tylko wtedy, gdy transakcja zostanie zatwierdzona.
PL: Jest obecny tylko wtedy, gdy transakcja jest przetwarzana.
CZ: Numer karty (PAN). Występuje w formie zamaskowanej.
PL: Numer karty (PAN), obecny w formie zamaskowanej.
CZ: Wyświetla wynik transakcji podczas autoryzacji.
PL: Pokazuje wynik transakcji po stronie autoryzacji.
CZ: identyfikuje aplikację EMV używaną do przetwarzania transakcji.
PL: identyfikuje aplikację EMV używaną do przetwarzania transakcji.
CZ: Identyfikuje typ używanej karty.
PL: Identyfikuje typ używanej karty.