iOS

El SDK de Push Provisioning admite iOS para el aprovisionamiento por push de Apple Pay.

Requisitos previos

• iOS 13.0+
• Xcode 14.0+
• Swift 5.0+

• Para disfrutar de todas las funciones de Apple Pay, ejecútelo en dispositivos físicos.
• Realice las pruebas de producción en el entorno de producción en dispositivos de producción, usando perfiles de aprovisionamiento Ad Hoc, TestFlight o la App Store. Realice las pruebas de preproducción desde Xcode.

Acceso a Push Provisioning

El aprovisionamiento por push de Apple Pay requiere una habilitación especial de Apple llamada com.apple.developer.payment-pass-provisioning. Solicítela enviando un correo electrónico a [e-mail].

En su correo electrónico, incluya la siguiente información:

• El nombre de su app.
• El ID de su equipo de desarrollador, disponible en Apple Developer Membership.
• El ADAM ID (el ID numérico único de su app), que se encuentra en App Store Connect o en la App Store vinculada a su app, por ejemplo, https://apps.apple.com/app/id123456789.

Una vez que Apple conceda la habilitación, añada la habilitación de distribución a un perfil de aprovisionamiento. Use el mismo perfil para desarrollar la app en Xcode.

En su proyecto, abra o cree el archivo de habilitaciones. Añada la com.apple.developer.payment-pass-provisioning clave con un valor booleano YES.

Luego, en el destino de su app, vaya a Build Settings > Signing > Code Signing Entitlements. Asegúrese de que apunte al archivo de habilitaciones.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>com.apple.developer.payment-pass-provisioning</key>
    <true/>
  </dict>
</plist>

Además, añada la In-App Provisioning capacidad en la configuración de la app:

Añada la capacidad In-App Provisioning.

Para más detalles sobre cómo configurar Apple Pay, consulte Configuración de Apple Pay.

Integración del SDK de Push Provisioning

1. Descargue la última versión del SDK de Push Provisioning y extraiga el archivo ZIP.
2. Vaya a la carpeta del proyecto de Xcode y cree una nueva carpeta "TPCSDK".
3. Coloque el archivo extraído TPCSDKSwift.xcframework en la carpeta.
4. En el destino de la app, seleccione General > Frameworks, Libraries, and Embedded Content, haga clic en + > Add Other > haga clic en Add Files.
5. Seleccione el TPCSDKSwift.xcframework y haga clic en Open.

Añada el XCFramework al destino de su app.

Asegúrese de que Embed & Sign esté seleccionado como sigue:

Establezca el framework en Embed & Sign.

Si usa un proyecto Objective-C, establezca Framework Search Paths y Header Search Paths.

Establezca Framework Search Paths.

Establezca Header Search Paths.

Swift

Configuración

Agregue la siguiente configuración a su aplicación para usar el SDK de Push Provisioning.

Importe el TPCSDKSwift módulo en su AppDelegate.swift:

import TPCSDKSwift

Objective-C

Configuración

Importe un encabezado en el proyecto

1. Cree un archivo Bridging-Header.h creando un archivo Swift.
2. Importe el archivo de encabezado TPCSDKSwift en Bridging-Header.h.

Añada el código de configuración a su aplicación

Importe el módulo TPCSDKSwift en su AppDelegate:

#import <TPCSDKSwift-Swift.h>

Para habilitar la compatibilidad con frameworks de Swift, asegúrese de que existan las siguientes definiciones del proyecto:

SWIFT_OBJC_BRIDGING_HEADER=Project/Project-Bridging-Header.h

SWIFT_VERSION=5.0

ALWAYS_EMBED_SWIFT_STANDARD_LIBRARIES=YES

Nota

Debido a un error en Xcode, debe crear al menos un archivo Swift (puede estar vacío) en el proyecto. Inclúyalo en Build Phases > Compile Sources.

Configure el SDK de Push Provisioning en su application:didFinishLaunchingWithOptions: función delegada.

Swift

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // Punto de anulación para personalización después del lanzamiento de la aplicación.
 
    let tpcIssuerId = "TPC_ISSUER"
    do {
      try TPCSDK.configure(variant: .PPROD,
                          issuerId: tpcIssuerId)
      // Apple Pay y el aprovisionamiento son compatibles
    } catch {
      // Gestionar TPCError
    } 
    
    return true
  }

Objective-C

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  // Punto de anulación para personalización después del lanzamiento de la aplicación.
  NSError *error = nil;
  [TPCSDK configureWithVariant:SdkVariantPROD issuerId:@"TPC_ISSUER" error:&error];
  if (error) {
      NSLog(@"Gestionar TPCError");
  }
  
  return YES;
}

Nota

Todas las operaciones de PKPassLibrary (isCardDigitized, getCardDigitizationResult, activatePass, ...) no son seguras para subprocesos. Ejecútelas en un único subproceso. https://developer.apple.com/documentation/passkit/pkpasslibrary