Digitalizar una tarjeta

Resumen

Después de que la tarjeta pase las comprobaciones de elegibilidad y el usuario final acepte los términos y condiciones (T&C) cuando sea necesario, inicie la digitalización.

Durante la digitalización:

• El backend del emisor devuelve la Tokenización decisión (flujo verde, flujo amarillo o flujo rojo) a la aplicación de billetera digital a través de NFC Wallet.
• Si el backend del emisor aprueba (flujo verde o flujo amarillo):

  • El Proveedor de Servicio de Tokens (TSP) crea la tarjeta digital y sus activos (perfil y claves de pago).
  • NFC Wallet aprovisiona de forma segura el perfil de la tarjeta digital y las claves de pago en la aplicación de billetera digital.

En el flujo amarillo, la aplicación de billetera digital realiza ID&V (autenticación reforzada) antes de que la tarjeta pueda ser aprovisionada.

En el flujo rojo, la digitalización se rechaza y el SDK devuelve una devolución de llamada de error.

Implemente el flujo verde, el flujo amarillo o ambos, según su programa.

Según su programa, T&C puede no ser necesario. Si es así, la aplicación de billetera digital puede aceptar los T&C sin interacción del usuario final.

Integración del SDK

Inicio digitalización de la tarjeta llamando a MGCardEnrollmentService.digitizeCard(...).

Primero deberá implementar MGDigitizationListener para hacer seguimiento del progreso de la digitalización gestionando las devoluciones de llamada según el flujo de color de inscripción:

• En el Flujo verde (aprobado, sin autenticación reforzada) el SDK llama a estas devoluciones de llamada:

  • onCPSActivationCodeAcquired
  • onComplete

  Para más detalles, consulte Digitalización del flujo verde.
• En el flujo amarillo (aprobado con autenticación reforzada) el SDK también llama a:

  • onSelectIDVMethod
  • onActivationRequired

  Para más detalles, consulte Digitalización del flujo amarillo.

En caso de error de digitalización, NFC Wallet SDK emite la devolución de llamada:

• onError: La digitalización ha fallado. Use error.getCode() para decidir si reintentar, pedir al usuario final que actúe o derivar al soporte.

MGDigitizationListener ejemplo de implementación

Consulte el siguiente fragmento de código para implementar MGDigitizationListener

// construya su escuchador de digitalización
public class MyDigitizationListener implements MGDigitizationListener {

    @Override
    public void onCPSActivationCodeAcquired(String digitalCardId, byte[] activationCode) {
        // Reciba activationCode para iniciar el aprovisionamiento de este digitalCardId.
        // Consulte "Trigger a provisioning session".
    }

    @Override
    public void onSelectIDVMethod(IDVMethodSelector idvMethodSelector) {
        // Solo flujo amarillo: reciba la lista de métodos ID&V
        // Consulte "Yellow flow digization"
    }

    @Override
    public void onActivationRequired(PendingCardActivation pendingCardActivation) {
        // Solo flujo amarillo: método ID&V seleccionado que requiere activación
        // Consulte "Yellow flow digization"
   }

    @Override
    public void onComplete(String digitalCardId) {
        // La digitalización se completó correctamente.
    }

    @Override
    public void onError(String digitalCardId, MobileGatewayError error) {
        // La digitalización falló.
        // Analice error.getCode() y aplique la lógica correcta de reintento / recuperación.
    }
});

Ejemplo de digitalización de tarjeta

En el siguiente ejemplo puede encontrar el código para iniciar la digitalización.

• En caso de flujo verde, debe proporcionar un token de autenticación.

// referencia a su listener de digitalización de tarjetas
// - para hacer seguimiento del progreso de la digitalización mediante callback
MyDigitizationListener digitizationListener = new MyDigitizationListener();

// Obtenga el servicio de inscripción.
MGCardEnrollmentService enrollmentService =
        MobileGatewayManager.INSTANCE.getCardEnrollmentService();

// A partir de la elegibilidad: recupere TermsAndConditions.
// Consulte "Check card eligibility".
TermsAndConditionSession tncSession = termsAndConditions.accept();

// Proporcione la autenticación en caso de flujo verde
byte[] authenticationToken = null;

enrollmentService.digitizeCard(tncSession, authenticationToken, digitizationListener);