Push Provisioning

Paso 1: Mostrar el Agregar a Wallet botón

Cuando el usuario final inicia por primera vez la aplicación del emisor, debe determinar si mostrar u ocultar el Agregar a Apple Wallet botón para una tarjeta específica.

Lo antes posible, determine si el usuario final tiene un iPhone o un iPhone emparejado con un Apple Watch.

Luego combine este estado de emparejamiento con el getToken resultado de la API para decidir si mostrar u ocultar el Agregar a Apple Wallet botón.

Swift

importar WatchConnectivity

class ViewController: UIViewController, TPCSDKProvisionDelegate, WCSessionDelegate {    
    // Para almacenar el valor isWatchPaired antes de llamar a la función TPC
    var isWatchPaired = false

    override func viewDidLoad() {
        super.viewDidLoad()
        // Realizar cualquier configuración adicional después de cargar la vista.
        if WCSession.isSupported() {
            let session = WCSession.default
            session.delegate = self
            session.activate()
        }
    }
    
    // MARK: WCSessionDelegate
    func session(_ session: WCSession, activationDidCompleteWith activationState: WCSessionActivationState, error: Error?) {
        if error != nil {
            //manejar error
        } else if activationState == .activated && session.isPaired {
            isWatchPaired = true
        }
    }
    
    func sessionDidBecomeInactive(_ session: WCSession) {
        // manejar sessionDidBecomeInactive
        isWatchPaired = false
    }
    
    func sessionDidDeactivate(_ session: WCSession) {
        // manejar sessionDidDeactivate
        isWatchPaired = false
    }
}

Objective-C

Luego llame a la getToken API para actualizar el resultado.

Nota

Consulte las PKAddPassButton directrices para usar el Agregar a Apple Wallet botón en su aplicación del emisor.

Lo siguiente se aplica a iOS SDK 2.0.0 y versiones anteriores.

Swift

func getCardDigitizationResultWithFundingCardWithSchemeAndPayload() {
    let scheme = CardScheme.Mastercard
    let payload = "PAN cifrado PKCS7"
    
    let card = FundingCard(scheme: scheme,
                            encryptedPayload: payload)
    
    TPCSDK.getCardDigitizationResult(card: card) { [weak self]
        (primaryAccountIdentifier, sdkResult, error) in
        self?.updateUI(for: sdkResult, sdkError: error)
    }
  }

  func getCardDigitizationResultWithPrimaryAccountIdentifier() {
    let primaryAccountIdentifier = "primaryAccountIdentifier"

    TPCSDK.getCardDigitizationResult(primaryAccountIdentifier: primaryAccountIdentifier) { [weak self]
        (primaryAccountIdentifier, sdkResult, error) in
        self?.updateUI(for: sdkResult, sdkError: error)
    }
  }

  func getCardDigitizationResultWithPrimaryAccountNumberSuffix() {
      let scheme = "SCHEME" // VISA, MASTERCARD, AMEX, DISCOVER
      let encryptedPayload = "PAN cifrado PKCS7"
      let primaryAccountNumberSuffix = "Últimos 4 dígitos del PAN"

      let card = FundingCard(schemeString: scheme,
              encryptedPayload: encryptedPayload)

      TPCSDK.getCardDigitizationResult(card: card, primaryAccountNumberSuffix: primaryAccountNumberSuffix) { [weak self]
          (primaryAccountIdentifier, sdkResult, error) in
          self?.updateUI(for: sdkResult, sdkError: error)
      }
  }

func updateUI(for sdkResult: CardDigitizationResult?, sdkError: Error?) {
    if let error = sdkError {
      // manejar error
    } else if let sdkResult = sdkResult {
      if sdkResult.localPKPass?.secureElementPass?.passActivationState == .requiresActivation {
        // Consulte la gestión del ciclo de vida del token para la acción Activar. 
        // Hay una activación de tarjeta pendiente en el iPhone.
      } else if sdkResult.remotePKPass?.secureElementPass?.passActivationState == .requiresActivation {
        // Consulte la gestión del ciclo de vida del token para la acción Activar. 
        // Hay una activación de tarjeta pendiente en el Apple Watch.
      } else if sdkResult.localPKPass != nil && sdkResult.remotePKPass == nil {
        if isWatchPaired {
          // mostrar el botón "Agregar a Apple Wallet" para Apple Watch.
        } else {
          // Ocultar el botón "Agregar a Apple Wallet".
        }
      } else if sdkResult.localPKPass == nil {
        // mostrar el botón "Agregar a Apple Wallet".
      } else if sdkResult.localPKPass != nil && sdkResult.remotePKPass != nil {
        // la tarjeta ya está provisionada. Ocultar el botón "Agregar a Apple Wallet".
      }
    }
  }

Objective-C

Lo siguiente se aplica a iOS SDK 2.1.0 y posteriores.

Swift

func getTokenWithInputByLast4() {
    // Últimos cuatro dígitos de la tarjeta física (FPAN).
    let last4 = "1234" 
    let tokenInput = GetTokenInput(last4: last4)
    TPCSDK.getToken(input: tokenInput) { [weak self]
        (localPass, remotePass, error) in
        self?.updateUI(for: localPass, remotePass: remotePass, sdkError: error)
    }
}

// - Desde: 2.3.0
func getTokenWithInputBySerialNumber() {
    // Número de serie proporcionado por Apple Pay.
    let serialNumber = "Número de serie"
    let tokenInput = GetTokenInput(serialNumber: serialNumber)
    TPCSDK.getToken(input: tokenInput) { [weak self]
        (localPass, remotePass, error) in
        self?.updateUI(for: localPass, remotePass: remotePass, sdkError: error)
    }
}

