Payment Features / Authorise - Android SDK

Intro

The goal of a Authorise transaction is carrying out a transaction to reserve funds for a transaction done later.
A successful Authorisation ensures the reservation of funds and gives a guarantee for the reserved amount.\

Authorisation on an Unattended IM30 terminal

How to perform a CardPreAuthorisation (EV-Charging environment only)

The following code snippet demonstrates how you can perform a CardPreAuthorisation.

    PaymentApi paymentService = new PaymentService();
    TokenDelegate tokenServiceDelegate = new TokenDelegate() {
    ...
    };

    PreAuthorisationRequest.PreAuthorisationRequestBuilder preAuthorisationRequest = PreAuthorisationRequest.builder()
                .minimumAmount(Money.EUR(2.00))
                .totalAmount(Money.EUR(50.00))
                .environment(Environment.EVCHARGING)
                .tokenPurpose(TokenPurpose.TRACKING)
                .referenceNumber(Integer.valueOf(tokenSuccessResult.requestID()));

    paymentService.preAuthorisation(terminal, preAuthorisationRequest.build(), tokenServiceDelegate);

How to perform a CardPreAuthorisation with Mifare cards

The following code snippet demonstrates how you can perform a CardPreAuthorisation with Mifare cards.
After starting the CardPreAuthorisation, the user can tap a Mifare card.
This will result in an OnError because the terminal was unable to process the CardPreAuthorisation request.
The terminal will return the UID of the Mifare card, this way the POS can validate the Mifare card.

    PaymentApi paymentService = new PaymentService();

    ExternalTerminal terminal = createExternalTerminal();
    terminal.supportMifareCards(true);

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

    PreAuthorisationRequest.PreAuthorisationRequestBuilder preAuthorisationRequest = PreAuthorisationRequest.builder()
                .minimumAmount(Money.EUR(2.00))
                .totalAmount(Money.EUR(50.00))
                .environment(Environment.EVCHARGING)
                .tokenPurpose(TokenPurpose.TRACKING)
                .referenceNumber(Integer.valueOf(tokenSuccessResult.requestID()));

    paymentService.preAuthorisation(terminal, preAuthorisationRequest.build(), tokenServiceDelegate);

Authorisation on an OPI-DE terminal

    PaymentApi paymentService = new PaymentService();
    PaymentDelegate paymentDelegate = new PaymentDelegate() {
        ...
    };


    Money money = new Money(new BigDecimal("10.00"), Currency.getInstance("EUR"));

    Payment payment = Payment
            .builder()
            .type(Payment.Type.PREAUTHORIZATION)
            .amount(money)
            .build();

    paymentService.payment(externalTerminal, payment, paymentDelegate);

Extended Authorisation on an OPI-DE terminal

    PaymentApi paymentService = new PaymentService();
    PaymentDelegate paymentDelegate = new PaymentDelegate() {
        ...
    };


    Money money = new Money(new BigDecimal("15.00"), Currency.getInstance("EUR"));

    Payment payment = Payment
            .builder()
            .type(Payment.Type.EXTENDED_PREAUTHORIZATION)
            .amount(money)
            .transactionId("122") // STAN of the preauthorization you want to extend (Can be found in the paymentResult of the preauthorization)
            .approvalCode("123456789") // ApprovalCode of the preauthorization you want to extend (Can be found in the paymentResult of the preauthorization)
            .build();

    paymentService.payment(externalTerminal, payment, paymentDelegate);