プッシュプロビジョニング

ステップ1: 次を表示する ウォレットに追加 ボタン

エンドユーザーが最初にイシュアアプリケーションを起動したとき、特定のカードに対して次を表示するか非表示にするかを判断する必要があります。 Apple Walletに追加 特定のカードのボタン。

できるだけ早く、エンドユーザーがiPhoneを持っているか、Apple WatchとペアリングされたiPhoneを持っているかを判定します。

次に、このペアリング状態をPush Provisioning SDKと組み合わせて getToken APIの結果を使用して、次を表示するか非表示にするかを決定します。 Apple Walletに追加 ボタン。

Swift

import WatchConnectivity

class ViewController: UIViewController, TPCSDKProvisionDelegate, WCSessionDelegate {    
    // TPC関数を呼び出す前に isWatchPaired 値を保存するため
    var isWatchPaired = false

    override func viewDidLoad() {
        super.viewDidLoad()
        // ビューの読み込み後に追加のセットアップを行います。
        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 {
            // エラーを処理する
        } else if activationState == .activated && session.isPaired {
            isWatchPaired = true
        }
    }
    
    func sessionDidBecomeInactive(_ session: WCSession) {
        // sessionDidBecomeInactive を処理する
        isWatchPaired = false
    }
    
    func sessionDidDeactivate(_ session: WCSession) {
        // sessionDidDeactivate を処理する
        isWatchPaired = false
    }
}

Objective-C

次に、 getToken APIを呼び出して結果を更新します。

注意

次を参照してください PKAddPassButton イシュアアプリケーションでボタンを使用するためのガイドライン。 Apple Walletに追加 ボタンをイシュアアプリケーションで使用するためのガイドライン。

次は iOS SDK 2.0.0 およびそれ以前に適用されます。

Swift

func getCardDigitizationResultWithFundingCardWithSchemeAndPayload() {
    let scheme = CardScheme.Mastercard
    let payload = "PKCS7 encrypted PAN"
    
    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 = "PKCS7 encrypted PAN"
      let primaryAccountNumberSuffix = "Last 4 Digits of 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 {
      // エラーを処理する
    } else if let sdkResult = sdkResult {
      if sdkResult.localPKPass?.secureElementPass?.passActivationState == .requiresActivation {
        // アクティベートアクションについてはトークンライフサイクル管理を参照してください。 
        // iPhone上でカードのアクティベーションが保留中です。
      } else if sdkResult.remotePKPass?.secureElementPass?.passActivationState == .requiresActivation {
        // アクティベートアクションについてはトークンライフサイクル管理を参照してください。 
        // Apple Watch上でカードのアクティベーションが保留中です。
      } else if sdkResult.localPKPass != nil && sdkResult.remotePKPass == nil {
        if isWatchPaired {
          // Apple Watch用の「Apple Walletに追加」ボタンを表示します。
        } else {
          // 「Apple Walletに追加」ボタンを非表示にします。
        }
      } else if sdkResult.localPKPass == nil {
        // 「Apple Walletに追加」ボタンを表示します。
      } else if sdkResult.localPKPass != nil && sdkResult.remotePKPass != nil {
        // カードは既にプロビジョニングされています。「Apple Walletに追加」ボタンを非表示にします。
      }
    }
  }

Objective-C

次は iOS SDK 2.1.0 以降に適用されます。

Swift

func getTokenWithInputByLast4() {
    // 物理カード（FPAN）の下4桁。
    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)
    }
}

// - Since: 2.3.0
func getTokenWithInputBySerialNumber() {
    // Apple Payにより提供されるシリアル番号。
    let serialNumber = "Serial number"
    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 {
        // エラーを処理します。
    } else {
        if localPass?.secureElementPass?.passActivationState == .requiresActivation {
            // アクティベートアクションについてはトークンライフサイクル管理を参照してください。 
            // iPhone上でカードのアクティベーションが保留中です。
        } else if remotePass?.secureElementPass?.passActivationState == .requiresActivation {
            // アクティベートアクションについてはトークンライフサイクル管理を参照してください。 
            // Apple Watch上でカードのアクティベーションが保留中です。
        } else if localPass != nil && remotePass == nil {
            if isWatchPaired {
                // Apple Watch用の「Apple Walletに追加」ボタンを表示します。
            } else {
                // 「Apple Walletに追加」ボタンを非表示にします。
            }
        } else if localPass == nil {
            // 「Apple Walletに追加」ボタンを表示します。
        } else if localPass != nil && remotePass != nil {
            // カードは既にプロビジョニングされています。「Apple Walletに追加」ボタンを非表示にします。
        }
    }
}

Objective-C

注意

• プロビジョニング後もカードが「NOT_DIGITIZED」と表示される場合は、イシュアアプリケーションがTSPポータルで正しく構成されているか確認してください。

