What exactly is a batch? Every transaction you create forms part of what is known as a batch. Just like a receipt, each batch has its own number and is a collection of transactions. A ‘batch close’ is an administrative operation whereby the terminal closes the batch and instructs the systems to close the batch and open a new one.
Initialisation of the cut-off date
The transaction can be initiated by calling:
gptom://batch/close?…
where the following parameters are used to build the report:
EN: The URL of your application to which we will redirect the client once the close batch has been completed.
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.
Example call:
gptom://batch/close?preferableReceiptType=QR&redirectUrl=gp://batch/close&clientEmail=info@gptom.com&clientID=223&printByPaymentApp=true&clientPhone=+420606505404
The answer will contain the following fields:
EN: Gives information in which state has your request ended.
CANCELED
ERROR
EN: Total number of voided transactions.
EN: Total amount of the close batch.
EN: Number of all transactions in the closing batch.
EN: Total number of SALE transactions.
EN: Number of voided transactions in the closing batch.
EN: Date of the previous batch.
EN: Date on which this batch was processed.
EN: Number of SALE transactions in the closing batch.
EN: Date of the first transaction in the closing batch.
EN: Here you will find an overview by payment method.
CARD
Example of a statement of accounts detail:
{
„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“
}
