Basic Operations / Stop Ongoing Payment

Intro

To stop an ongoing payment the POS will send an “AbortRequest” to the terminal. it is not guaranteed that the transaction will actually be aborted. The decision, if a transaction can be aborted, is taken by the payment application running the transaction.

The steps to stop an ongoing payment can be found below.
For the IM30/Unattended configured terminals we created a separate example/topic which can be found by clicking here

Abort/Stop

The main method to abort/stop an ongoing payment is using the same socket/connection. If you have an OPI-NL configured terminal you can also abort an ongoing payment on using a new socket/connection.

On the same connection/socket

The following code snippet demonstrates how you can abort on the same connection/socket

    TerminalDelegate terminalDelegate = new TerminalDelegate() {
        @Override
        public void onPaymentAdministrationSuccess(PaymentAdministrationResult result) {
            //Successful abort
        }

        @Override
        public void onError(Error error) {
            //Failed abort
        }
    };

    PaymentApi paymentService = new PaymentService();
    paymentService.abort(externalTerminal, terminalDelegate);

###Abort On New Connection

The following code snippet demonstrates how you can do a Normal Abort on a new connection

    TerminalDelegate terminalDelegate = new TerminalDelegate() {
        @Override
        public void onPaymentAdministrationSuccess(PaymentAdministrationResult result) {
            //Successful abort
        }

        @Override
        public void onError(Error error) {
            //Failed abort
        }
    };

    PaymentApi paymentService = new PaymentService();
    paymentService.abortOnNewConnection(externalTerminal, terminalDelegate);

Abort On Pax IM30 (Unattended Environment)

###What is the difference between a Normal Abort and a Silent Abort? When performing a Normal Abort the terminal will send an CashierDisplayMessage with the message “Aborted”. With a Silent Abort no CashierDisplayMessage is sent from the terminal.

Normal Abort

The following code snippet demonstrates how you can do a Normal Abort

    boolean isSilent = false;
    TokenApi tokenService = new TokenService();
    ExternalTerminal terminal = createExternalTerminal();

    TokenDelegate tokenDelegate = new TokenDelegate() {
    ...
    };

    tokenService.abort(isSilent, terminal, tokenDelegate);

Silent Abort

The following code snippet demonstrates how you can do a Silent Abort.

    boolean isSilent = true;
    TokenApi tokenService = new TokenService();
    ExternalTerminal terminal = createExternalTerminal();

    TokenDelegate tokenDelegate = new TokenDelegate() {
    ...
    };

    tokenService.abort(isSilent, terminal, tokenDelegate);

Normal Abort On New Connection

The following code snippet demonstrates how you can do a Normal Abort on a new connection

    boolean isSilent = false;
    TokenApi tokenService = new TokenService();
    ExternalTerminal terminal = createExternalTerminal();

    TokenDelegate tokenDelegate = new TokenDelegate() {
    ...
    };

    tokenService.abortOnNewConnection(isSilent, terminal, tokenDelegate);

Silent Abort On New Connection

The following code snippet demonstrates how you can do a Silent Abort on a new connection.

    boolean isSilent = true;
    TokenApi tokenService = new TokenService();
    ExternalTerminal terminal = createExternalTerminal();

    TokenDelegate tokenDelegate = new TokenDelegate() {
    ...
    };

    tokenService.abortOnNewConnection(isSilent, terminal, tokenDelegate);