Token único por cartão

Recupere um identificador único e criptografado do cartão usando o Plugin SmartPOS.

Quando usar

Use o token único por cartão quando sua aplicação precisar identificar o mesmo cartão de forma criptografada.

Esse recurso pode ser útil para:

• métricas baseadas em cliente;
• identificação recorrente de uso de um cartão;
• associação interna de eventos do app ao cartão;
• análises operacionais sem armazenar dados sensíveis do cartão.

Pré-requisitos

Antes de solicitar o token do cartão:

    1. Ative o terminal em Ativação SmartPOS.

    2. Inicialize o SDK e plugue o SmartPOSPlugin em Inicialização SmartPOS.

    3. Solicite as permissões Android necessárias em tempo de execução.

    4. Prepare a interface para exibir mensagens solicitando a inserção do cartão.

Classe utilizada

Para recuperar o token único por cartão, use a classe SmartPOSCardFingerprintRequestBuilder.

A requisição é criada por:

SmartPOSPlugin.createCardFingerprintRequestBuilder()

Exemplo

val cardFingerprintRequest = SmartPOSPlugin.createCardFingerprintRequestBuilder()
    .callback(object: Callback<SmartPOSCardFingerprintResponse>() \{
        override fun onFail(error: Throwable) {
            // Falha ao solicitar o dado
        }

        override fun onSuccess(response: SmartPOSCardFingerprintResponse) {
            response.fingerprint // Token
        }
    \})
    .messageCallback(object: Callback<MessageCallbackRequestField.MessageData>() \{
        override fun onFail(error: Throwable) {
            // Falha no fluxo de mensagens
        }

        override fun onSuccess(response: MessageCallbackRequestField.MessageData) {
            // Pode ser uma mensagem solicitando a inserção do cartão
            response.message
        }
    \})
    .build()

Zoop.post(cardFingerprintRequest)

Retorno

A requisição retorna um objeto SmartPOSCardFingerprintResponse.

data class SmartPOSCardFingerprintResponse(
    val fingerprint: String,         // Fingerprint do cartão.
    val cardBrand: CardBrand? = null // Bandeira do cartão, pode ser inconsistente caso não seja identificada corretamente pelo BIN.
)

Callbacks

.callback

Controla o fluxo principal de recuperação do fingerprint.

.messageCallback

Recebe mensagens do fluxo, como uma solicitação para inserir o cartão.

Relação com transações

Se você já executa pagamentos, pode obter o fingerprint diretamente no retorno da transação.

O campo está disponível em TransactionData:

val fingerprint = transactionData.cardFingerprint

Use a requisição dedicada apenas quando precisar obter o fingerprint sem executar uma transação.

Checklist do token de cartão

Antes de enviar a requisição com Zoop.post(cardFingerprintRequest), confirme:

• O SDK foi inicializado com credenciais.
• O SmartPOSPlugin foi plugado.
• A interface exibe mensagens do messageCallback.
• O app trata sucesso e falha no callback principal.
• O app sabe como usar fingerprint sem armazenar dados sensíveis do cartão.
• O app não depende dessa requisição para concluir um fluxo transacional.

Próximo passo

Depois de implementar token único por cartão, consulte Relatórios SmartPOS para gerar relatórios de transações ou Último recibo SmartPOS para recuperar a última transação.