Transakcja sprzedaży to podstawowa operacja płatnicza, która przenosi określoną kwotę z konta bankowego posiadacza karty na konto sprzedawcy.
Jeśli chodzi o proces płatności, procedura wygląda następująco:
Tworzenie transakcji
Transakcja może zostać zainicjowana przez wywołanie:
gptom://transaction/create?…
gdzie do utworzenia raportu używane są następujące parametry:
Zmienna/Pole
Format/Format
Opis/Description
Przykład
kwota
OBOWIĄZKOWE
OBOWIĄZKOWE
długi
CZ: Kwota transakcji z dwoma miejscami po przecinku.
PL: Kwota transakcji z dwoma miejscami po przecinku.
PL: Kwota transakcji z dwoma miejscami po przecinku.
1000 (=10CZK/EURO)
clientID
ciąg
CZ: Opcjonalne sprawdzenie zalogowanego użytkownika. W tym miejscu sprawdzany jest klucz API terminala.
PL: Opcjonalne sprawdzenie zalogowanego użytkownika. Tutaj sprawdzany jest klucz API terminala.
PL: Opcjonalne sprawdzenie zalogowanego użytkownika. Tutaj sprawdzany jest klucz API terminala.
originReferenceNum
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ń.
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ń.
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ń.
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.
Określa, czy paragon jest przekazywany do klienta przez aplikację, czy przez GP Tom. Domyślną wartością jest true (tj. GP zaoferuje sposób 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.
Określa, czy paragon jest przekazywany do klienta przez aplikację, czy przez GP Tom. Domyślną wartością jest true (tj. GP zaoferuje sposób 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.
prawda/fałsz
TipAmount
długi
CZ: W restauracjach można poprosić klienta o dodanie napiwku, który jest wprowadzany z systemu. Kwota ta jest następnie dodawana do pierwotnej kwoty wprowadzonej przez sprzedawcę.
PL: W restauracjach można poprosić klienta o dodanie napiwku, który jest wprowadzany do systemu. Kwota ta jest następnie dodawana do pierwotnej kwoty wprowadzonej przez sprzedawcę.
PL: W restauracjach można poprosić klienta o dodanie napiwku, który jest wprowadzany do systemu. Kwota ta jest następnie dodawana do pierwotnej kwoty wprowadzonej przez sprzedawcę.
1000 (=10CZK/EURO)
redirectUrl
ciąg
CZ: Adres URL aplikacji, na który przekierujemy klienta po zakończeniu płatności.
PL: Adres URL aplikacji, na który przekierujemy klienta po zakończeniu płatności.
PL: Adres URL aplikacji, na który przekierujemy klienta po zakończeniu płatności.
fb://success
TipCollect
bool
CZ: Opcjonalne pole, które wyświetla ekran wprowadzania napiwku w aplikacji GP tom. Po wprowadzeniu napiwku w aplikacji wyświetlany jest ekran dołączania karty. Aby wyświetlić ten ekran, w aplikacji muszą być również włączone napiwki.
PL: Opcjonalne pole, które powoduje wyświetlenie ekranu wprowadzania napiwku w aplikacji GP tom. Po wprowadzeniu napiwku w aplikacji wyświetlony zostanie ekran umożliwiający dołączenie karty. Aby wyświetlić ten ekran, w aplikacji musi być włączona funkcja napiwków.
PL: Opcjonalne pole, które powoduje wyświetlenie ekranu wprowadzania napiwku w aplikacji GP tom. Po wprowadzeniu napiwku w aplikacji wyświetlony zostanie ekran umożliwiający dołączenie karty. Aby wyświetlić ten ekran, w aplikacji musi być włączona funkcja napiwków.
prawda / fałsz
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
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
transactionType
ciąg
PL: Typ transakcji określa typ transakcji, którą chcesz zainicjować. Dostępne wartości to:
PL:Transaction Type określa typ transakcji, która ma zostać zainicjowana. Dostępne wartości to:
GOTÓWKA
KARTA
ACCOUNT_PAYMENT
BLIK_PŁATNOŚĆ
PAYMENT_GATEWAY
PL:Transaction Type określa typ transakcji, która ma zostać zainicjowana. Dostępne wartości to:
GOTÓWKA
KARTA
ACCOUNT_PAYMENT
BLIK_PŁATNOŚĆ
PAYMENT_GATEWAY
KARTA
Przykład połączenia:
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
Odpowiedź będzie zawierać następujące pola:
Pole/Pola
Format
Opis/Description
Przykład
STATUS ZADANIA
CZ: Podaje 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
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.
emvAid
CZ: identyfikuje aplikację EMV używaną do przetwarzania transakcji.
PL: identyfikuje aplikację EMV używaną do przetwarzania transakcji.
PL: identyfikuje aplikację EMV używaną do przetwarzania transakcji.
A0000000031010
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
cardType
CZ: Identyfikuje typ używanej karty.
PL: Identyfikuje typ używanej karty.
PL: Identyfikuje typ używanej karty.
VISA
MASTER
MASTER
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: Wskazuje całkowitą linię transakcji (w tym napiwek).
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 - transakcja zatwierdzona
-1 - transakcja odrzucona
-1 - transakcja odrzucona
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: 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
authorizationCode
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
pinOk
prawda/fałsz
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
KOD
CZ: Wyświetla wynik transakcji podczas autoryzacji.
PL: Pokazuje wynik transakcji po stronie autoryzacji.
PL: Pokazuje wynik transakcji po stronie autoryzacji.
zaakceptowany