3. Inicialización

Inicialización del SDK de NFC Wallet

Nota

El SDK de NFC Wallet no admite iCloud ni la restauración desde copia de seguridad del dispositivo.

La aplicación de cartera digital (wallet) debe inicializar el SDK antes de que se puedan usar las funciones del SDK de NFC Wallet.

Puede usar TSHPay.configure la API para inicializar el SDK. La wallet debe proporcionar dos parámetros:

• Método de verificación del titular de la tarjeta (CVM)

• Archivo de configuración PLIST

La inicialización del SDK debe realizarse cada vez que se inicia la aplicación.

Método de verificación del titular de la tarjeta

La wallet debe proporcionar el método de autenticación durante la inicialización del SDK. Se selecciona uno de los siguientes métodos de autenticación:

• .userPresence : Un método de autenticación que usa biometría (TouchID/FaceID) con retroceso al código de acceso del dispositivo, o usar el código de acceso del dispositivo en casos en que la biometría se elimine después del proceso de digitalización de la tarjeta. MPA puede cambiar el método de autenticación a biometría o al código de acceso del dispositivo durante el paso de verificación de pago.

• biometricOnly :Un método de autenticación que usa solo TouchID/FaceID.

Para más detalles sobre el método de verificación del titular de la tarjeta, consulte la documentación de la API.

Configurar archivo PLIST

Debe crearse un archivo PLIST y almacenarse en el bundle principal de la aplicación móvil.

TSHPay.plist

Descripción de los parámetros de TSHPay.plist

CLAVE	COMENTARIO
REALM	[String] Un parámetro fijo. Por ejemplo, "CBP".
OAUTH_CONSUMER_KEY	[String] Clave de consumidor que debe ser proporcionada por Thales.
GATEWAY_URL	[String] La URL de las Rages que debe ser proporcionada por Thales.
CSR_DOMAIN	[String] Se usa para la solicitud de firma de certificado en el componente que asegura las llamadas HTTPS. Consulte con su integrador de Thales para el valor que se debe establecer.
CSR_EMAIL	[String] Correo electrónico de la empresa.
CPS_URL	[String] La URL del servidor CPS que debe ser proporcionada por su integrador de Thales.
MG_CONNECTION_URL	[String] La URL del servidor MG que debe ser proporcionada por Thales.
MG_WALLET_PROVIDER_ID	[String] El ID del proveedor de la wallet.
MG_WALLET_APPLICATION_ID	[String] El ID de la aplicación del proveedor de la wallet, que es un dato opcional proporcionado por el cliente. Esto es necesario cuando el proveedor de la wallet admite varias aplicaciones de wallet.
TRANSACTION_HISTORY_CONNECTION_URL	[String] La URL para recuperar el historial de transacciones que debe ser proporcionada por Thales.
SECURE_LOG_LEVEL	[Number] Define el nivel de registros que se escribirán, donde off = 0, fatal = 1, error = 2, warn = 3, info = 4, y debug = 5.
DOMESTIC_CURRENCY_CODE	[Number] La configuración del código de moneda nacional se proporciona según el formato numérico estándar ISO-4217. Omita los ceros iniciales en el número del código de moneda. Si no se configura, el valor predeterminado es 978 (euro).
VISA_ONLINEPIN_PRIORITY	[Boolean] Configure la prioridad del PIN en línea de Visa. Si no se configura, el SDK procesará la transacción Visa con prioridad CDCVM. Para más información, consulte Configurar la prioridad de CVM de Visa.

Puede definir un nombre personalizado para el archivo de configuración PLIST, por ejemplo: "YourPlistName.plist". El nombre personalizado puede proporcionarse durante la inicialización del SDK.

De forma predeterminada, NFC Wallet SDK buscará TSHPay.plist en el bundle principal de la aplicación si la aplicación móvil no proporciona ninguno.

Los siguientes ejemplos muestran cómo inicializar el SDK usando el TSHPay.plist predeterminado

Task {
    do {
        try await TSHPay.shared.configure(withVerificationMethod: .userPresence)
    } catch let error as TSHPaySDK.TSHPay.Error {
        switch error {
        case .storageUnrecoverableError:
            do {
                try await TSHPay.shared.reset()
                try await TSHPay.shared.configure(withVerificationMethod: .userPresence)
            } catch {
                // Manejar el error.
            }
            
        default: break
            // Manejar otros errores.
        }
    }
}

Comprobar la elegibilidad del dispositivo

Después de la inicialización del SDK, verifique la elegibilidad del dispositivo para comprobar:

• Método de autenticación del propietario del dispositivo usando deviceEligibility.

• Capacidad de pago sin contacto usando contactlessPaymentEligibility.

Si el dispositivo cumple los requisitos, el SDK devuelve supported.

func checkDeviceEligibility() {
    Task {
        let eligibility = await TSHPay.shared.deviceEligibility
        switch eligibility.deviceOwnerAuthentication {
        case .supported:
            // El dispositivo es elegible. Puede iniciar la tokenización.
        case .passcodeNotSet:
            // Pida al usuario final que establezca un código de acceso del dispositivo.
        case .biometricNotSet:
            // Pida al usuario final que registre la biometría (Touch ID / Face ID).
        }
    }
}

Recuperar el ID de la wallet

Use TSHPay.walletID para recuperar el identificador de la wallet.

El SDK genera el ID de la wallet la primera vez que llama a TSHPay.configure.

El ID de la wallet permanece estable entre reinicios de la aplicación.

Si restablece el SDK, el ID de la wallet se vuelve a generar.

Utilice el ID de la wallet para la resolución de problemas y el soporte.

let walletIdentifier = TSHPay.walletID
print("Retrieved wallet ID: \(walletIdentifier)")