4. Compatibilidad con el modo manual

Resumen

Complete este paso si planea admitir la modo manual experiencia de pago.

Si no admite el modo manual, vaya a Realizar verificación CDCVM.

Flujo secuencial

En esta experiencia de pago:

1. El usuario final desbloquea el dispositivo.
2. El usuario final abre su aplicación de billetera digital.
3. El usuario final selecciona la tarjeta para pagar.
4. La aplicación solicita al usuario final que se autentique.
5. El usuario final realiza un toque dentro del keyValidityPeriod.
6. La transacción se realiza con la tarjeta de pago seleccionada.
7. Después de que se complete el pago, o cuando el keyValidityPeriod expire, NFC Wallet SDK vuelve a la tarjeta de pago predeterminada para el siguiente pago.

Integración del SDK

Llamar a PaymentBusinessService.startAuthentication(...) para iniciar una transacción en modo manual.

Esta llamada activa el servicio de pago de NFC Wallet. NFC Wallet SDK maneja la transacción usando el flujo estándar de devolución de llamada de pago sin contacto.

Las siguientes devoluciones de llamada de ContactlessPaymentServiceListener se llamarán en este orden:

1. onTransactionStarted
2. onAuthenticationRequired
3. onReadyToTap
4. onTransactionCompleted

// 01 - Cambiar temporalmente la tarjeta predeterminada a la tarjeta seleccionada, si es necesario.
DigitalizedCard originalDefault = null;

// Obtener la tarjeta seleccionada por el usuario final.
DigitalizedCard selectedCard = getSelectedCard();

// Si la tarjeta seleccionada no es la tarjeta predeterminada, tome nota de la tarjeta predeterminada original,
// luego establezca la tarjeta seleccionada como predeterminada antes de continuar con el pago.
if (!isDefault(selectedCard)) {
    originalDefault = getDefaultCard();  // Guardar la tarjeta predeterminada original.
    setDefaultCard(selectedCard);        // Establecer la tarjeta seleccionada como la nueva predeterminada.
}

// 02 - Definir el listener para manejar los eventos del flujo de pago sin contacto.
private PaymentServiceListener paymentServiceListener = new ContactlessPaymentServiceListener() {
    @Override
    public void onAuthenticationRequired(PaymentService paymentService,
                                          CHVerificationMethod cvm, long cvmResetTimer) {
        // 04 - Iniciar la autenticación según el método CDCVM.
        startInputCvmActivity(cvm);
    }

    @Override
    public void onTransactionCompleted(TransactionContext ctx) {
        // 05a - Después de una transacción exitosa, volver a la tarjeta predeterminada original, si es necesario.
        setDefaultCard(originalDefault);
    }

    @Override
    public void onError(TransactionContext transactionContext,
                        PaymentServiceErrorCode errorCode, String msg) {
        // 05b - Después de una transacción fallida, volver a la tarjeta predeterminada original, si es necesario.
        setDefaultCard(originalDefault);
    }

    @Override
    public void onTransactionStarted() {
    }

    @Override
    public void onReadyToTap(PaymentService service) {
    }
};


// 03 - Iniciar la autenticación antes del pago.
final PaymentBusinessService paymentBusinessService = PaymentBusinessManager.getPaymentBusinessService();
paymentBusinessService.startAuthentication(paymentServiceListener, PaymentType.CONTACTLESS);