• その TPCSDK.isCardDigitized APIは非推奨で推奨されません。代わりに次のAPIを使用してください。 getToken APIを使用してください。なお、 isCardDigitized APIはカードがアクティベーション保留中か、iPhone上かApple Watch上かを示しません。

ステップ2: カードをプロビジョニングする

プロビジョニングデリゲートはプロビジョニング完了後に PKPass を返します。それを使用してカードのデジタル化状況を確認します。デリゲートが nilを返す場合、SDKはエラーも返します。

PKPass クラスを使用する前に、PassKit.framework をプロジェクトに追加してください。

警告

このAPIを呼び出す前に、イシュアアプリケーションにPush Provisioning権限を追加する必要があります。そうしないと、APIはエラーを返します。権限を取得するには次の手順に従ってください。 Push Provisioning Access ガイドライン.

次のAPIを使用して取得します。 getToken ローカルPKPass または リモートPKPass 。いずれかがでない場合、PKSecureElementPass オブジェクトの または リモートPKPass 。いずれかが primaryAccountIdentifier nilプロパティにアクセスします。取得した を provision APIに渡します。 Visa、Mastercard、Amex、Discover の標準スキーム列挙値を使用したプロビジョニング を func onProvisionCompletion(pass: PKPaymentPass?, error: Error?) { if let error = error { if let tpcError = error as? TPCError {

// TPCError を処理する

Swift

let provisionError = error as NSError
    if provisionError.domain == PKPassKitErrorDomain  {
      // Apple からのエラー
          // https://developer.apple.com/documentation/passkit/pkaddpaymentpasserror
      } else {
          switch provisionError.code {
          case PKAddPaymentPassError.unsupported.rawValue:
              print("アプリはApple Payにカードを追加できません。")
              case PKAddPaymentPassError.userCancelled.rawValue:
              print("ユーザーがApple Payへのカード追加の要求をキャンセルしました。")
                  case PKAddPaymentPassError.systemCancelled.rawValue:
                      print("システムがApple Payへのカード追加の要求をキャンセルしました。")
                  default:
                      break
                  } else if let pass = pass {
                      // pass オブジェクトで成功した結果を処理する
                  func provision() {
                      let suffix = "1234"
              }
          }
      }
    let cardholderName = "John Doe"
        let code = "code"
    }
  }
  
  TPCSDK.provision(fromController: self,
    primaryAccountSuffix: suffix,
    cardholderName: cardholderName,
    let scheme = CardScheme.Mastercard
    let payload = "PKCS7 encrypted PAN"
    scheme: scheme,
    
    encryptedPayload: payload,
                     authorizationCode: code,
                     provisionDelegate: self)
                     - (void)onProvisionCompletionWithPass:(PKPaymentPass * _Nullable)pass
                     error:(NSError * _Nullable)error {
                     // TODO: プロビジョニングに問題があります
                     // 詳細は Swift コードを参照してください
  }

Objective-C

primaryAccountIdentifier:primaryAccountIdentifier,

Swift

let provisionError = error as NSError
    if provisionError.domain == PKPassKitErrorDomain  {
      // Apple からのエラー
          // https://developer.apple.com/documentation/passkit/pkaddpaymentpasserror
      } else {
          switch provisionError.code {
          case PKAddPaymentPassError.unsupported.rawValue:
              print("アプリはApple Payにカードを追加できません。")
              case PKAddPaymentPassError.userCancelled.rawValue:
              print("ユーザーがApple Payへのカード追加の要求をキャンセルしました。")
                  case PKAddPaymentPassError.systemCancelled.rawValue:
                      print("システムがApple Payへのカード追加の要求をキャンセルしました。")
                  default:
                      break
                  } else if let pass = pass {
                      // pass オブジェクトで成功した結果を処理する
                  func provision() {
                      let suffix = "1234"
              }
          }
      }
    let cardholderName = "John Doe"
        let code = "code"
    }
  }
  
  TPCSDK.provision(fromController: self,
    primaryAccountSuffix: suffix,
    cardholderName: cardholderName,
    let scheme = "SCHEME" // VISA, MASTERCARD, AMEX, DISCOVER
    let payload = "PKCS7 encrypted PAN"
    scheme: scheme,
    NSString * scheme = @"SCHEME"; // VISA, MASTERCARD, AMEX, DISCOVER
    let primaryAccountIdentifier = "primaryAccountIdentifier"
    
    encryptedPayload: payload,
                     authorizationCode: code,
                     provisionDelegate: self)
                     NSString * productId = @"productId"; // 国内スキームにのみ適用されます。これは金融機関のカード管理システムから取得できます。
                     error:(NSError * _Nullable)error {
                     // TODO: プロビジョニングに問題があります
                     NSString * primaryAccountIdentifier = @"primaryAccountIdentifier";
                     schemeString:scheme
                     // 詳細は Swift コードを参照してください
  }

Objective-C