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.

    TokenApi tokenService = new TokenService();
    ExternalTerminal terminal = createExternalTerminal();

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

    tokenService.token(terminal, TokenPurpose.TRACKING, tokenDelegate);

Normal Abort After Card Detection

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);

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 After Card Detection

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);

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);

How to get a Mifare UID via CardDetection call

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

    TokenApi tokenService = new TokenService();
    ExternalTerminal terminal = createExternalTerminal();
    terminal.supportMifareCards(true);

    TokenDelegate tokenDelegate = new TokenDelegate() {
        ... 

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

        ...
    };

    tokenService.token(terminal, TokenPurpose.TRACKING, tokenDelegate);

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);