iOS

Use esta guía para integrar el SDK de Thales en una aplicación nativa de iOS para comerciantes.

Paquete de entrega

El paquete de entrega del SDK incluye:

Nombre	Descripción
Binarios	Variantes de lanzamiento y depuración del SDK de Thales.
Demostración	Proyecto de ejemplo que muestra cómo integrar y usar el SDK de Thales.
Apidoc	Documentación de la API del SDK de Thales.
Licencia	Licencias de frameworks de terceros incluidos con el SDK de Thales.

Integrar el SDK

1. Cree una carpeta llamada Framework.
2. Copie los .xcframework paquetes desde Binaries/<Release|Debug>/ dentro de la Framework carpeta.

Ejemplo Framework carpeta que contiene los .xcframework paquetes del SDK.

1. Arrastre TMGSDK.xcframework y SecureLogAPI.xcframework desde la Framework carpeta a Frameworks, Libraries, and Embedded Content en la configuración de su objetivo.

Incorpore los frameworks del SDK en el objetivo de su aplicación.

1. Agregue la descripción del uso de Face ID al Info.plist.

Agregue la descripción del uso de Face ID en Info.plist.

Configurar el SDK

Configure el SDK de Thales antes de llamar a cualquier API del SDK.

Construya un TMGClientConfiguration con los parámetros requeridos:

• URL del servidor
• Certificado del servidor
• Identificador de clave
• PINs del certificado

1. Cree un TMGClientConfiguration

Obtenga la URL del servidor, el certificado del servidor y el identificador de clave durante el registro.

let serverURL = ""
let serverCertificate = ""
let serverKeyID = ""
let configuration = TMGClientConfiguration(serverURL: serverURL,
                                           serverCertificate: Data(serverCertificate.utf8),
                                           serverKeyID: serverKeyID)

2. Cree un VisaCTFHelper

Cree el asistente para iniciar el vinculado del dispositivo y autenticar transacciones para Visa CTF y DAF.

do {
      let visaCTFHelper = try TMGClient.sharedInstance.createVisaCTFHelper(withConfiguration: configuration)
} catch let error {
  // Manejar el error
}

3. Cree un MastercardTAFHelper

Cree el asistente para iniciar el vinculado del dispositivo y autenticar transacciones para Mastercard TAF.

do {
      let mastercardTAFHelper = try TMGClient.sharedInstance.createMastercardTAFHelper(withConfiguration: configuration)
  } catch let error {
      // Manejar el error
  }

Si el SDK no puede crear el asistente, lanza un error.

Use cada variante del SDK solo para su entorno previsto. Cuando crea un VisaCTFHelper, el SDK devuelve deviceEnvironmentUnsafe en estos casos:

• Debug: Firma la aplicación con un certificado de distribución o ad-hoc.
• Release: Depura la aplicación, o la inicias desde Xcode o xcodebuild. Si encuentra este error, deje de depurar y vuelva a iniciar la aplicación en el dispositivo.