---
title: "2. Požadavek na platbu [transactionRequestV2]"
description: "![](https://www.gptom.com/wp-content/uploads/2022/05/warning_white_small.png) Upozornění Pro získání detailu transakce je nutné doptávat se pouze pomocí Inquiry requestu: **TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException** Po obdržení ID transakce by vaše aplikace měla vygenerovat a odeslat požadavek na transakci. Platební aplikace spustí celý platební proces…"
url: "https://www.gptom.com/el/docs/api/app2app/2-pozadavek-na-platbu-transactionrequestv2/"
updated: "2026-10-21"
category: app2app API
---

# 2. Požadavek na platbu [transactionRequestV2]

![](https://www.gptom.com/wp-content/uploads/2022/05/warning_white_small.png)

Upozornění

Pro získání detailu transakce je nutné doptávat se pouze pomocí Inquiry requestu:

**TransactionInquire(String transactionId, IInquireResultListener listener) throws RemoteException**

Po obdržení ID transakce by vaše aplikace měla vygenerovat a odeslat požadavek na transakci. Platební aplikace spustí celý platební proces a vrátí výsledek. Ve starších verzích (níže než verze 1.2.) byla k získání výsledku transakce použita synchronní komunikace (funkce naslouchání je zastaralá). Pro novou verzi je komunikace asynchronní, kde se pro získání aktuálního stavu transakce používá metoda getTransactionState.

void transactionRequestV2(String transactionRequesJsonString, ITransactionResultListener listener) throws RemoteException

## Request \[TransactionRequestV2Entity\]

Na základě typu transakce jsou následující pole povinná/nepovinná/volitelná:

\[(M) povinné, (O) volitelná)\]

     Jméno / Name
 amount
 cancelMode
 clientID
 originReferenceNum
 originTransactionID
 printByPaymentApp
 tipAmount
 transactionID
 transactionType
 redirectPackageName (deprecated)
 redirectInfo
 clientInfo
 preferableReceiptType
 tipCollect
 PaymentMethod (from version 1.64.5)   Type
 Long
 Integer
 String
 String
 String
 Boolean
 Long
 String
 Integer
 String
 TransactionRequestRedirectInfoEntity
 ClientInfoEntity
 ReceiptType
 Boolean
 enum   Příklad / Example
 15500
 1

 3b06e9dd-1158-48c2-ba6e-6a5ce4750f5f
 true
 500
 300e5d79-8764-4d7c-ad0c-ea02ba2b0fe4
 1
 com.example.integrationapp
 com.example.integrationapp
 contact":{"email":"","phone":""}
 PHONE
 true
 CASH
 CARD
 ACCOUNT_PAYMENT
 BLIK_PAYMENT
 PAYMENT_GATEWAY   Sale
 M

 O
 O

 O
 O
 M
 M

 O
 O   Storno

 M
 O

 M

 M
 M

 O   Close batch

 O

 M
 M                ![](https://www.gptom.com/wp-content/uploads/2022/05/warning_white_small.png)

Upozornění

Formát pro všechny částky je na dvě desetinná místa, takže například 50 Kč by mělo být vyplněno jako 5000.

Popis polí

amount

Částka určuje objem transakce. Tato částka se počítá v domácí měně, kterou používá terminál. Formát je na dvě desetinná místa, takže například 50 Kč by mělo být vyplněno jako 5000.

tipAmount

V restauracích můžete požádat zákazníka o přidání spropitného, kde spropitného je zadána za Vašeho systému. Tato částka se pak přičte k původní částce zadané obchodníkem.

transactionID

Jedinečné ID generované platební aplikací během procesu registrace transakce.

clientID

    Volitelná kontrola přihlášeného uživatele. Více [zde](https://www.gptom.com/docs/api/app2app/id-klienta/).

transactionType

Typ transakce definuje typ transakce, kterou chcete zahájit. Dostupné hodnoty jsou:

- SALE(1)
- VOID(2)
- REFUND(3) - since version 1.75.4, AIDL 1.28
- CLOSE_BATCH(4)

originTransactionID

Používá se pro storno transakce a měl by obsahovat ID transakce, kterou chcete zrušit.

originReferenceNum

Toto pole je volitelné a může být vyplněno referenčním číslem – libovolným řetězcem AN s maximálně 20 znaky. Tento řetězec je viditelný ve všech přehledech transakcí a pomáhá účetním oddělením spárovat platby s objednávkami. Diakritika není podporována.

cancelMode

    1 - Last transaction

2 - Older transactions

printByPaymentApp

Definuje, zda účtenku klientovi předá vaše aplikace nebo Genius mobile pay. Výchozí hodnota je true (tedy Genius mobile pay nabídne způsob předání účtenky klientovi). Pokud pošlete hodnotu "false", ihned po transakci vrátíme uživatele do vaší aplikace a předání účtenky je na vás.

clientInfo

Pokud budete odesílat účtenku přímo z aplikace Genius mobile pay, je možné přes API předvyplnit email nebo tel. číslo zákazníka.

preferableReceiptType

V případě odeslání účtenky z aplikace Genius mobile pay je možné přes API předdefinovat způsob odeslání účtnky. Možné hodnoty jsou:

- PHONE
- EMAIL
- QR
- PRINT

tipCollect

Volitelné pole, které vyvolává obrazovku zadání spropitného v aplikaci Genius mobile pay. Po zadání spropitného v aplikaci se následně zobrazí obrazovka pro přiložení karty. Pro vyvolání této obrazovky je potřeba mít také aktivované spropitné v aplikaci

PaymentMethod

Od verze 1.64.5 jsme přidali možnost volat další platební metody přes app2app API pomocí pole PaymentMethod. Aktuální možnosti jsou:
CASH - hotovostní platby
CARD - karetní platby
ACCOUNT_PAYMENT - platba účtem (nová platební metoda pro CZ trh)

Pokud se pole nevyplní, vychozí hodnota je nastavena na CARD.