SDK Guides / Retrieve Last Ticket - Android SDK

Intro

With this guide we will use the TerminalService to retrieve the Customer/Merchant receipt and EJournal of the last performed transaction from the terminal.

When to perform a RetrieveLastTicket

1. When the terminal could not sent the receipts of the last transaction to the POS application then the terminal comes in a block state. You can recognize this when in the onError(Error error) method error.result().resultState().equals(ResultState.PRINT_LAST_TICKET). This blocked state can only be resolved by performing a RetrieveLastTicket.
2. When you want to retrieve the receipts of the last transaction.

How to perform a RetrieveLastTicket

    ExternalTerminal externalTerminal = ExternalTerminal.builder()
            .ipAddress(ipAddress) // can be found using getting-started guide
            .port(terminalPort) // 4100 for OPI-NL & 20002 for OPI-DE
            .compatibilityPort(compatibilityPort) // 4102 for OPI-NL & 20007 for OPI-DE
            .socketMode(socketMode) // Dual-Socket for OPI-NL & Single-Socket for OPI-DE & OPI-NL
            .terminalType(terminalType) // EnumType which contains terminal protocol
            .build();

    TerminalDelegate terminalDelegate = new TerminalDelegate() {

        @Override
        public void onPaymentAdministrationSuccess(PaymentAdministrationResult result) {
            //contains code which handles a successful reprint ticket
        }

        @Override
        public void onError(Error error) {
            //contains code which handles a failed reprint ticket
        }

        @Override
        public void printMerchantReceiptAndSignature(PaymentReceipt receipt) {
            //contains code which handles receiving a merchant receipt
        }

        @Override
        public void printCustomerReceiptAndSignature(PaymentReceipt receipt) {
            //contains code which handles receiving a customer receipt
        }

        @Override
        public void storeEJournal(String journal) {
            //contains code which handles storing a E-Journal
        }
    };

    TerminalApi terminalService = new TerminalService();
    terminalService.retrieveLastTicket(externalTerminal, terminalDelegate);