Cambiar un PIN

Para limitar la exposición del PIN en una tarjeta física, la aplicación emisora delega la tarea de cambiar el PIN al SDK D1.

Estos son los formatos de PIN (desde el backend del emisor) que se admiten actualmente:

PIN ISO0
PIN 3DES Seccos

Experiencia de Usuario

Flujo

El usuario se autentica en la app bancaria y solicita cambiar el PIN
Se realiza una llamada interna al SDK
Capturar el PIN de forma segura
API BackEnd D1
D1 transcifra el PIN de la clave del dispositivo a la clave del emisor
Establecer el PIN en el backend del emisor

Diagrama de Secuencia

Pre-requisitos

Consumidor, cuenta y tarjeta ya registrados en D1
El SDK está correctamente inicializado
La App Emisora llamó a la API de inicio de sesión del SDK D1.

APIs requeridas

API

Entrante/Saliente

Descripción

Obtener token de autorización

Emisor <- Thales D1

Obtener un token de acceso OAuth 2.0 para llamar al backend del Emisor.

Establecer PIN

Emisor <- Thales D1

Establecer el PIN desde la app móvil al backend del Emisor.

APIs condicionales

API

Entrante/Saliente

Descripción

API Obtener Contador de Cambio de PIN

Emisor <- Thales D1

En caso de PIN Seccos. Se usa para recuperar el Contador de Cambio de PIN necesario para el Cálculo del PIN

SDK

Nota
Para mayor seguridad, la API de Cambio de PIN tiene un período de tiempo de último inicio de sesión predeterminado más estricto que las otras APIs. Para asegurar un cambio de PIN exitoso, debe gestionar el flujo de inicio de sesión/reinicio de sesión para completar el inicio de sesión dentro del tiempo asignado antes de enviar el cambio de PIN.

@Nullable
@Override
public View onCreateView(
        @NonNull LayoutInflater inflater,
        @Nullable ViewGroup container,
        @Nullable Bundle savedInstanceState
) {
    View view = inflater.inflate(R.layout.fragment_main, container, false);

    SecureEditText entryEditPin = (SecureEditText)view.findViewById(R.id.pin_entry);
    SecureEditText confirmEditPin = (SecureEditText)view.findViewById(R.id.pin_confirm);
    PINEntryUI.PINEventListener listener = new PINEntryUI.PINEventListener() {
        @Override
        public void onPinEvent(PINEntryUI.PINEvent pinEvent, String additionalInfo) {
            switch (pinEvent){
                case FIRST_ENTRY_FINISH:
                    // cambiar el foco a confirmEditPin
                    break;
                case PIN_MATCH:
                    // habilitar el botón Continuar/Enviar
                    break;
                case PIN_MISMATCH:
                    // deshabilitar el botón Continuar/Enviar y mostrar el error de PIN_MISMATCH
                    break;
            }
        }
    };

    String cardID = ""; // obtenido p. ej. desde el servidor
    ChangePINOptions options = new ChangePINOptions(4);
    pinEntryUI = d1Task.changePIN(cardID, entryEditPin, confirmEditPin, options, listener);

    Button button = (Button)view.findViewById(R.id.pin_submit);
    button.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            pinEntryUI.submit(new D1Task.Callback<Void>() {
                @Override
                public void onSuccess(final Void data) {
                }

                @Override
                public void onError(@NonNull final D1Exception exception) {
                }
            });
        }
    });
    
    return view;
}

class ViewController: UIViewController {
    var pinEntryUI: PINEntryUI? = nil
    override func viewDidLoad() {
        let entryEditPin = D1SecureTextField()
        let confirmEditPin = D1SecureTextField()
        let cardID = "" // obtenido p. ej. desde el servidor
        let options = ChangePINOptions(pinLength: 4)
        pinEntryUI = d1Task.changePIN(cardID, textFieldNew: entryEditPin, textFieldConfirm: confirmEditPin, options: options, delegate: self)
    }

    func onButtonClick() {
        pinEntryUI?.submit { error in 
        }
    }
}

extension ViewController: PINEntryUIDelegate {
    func pinEntryUI(_ pinEntryUI: PINEntryUI, pinEvent: PINEntryUI.PINEvent, additionalInfo: String) {
        switch pinEvent {
            case .firstEntryFinish: 
                // cambiar el foco a confirmEditPin
                break
            case .pinMismatch:
                // habilitar el botón Continuar/Enviar
                break
            case .pinMatch:
                // deshabilitar el botón Continuar/Enviar y mostrar el error de PIN_MISMATCH
                break
        }
    }
}

AnteriorMostrar un PIN SiguienteImplementar la activación de tarjetas

Última actualización hace 3 meses

¿Te fue útil?

@Nullable
@Override
public View onCreateView(
        @NonNull LayoutInflater inflater,
        @Nullable ViewGroup container,
        @Nullable Bundle savedInstanceState
) {
    View view = inflater.inflate(R.layout.fragment_main, container, false);

    SecureEditText entryEditPin = (SecureEditText)view.findViewById(R.id.pin_entry);
    SecureEditText confirmEditPin = (SecureEditText)view.findViewById(R.id.pin_confirm);
    PINEntryUI.PINEventListener listener = new PINEntryUI.PINEventListener() {
        @Override
        public void onPinEvent(PINEntryUI.PINEvent pinEvent, String additionalInfo) {
            switch (pinEvent){
                case FIRST_ENTRY_FINISH:
                    // cambiar el foco a confirmEditPin
                    break;
                case PIN_MATCH:
                    // habilitar el botón Continuar/Enviar
                    break;
                case PIN_MISMATCH:
                    // deshabilitar el botón Continuar/Enviar y mostrar el error de PIN_MISMATCH
                    break;
            }
        }
    };

    String cardID = ""; // obtenido p. ej. desde el servidor
    ChangePINOptions options = new ChangePINOptions(4);
    pinEntryUI = d1Task.changePIN(cardID, entryEditPin, confirmEditPin, options, listener);

    Button button = (Button)view.findViewById(R.id.pin_submit);
    button.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View view) {
            pinEntryUI.submit(new D1Task.Callback<Void>() {
                @Override
                public void onSuccess(final Void data) {
                }

                @Override
                public void onError(@NonNull final D1Exception exception) {
                }
            });
        }
    });
    
    return view;
}

class ViewController: UIViewController {
    var pinEntryUI: PINEntryUI? = nil
    override func viewDidLoad() {
        let entryEditPin = D1SecureTextField()
        let confirmEditPin = D1SecureTextField()
        let cardID = "" // obtenido p. ej. desde el servidor
        let options = ChangePINOptions(pinLength: 4)
        pinEntryUI = d1Task.changePIN(cardID, textFieldNew: entryEditPin, textFieldConfirm: confirmEditPin, options: options, delegate: self)
    }

    func onButtonClick() {
        pinEntryUI?.submit { error in 
        }
    }
}

extension ViewController: PINEntryUIDelegate {
    func pinEntryUI(_ pinEntryUI: PINEntryUI, pinEvent: PINEntryUI.PINEvent, additionalInfo: String) {
        switch pinEvent {
            case .firstEntryFinish: 
                // cambiar el foco a confirmEditPin
                break
            case .pinMismatch:
                // habilitar el botón Continuar/Enviar
                break
            case .pinMatch:
                // deshabilitar el botón Continuar/Enviar y mostrar el error de PIN_MISMATCH
                break
        }
    }
}