Mostrar un PIN

Esta sección describe cómo mostrar el PIN de la tarjeta de forma segura.

D1 actualmente admite bloque PIN ISO 0 devuelto por el backend del emisor.

Experiencia del usuario

Pantalla de ejemplo para mostrar el PIN en la aplicación del emisor

Flujo

Flujo de alto nivel para mostrar un PIN

1. Usuario final se autentica en la aplicación del emisor y solicita el PIN.
2. La aplicación del emisor llama al método de visualización de PIN del SDK de D1.
3. El SDK de D1 llama al backend de D1 API “Obtener PIN”.
4. El backend de D1 solicita el bloque PIN al backend del emisor (D1 no almacena PINs).
5. backend de D1 transcifra el bloque PIN desde las claves del emisor a las claves del dispositivo.
6. El SDK muestra el PIN en una interfaz segura durante un tiempo limitado.

Diagrama de secuencia

Pre-requisitos

• Usuario final, cuenta y tarjeta ya registrados en D1
• El SDK está correctamente inicializado
• La aplicación del emisor llamó a la API de inicio de sesión del SDK de D1.
• El backend del emisor expone el endpoint “Obtener PIN” y devuelve bloque PIN ISO 0.

Diagrama de secuencia para la visualización del PIN

CardPINUI contiene PINDisplayTextView (Android) y D1PINDisplayTextField (iOS), que heredan del TextView y UITextField. La configuración del campo de texto (fuente, tamaño, color) puede hacerse usando las propiedades de estos objetos nativos.

Seguridad y cumplimiento

• La visualización del PIN ocurre en una interfaz segura y resistente a manipulaciones.
• Los datos del PIN no se persisten en el dispositivo.
• El intercambio de datos está cifrado de extremo a extremo.
• La solución está diseñada para cumplir con PCI DSS en el manejo de PIN.

APIs requeridas

API	Entrada/Salida	Descripción
Obtener PIN	Emisor <- Thales D1	Recuperar el PIN del backend del emisor para mostrarlo en el móvil.

SDK

Android

PINDisplayTextView pinDisplayTextView = <Objeto de tipo PINDisplayTextView>;
CardPINUI ui = new CardPINUI(pinDisplayTextView);
String cardID = "<ID de la tarjeta>";

d1Task.displayPhysicalCardPIN(cardID, ui, new D1Task.Callback<Void>() {
    @Override
    public void onSuccess(Void data) {
        // Continúe con los flujos posteriores, el PIN ahora se está mostrando en la vista de texto proporcionada.
    }
    
    @Override
    public void onError(D1Exception exception) {
        // Consulte la sección Integración del SDK D1 – Gestión de errores
    }
});

iOS

let displayTextField = <Objeto de tipo D1PINDisplayTextField>
let cardPINUI = CardPINUI(pinTextField: displayTextField)
let cardID = <ID de la tarjeta>

d1Task.displayPhysicalCardPIN(cardID, cardPINUI: cardPINUI) { error in
    if let error = error {
        // Consulte la sección Integración del SDK D1 – Gestión de errores
    } else {
        // Continúe con los flujos posteriores, el PIN ahora se está mostrando en el campo de texto proporcionado.
    }
}En