Co přesně je dávka? Každá transakce, kterou vytvoříte, patří do tzv. dávky. Stejně jako účtenka má každá dávka své číslo a je balíčkem transakcí. Uzávěrka je administrativní operace, pomocí které terminál uzavře dávku a vyzve systémy, aby se dávka uzavřela a otevřela nová.
Inicializace uzávěrky
Transakci lze iniciovat zavoláním:
gptom://batch/close?…
kde jsou použity následující parametry pro sestavení zprávy:
EN: The URL of your application to which we will redirect the client after the close batch is complete.
EN: Defines whether the receipt is passed to the client by your application or Genius mobile pay. 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.
EN: In the case of sending a receipt from the Genius mobile pay application, it is possible to predefine the method of sending the receipt via the API. Possible values are:
PHONE
QR
EN: Client phone number.
EN: Client email address.
Příklad volání:
gptom://batch/close?preferableReceiptType=QR&redirectUrl=gp://batch/close&clientEmail=info@gptom.com&clientID=223&printByPaymentApp=true&clientPhone=+420606505404
Odpověď bude obsahovat následující pole:
EN: Gives information in which state has your request ended.
CANCELED
ERROR
EN: Total amount of voided transactions.
EN: Total amount of close batch.
EN: Number of all transactions in the close batch.
EN: Total amount of SALE transactions.
EN: Amount of voided transactions in the close batch.
EN: Date of the previous batch.
EN: Date of processing this close batch.
EN: Number of SALE transactions in the close batch.
EN: Date of the first transaction in the close batch.
EN: Here you will find overview per payment method.
CARD
Příklad detailu uvávěrky:
{
“communicationId” :
“BA984981”,
“voidAmount” : 15.6,
“tipCount” : 0,
“tipAverage” : 0,
“totalAmount” : 15,
“tipAmount” : 0,
“totalCount” : 16,
“saleAmount” : 30.600000000000001, “voidCount” : 7,
“firstTransactionDate” : “2026-10-08T18:03:06.220Z”,
“date” : “2026-10-08T18:39:57.738Z”,
“previousBatchDate” : “2026-10-08T14:28:00.789Z”,
“saleCount” : 9,
“invalidCount” : 3,
“amsId” : “b8354285-1360-4c2b-a711-91133a7d0688”,
},
“BLIK_PAYMENT” : {
“voidCount” : 0,
“saleCount” : 0,
“saleAmount” : 0,
“totalCount” : 0,
“totalAmount” : 0,
“voidAmount” : 0
},
“CARD” : {
“voidCount” : 7,
“saleCount” : 7,
“saleAmount” : 15.6,
“totalCount” : 14,
“totalAmount” : 0,
“voidAmount” : 15.6
},
“PAYMENT_GATEWAY” : {
“voidCount” : 0,
“saleCount” : 0,
“saleAmount” : 0,
“totalCount” : 0,
“totalAmount” : 0,
“voidAmount” : 0
},
“ACCOUNT_PAYMENT” : {
“voidCount” : 0,
“saleCount” : 0,
“saleAmount” : 0,
“totalCount” : 0,
“totalAmount” : 0,
“voidAmount” : 0
}
},
“tipAveragePercentage” : 0,
“currency” : “CZK”
}
