Payment Features / Card Token - Android SDK

Intro

This guide explains how to receive a CardToken for OPI-NL using one of the following methods: payment, token, reservation, cardValidation, or repeatLastMessage.

If you’re using OPI-DE with secPOS, please refer to the relevant documentation on how to request a CardToken.

How to request a CardToken

The following code snippet demonstrates how you can receive a CardToken.

    ExternalTerminal externalTerminal = ExternalTerminal.builder()
            .. // other ExternalTerminal properties
            .requestToken(true/false) // true if you want to receive a CardToken (Default is false)
            .build();

How you receive the CardToken with the different actions

When you perform a payment or reservation action you will receive the CardToken back with the PaymentResult like this:

    PaymentDelegate paymentDelegate = new PaymentDelegate() {

        @Override
        public void onPaymentSuccess(PaymentResult result) { 
            String cardToken = result.cardToken();   
        }
        
        .. // other PaymentDelegate methods
    };

When you perform a token or cardValidation action you will receive the CardToken back with the TokenResult like this:

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

    TokenDelegate tokenDelegate = new TokenDelegate() {
        @Override
        public void onTokenSuccess(TokenResult tokenResult) {
            String cardToken = tokenResult..authorisationResponse().cardToken();
        }
        
        .. // other TokenDelegate methods
    };

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

When you perform a repeatLastMessage you will receive the CardToken back with the PaymentAdministrationResult like this:

    TerminalDelegate terminalDelegate = new TerminalDelegate() {

        @Override
        public void onPaymentAdministrationSuccess(PaymentAdministrationResult result) { 
            String cardToken = ((PaymentResult) result.result).cardToken();
        }
        
        .. // other PaymentDelegate methods
    };