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 poprzez 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
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 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.
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 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
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 musi być również włączona funkcja napiwków.
PL: Opcjonalne pole, które wyświetla ekran wprowadzania napiwku w aplikacji GP tom. Po wprowadzeniu napiwku w aplikacji wyświetlony zostanie ekran dołączania karty. Aby wyświetlić ten ekran, w aplikacji musi być również włączona funkcja napiwków.
PL: Opcjonalne pole, które wyświetla ekran wprowadzania napiwku w aplikacji GP tom. Po wprowadzeniu napiwku w aplikacji wyświetlony zostanie ekran dołączania karty. Aby wyświetlić ten ekran, w aplikacji musi być również 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: 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
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óra ma zostać zainicjowana.
Dostępne wartości to: PL:Typ transakcji określa typ transakcji, którą chcesz zainicjować.
Dostępne wartości to: CASH CARD
Dostępne wartości to: PL:Typ transakcji określa typ transakcji, którą chcesz zainicjować.
Dostępne wartości to: CASH CARD
GOTÓWKA/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
PL: Podaje informacje, w którym stanie zakończyło się żądanie. PL: Podaje informacje, 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.
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 żą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
cardType
CZ: identyfikuje typ używanej karty.
PL: Określa typ używanej karty.
PL: Określa typ używanej karty.
VISA MASTER
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 - transakcja zatwierdzona -1 - transakcja odrzucona
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: 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
authorizationCode
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
pinOk
prawda/fałsz
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
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.
zaakceptowany