func updateUI(for localPass: PKPass?, remotePass: PKPass?, sdkError: Error?) {
    if let error = sdkError {
        // Maneja el error.
    } else {
        if localPass?.secureElementPass?.passActivationState == .requiresActivation {
            // Consulte la gestión del ciclo de vida del token para la acción Activar. 
            // Hay una activación de tarjeta pendiente en el iPhone.
        } else if remotePass?.secureElementPass?.passActivationState == .requiresActivation {
            // Consulte la gestión del ciclo de vida del token para la acción Activar. 
            // Hay una activación de tarjeta pendiente en el Apple Watch.
        } else if localPass != nil && remotePass == nil {
            if isWatchPaired {
                // Muestra el botón "Agregar a Apple Wallet" para Apple Watch.
            } else {
                // Oculta el botón "Agregar a Apple Wallet".
            }
        } else if localPass == nil {
            // Muestra el botón "Agregar a Apple Wallet".
        } else if localPass != nil && remotePass != nil {
            // La tarjeta ya está provisionada. Ocultar el botón "Agregar a Apple Wallet".
        }
    }
}

Objective-C

Precaución

• Si la tarjeta aún aparece como "NOT_DIGITIZED" después de la provisión, verifique que la aplicación del emisor esté configurada correctamente en el portal TSP.

• El TPCSDK.isCardDigitized API está en desuso y no se recomienda. Use la getToken API en su lugar. El isCardDigitized API no indica si la tarjeta está pendiente de activación o si está en un iPhone o en un Apple Watch.

Paso 2: Provisionar una tarjeta

El delegado de provisión devuelve un PKPass después de que la provisión se complete. Úselo para verificar el estado de digitalización de la tarjeta. Si el delegado devuelve nil, el SDK también devuelve un error.

Antes de usar la clase PKPass, asegúrese de agregar PassKit.framework a su proyecto.

Advertencia

Debe agregar el derecho de Push Provisioning a la aplicación del emisor antes de llamar a esta API. De lo contrario, la API devolverá un error. Para obtener el derecho, siga las directrices de acceso a Push Provisioning.

Use la getToken API para obtener localPKPass o remotePKPass. Si cualquiera de los localPKPass o remotePKPass no es nil, acceda a la primaryAccountIdentifier propiedad del PKSecureElementPass objeto. Pase el primaryAccountIdentifier recuperado a la provision

API.

Swift

Provisión con valores de enumeración de esquema estándar para Visa, Mastercard, Amex y Discover
    func onProvisionCompletion(pass: PKPaymentPass?, error: Error?) {
      if let error = error {
          if let tpcError = error as? TPCError {
      } else {
          // manejar TPCError
          let provisionError = error as NSError
              if provisionError.domain == PKPassKitErrorDomain  {
              // error de Apple
              // https://developer.apple.com/documentation/passkit/pkaddpaymentpasserror
                  switch provisionError.code {
                      case PKAddPaymentPassError.unsupported.rawValue:
                  print("La aplicación no puede agregar tarjetas a Apple Pay.")
                      case PKAddPaymentPassError.userCancelled.rawValue:
                  print("El usuario canceló la solicitud para agregar una tarjeta a Apple Pay.")
                      case PKAddPaymentPassError.systemCancelled.rawValue:
                  print("El sistema canceló la solicitud para agregar una tarjeta a Apple Pay.")
                      default:
              }
          }
      }
    break
        } else if let pass = pass {
    }
  }
  
  // manejar resultado exitoso con el objeto pass
    func provision() {
    let suffix = "1234"
    let scheme = CardScheme.Mastercard
    let payload = "PAN cifrado PKCS7"
    let cardholderName = "John Doe"
    
    let code = "code"
                     TPCSDK.provision(fromController: self,
                     primaryAccountSuffix: suffix,
                     cardholderName: cardholderName,
                     scheme: scheme,
                     encryptedPayload: payload,
                     authorizationCode: code,
  }

Objective-C

provisionDelegate:self];

Swift

Provisión con valores de enumeración de esquema estándar para Visa, Mastercard, Amex y Discover
    func onProvisionCompletion(pass: PKPaymentPass?, error: Error?) {
      if let error = error {
          if let tpcError = error as? TPCError {
      } else {
          // manejar TPCError
          let provisionError = error as NSError
              if provisionError.domain == PKPassKitErrorDomain  {
              // error de Apple
              // https://developer.apple.com/documentation/passkit/pkaddpaymentpasserror
                  switch provisionError.code {
                      case PKAddPaymentPassError.unsupported.rawValue:
                  print("La aplicación no puede agregar tarjetas a Apple Pay.")
                      case PKAddPaymentPassError.userCancelled.rawValue:
                  print("El usuario canceló la solicitud para agregar una tarjeta a Apple Pay.")
                      case PKAddPaymentPassError.systemCancelled.rawValue:
                  print("El sistema canceló la solicitud para agregar una tarjeta a Apple Pay.")
                      default:
              }
          }
      }
    break
        } else if let pass = pass {
    }
  }
  
  // manejar resultado exitoso con el objeto pass
    func provision() {
    let suffix = "1234"
    let scheme = "SCHEME" // VISA, MASTERCARD, AMEX, DISCOVER
    let payload = "PAN cifrado PKCS7"
    let cardholderName = "John Doe"
    Provisión con una cadena de esquema (estándar)
    let primaryAccountIdentifier = "primaryAccountIdentifier"
    
    let code = "code"
                     TPCSDK.provision(fromController: self,
                     primaryAccountSuffix: suffix,
                     let productId = "productId" // Aplicable solo para esquemas nacionales. Esto puede obtenerse del Sistema de Gestión de Tarjetas del banco.
                     scheme: scheme,
                     encryptedPayload: payload,
                     schemeString: scheme,
                     productId: productId,
                     authorizationCode: code,
  }

Objective-C