Registrar la billetera

Descripción general

Inscriba su aplicación de billetera digital después de SDK de NFC Wallet la inicialización y antes de comenzar Tokenización. La inscripción de la billetera dota a la aplicación de billetera digital con los activos de seguridad necesarios para invocar NFC Wallet servicios:

• Ejecute esto una vez por instancia de billetera.
• Ejecute esto solo si la aplicación de billetera digital usa NFC Wallet servicios.
• Ejecute esto solo en dispositivos que admiten pagos sin contacto. Consulte Comprueba la compatibilidad con pagos sin contacto.

Inscriba solo aplicaciones de billetera digital que usen NFC Wallet servicios.

Esto evita tráfico de red innecesario desde la aplicación de billetera digital y carga innecesaria en NFC Wallet producto.

Diagrama de secuencia

Flujo general para inscribir su aplicación de billetera.

Flujo de inscripción de la billetera.

Técnicamente, este flujo se llama la inscripción segura del monedero en NFC Wallet.

Integración del SDK

Requisitos previos

Antes de comenzar, verifique lo siguiente:

• Su aplicación de billetera digital está incorporada en el NFC Wallet backend.
• Ha inicializado el SDK de NFC Wallet.
• La billetera no está inscrita (WalletSecureEnrollmentService.isEnrolled() devuelve falso).
• Si admite pagos sin contacto, confirme que el dispositivo sea elegible. Consulte Comprueba la compatibilidad con pagos sin contacto.

Omita la comprobación de la capacidad sin contacto si su aplicación de billetera digital no admite pagos sin contacto (por ejemplo, solo código QR o pago remoto DSRP).

Realizar la inscripción de la billetera

La inscripción de la billetera es una acción única en el ciclo de vida de la aplicación de billetera digital.

Ejecútela después de la inicialización del SDK y solo si la billetera no está inscrita.

1. Cree una WalletSecureEnrollmentService instancia.
2. Compruebe wse.isEnrolled().
3. Si es necesario, llame a wse.enroll() para iniciar el proceso. Si la operación se realiza correctamente, la inscripción segura de la billetera se completa; de lo contrario, se lanzará un error.

Después de que la inscripción segura de la billetera se complete correctamente, continúe con Tokenizar una tarjeta.

func invokeWSEAsync() async {
   do {
        let wse = try WalletSecureEnrollmentService()
        // Comprueba el estado de inscripción de la billetera.
        if wse.isEnrolled() {
            // WSE está inscrita
        } else {
            // Inicia la inscripción segura de la billetera.
            try await wse.enroll()
            // Aquí se completa correctamente el proceso de inscripción.
        }
    } catch {
        // Error de WSE 
    }
}

Errores

Cuando la inscripción de la billetera falla, maneje estos tipos de error:

• clientError: Un error interno del SDK. Se proporciona un mensaje a la aplicación de billetera digital.
• serverError: Un error del backend. Se proporciona un mensaje, httpStatus, errorCode, y opcionalmente additionalInfo se proporcionan a la aplicación de billetera digital.
• networkError: El dispositivo no tiene conexión a Internet.

El WalletSecureEnrollmentService.eventStream y WalletSecureEnrollmentService.State Las API están obsoletas y se eliminarán en la próxima versión. Por lo tanto, debe migrar su código para usar WalletSecureEnrollmentService.enroll la API y para todas las nuevas implementaciones, como se muestra arriba

API obsoletas

El siguiente ejemplo demuestra el uso de WalletSecureEnrollmentService.State y WalletSecureEnrollmentService.eventStream API que están obsoletas.

Estos son los posibles eventos de WalletSecureEnrollment cuando la WalletSecureEnrollmentService.eventStream la API obsoleta se utiliza:

• .started: El proceso de inscripción segura de la billetera se ha iniciado.
• .completed : El proceso de inscripción segura de la billetera se ha completado.
• .errorEncountered: Se devuelve el error de inscripción segura de la billetera.

// API obsoleta
func invokeWSEAsync() async {
    do {
        let wse = try WalletSecureEnrollmentService()
        // comprueba el estado de inscripción de la billetera.
        if wse.isEnrolled() {
            // WSE está inscrita
        } else {
          // inicia la inscripción segura de la billetera.
            wse.enroll()
            for await state in wse.eventStream {
              switch state {
                case .started:
                  // se activa cuando WSE se inicia.
                case .completed:
                  // se activa cuando WSE se completa.
                case .errorEncountered(let error):
                  switch error {
                    case .clientError(let message):
                        // manejo de errores 
                    case .serverError(let message, let httpStatus, let errorCode, let additionalInfo):
                        // manejo de errores 
                    case .networkError:
                        // manejo de errores 
                    }
                }
            }
        }
    } catch {
        // error de inicialización de WSE 
    }
}