Payment Features / Card Detection - Android SDK

Intro

The function CardDetection is used as a kind of Early Card Detect, and the CardDetectionResponse can contain data (TrackingToken) to recognize a card (or cardholder) in an anonymous way.

A TrackingToken is a secure representation of a PAN used for Customer recognition and tracking. Examples are:

• To recognize who is operating the OPT (supporting multiple sessions) in Petrol and EV Charging environment
• Arrival at a car park entry, to register the drive-in event and validate the card used
• Departure from a car park, to determine the amount of time spent in the car park and to pay the amount involved
• In a (retail)shop this token can be used to create anonymous customer tracking or anonymous basket analysis

Tracking tokens have a length of 18 characters and always starts with ‘99’ to indicate the full PAN was used during calculation of the token.

How to get a tracking token

The following code snippet demonstrates how you can start a Tracking token request.

    TerminalApi terminalService = new TerminalService();
    ExternalTerminal terminal = createExternalTerminal()
                                    .includeFlexo(true)
                                    .requestToken(true);

    TerminalDelegate terminalDelegate = new terminalDelegate() {
    ...
    };

    terminalService.cardDetection(terminal, CardDetectionRequest.builder().tokenPurpose(TokenPurpose.TRACKING).build(), terminalDelegate);

How to get a Mifare UID via Flexo

The following code snippet demonstrates how you can get a Mifare UID via Flexo.

    TerminalApi terminalService = new TerminalService();
    ExternalTerminal terminal = createExternalTerminal()
                                    .includeFlexo(true)
                                    .requestToken(true);

    TerminalDelegate terminalDelegate = new terminalDelegate() {
        ... 

        @Override
        public void onPaymentAdministrationSuccess(PaymentAdministrationResult result) { 
            String cardToken = result.tokenItem().token();   
        }

        ...
    };

    terminalService.cardDetection(terminal, CardDetectionRequest.builder().includeCardTunnel(true).build(), terminalDelegate);

How to get a Mifare UID via CardTunnel (only possible for ApasPP/acCEPT OPI-NL terminals)

The following code snippet demonstrates how you can get a Mifare UID via CardTunnel. This is only possible for ApasPP/acCEPT OPI-NL terminals.

    TerminalApi terminalService = new TerminalService();
    ExternalTerminal terminal = createExternalTerminal();

    TerminalDelegate terminalDelegate = new terminalDelegate() {
        ... 
        
        @Override
        public void onPaymentAdministrationSuccess(PaymentAdministrationResult result) {
            // This is a list of parameters returned by the Flexo containing the UID, CardType and CardSlotNo
            result.flexoParameters();
        }

        @Override
        public void cardUID(String cardUID) {
            ...
        }

        ...
    };

    terminalService.cardDetection(terminal, CardDetectionRequest.builder().includeFlexo(true).build(), terminalDelegate);

Normal Abort After Card Detection

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

    boolean isSilent = false;
    TerminalApi terminalService = new TerminalService();
    ExternalTerminal terminal = createExternalTerminal();

    TerminalDelegate terminalDelegate = new terminalDelegate() {
    ...
    };

    terminalService.abort(isSilent, terminal, terminalDelegate);

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

    boolean isSilent = false;
    TerminalApi terminalService = new TerminalService();
    ExternalTerminal terminal = createExternalTerminal();

    TerminalDelegate terminalDelegate = new terminalDelegate() {
    ...
    };

    terminalService.abortOnNewConnection(isSilent, terminal, terminalDelegate);

Silent Abort After Card Detection

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

    boolean isSilent = true;
    TerminalApi terminalService = new TerminalService();
    ExternalTerminal terminal = createExternalTerminal();

    TerminalDelegate terminalDelegate = new terminalDelegate() {
    ...
    };

    terminalService.abort(isSilent, terminal, terminalDelegate);

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

    boolean isSilent = true;
    TerminalApi terminalService = new TerminalService();
    ExternalTerminal terminal = createExternalTerminal();

    TerminalDelegate terminalDelegate = new terminalDelegate() {
    ...
    };

    terminalService.abortOnNewConnection(isSilent, terminal, terminalDelegate);

How to get a card token on SecPOS Evo terminals

The following code snippet demonstrates how you can get a card token on terminals running SecPOS Evo.

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

    Payment payment = Payment
            .builder()
            .type(Payment.Type.SALE)
            .hashAlgorithm(HashAlgorithm.DEFAULT)
            .amount(money)
            .build();

    PaymentApi paymentService = new PaymentService();
    ExternalTerminal terminal = createExternalTerminal();

    PaymentDelegate paymentDelegate = new PaymentDelegate() {
        @Override
        public void onPaymentSuccess(PaymentResult result) {
            // The payment is completed successful!
            // The paymentResult contains all information about the transaction            
        }
    
        @Override
        public void onError(Error error) {
            // The payment failed
            // The Error object contains information about what went wrong
        }
        
        ...
    };


    paymentService.payment(terminal, payment, paymentDelegate);