Reponer claves de pago

Descripción general

Se requieren claves de pago (SUK o LUK) para calcular criptogramas EMV para pagos sin contacto.

En un modelo de emulación de tarjeta en el host (HCE), las claves de pago son temporales. Repóngalas antes de que se agoten. Esto evita interrupciones en los pagos.

Esta guía cubre cuándo reponer y cómo activarlo.

El NFC Wallet SDK admite estos tipos de claves de pago:

• SUK (clave de un solo uso): Use una clave por transacción. Se usa para Mastercard y PURE (EMV de marca blanca).
• LUK (clave de uso limitado): Use una clave para varias transacciones. Se usa para Visa.

Requisitos previos

Configurar umbrales de reposición (incorporación)

Configure los umbrales de reposición durante la incorporación con el equipo de entrega de Thales.

Al definir los umbrales, tenga en cuenta:

• SUK: Cantidad restante de SUK que activa la reposición.
• LUK: Cantidad restante de transacciones y tiempo de vencimiento de la LUK.

Integración del SDK

Detectar cuándo se requiere reposición

Use una (o ambas) de estas señales:

• Comprobación proactiva: Lea el estado de la tarjeta digital.
• Empuje reactivo (activado por TSP): Procese MG:ReplenishmentNeededNotification del TSP.

Para la entrega y el enrutamiento de push, consulte Gestionar notificaciones push.

Comprobación proactiva

Ejecute esta comprobación para cada tarjeta digital. Ejecútela al iniciar la aplicación o después de un pago.

1. Obtener DigitalizedCardStatus de DigitalizedCard.
2. Llamar a DigitalizedCardStatus.needsReplenishment().

Consulte Mostrar tarjetas digitales.

Comprobar si una tarjeta digital necesita reposición

public static boolean needsReplenishment(final DigitalizedCard card) {
    AsyncResult<DigitalizedCardStatus> result =
            card.getCardState(null).waitToComplete();

    if (!result.isSuccessful()) {
        // TODO: manejar error
        return false;
    }

    DigitalizedCardStatus status = result.getResult();
    return status != null && status.needsReplenishment();
}

Realice esta comprobación proactiva:

• Al iniciar regularmente la aplicación

  • No realice la comprobación si la aplicación se inicia para un pago; consulte la advertencia a continuación
• Después de un pago

  • En el evento onNextTransactionReady - consulte implementar devoluciones de llamada de pago sin contacto.
• Cuando la tarjeta se establece como predeterminada.
• Después de que se restablezca la conectividad (sin conexión → en línea).

Ejecute esta comprobación al iniciar la aplicación, después de NFC Wallet SDK la inicialización.

No ejecute esta comprobación cuando el usuario final inicie la aplicación para realizar un pago sin contacto. Puede retrasar la ejecución del pago.

Activar la reposición

Llamar a ProvisioningBusinessService.sendRequestForReplenishment(...) para solicitar nuevas claves de pago.

1. Obtenga el identificador de la tarjeta.

   Use el ID de la tarjeta tokenizada - consulte Mostrar tarjeta digital.
2. Envíe la solicitud de reposición.

   Llamar a sendRequestForReplenishment(...) e implemente PushServiceListener:

   • onComplete: La solicitud es aceptada.
   • onError: El SDK no puede enviar la solicitud. Inspeccione ProvisioningServiceError.

   Enviar una solicitud de reposición

   public void replenish(final String tokenizedCardId, final boolean forced) {
       ProvisioningBusinessService service =
               ProvisioningServiceManager.getProvisioningBusinessService();
   
       service.sendRequestForReplenishment(
               tokenizedCardId,
               new ReplenishmentListener(),
               forced
       );
   }
   
   private static class ReplenishmentListener implements PushServiceListener {
       @Override
       public void onComplete() {
           // TODO: registrar éxito
       }
   
       @Override
       public void onError(final ProvisioningServiceError error) {
           // TODO: registrar error
       }
   
       @Override
       public void onUnsupportedPushContent(final Bundle bundle) {
           // No se usa para esta llamada.
       }
   
       @Override
       public void onServerMessage(final String tokenizedCardId,
                                   final ProvisioningServiceMessage message) {
           // No se usa para esta llamada.
       }
   }

3. Procese el push de reposición.

   Después de enviar la solicitud, el backend de NFC Wallet envía una notificación push. Su aplicación de billetera digital debe procesarla. Luego, el SDK recupera las nuevas claves de pago.

Evite terminar la aplicación de billetera digital mientras la reposición está en curso.

Reposición activada por TSP

Cuando reciba MG:ReplenishmentNeededNotification, active la reposición con forced = true.

Consulte Procesar notificaciones MG (reposición).