ウォレットを登録する

概要

登録する デジタルウォレットアプリケーション 後に NFC Wallet SDK 初期化後、開始前に トークン化。ウォレット登録は、デジタルウォレットアプリケーションに、呼び出しに必要なセキュリティ資産を提供します NFCウォレット サービス:

• これはウォレットインスタンスごとに1回だけ実行します。
• デジタルウォレットアプリケーションが NFCウォレット サービスを使用している場合にのみ実行します。
• これは非接触決済をサポートするデバイスでのみ実行します。参照: 非接触対応を確認する.

〜を使用するデジタルウォレットアプリケーションのみを登録してください NFCウォレット サービスを使用している場合にのみ実行します。

これにより、デジタルウォレットアプリケーションからの不要なネットワークトラフィックと、 NFCウォレット 製品への不要な負荷を回避できます。

シーケンス図

ウォレットアプリケーションを登録するための高レベルなフロー。

ウォレット登録フロー。

このフローの技術的な名称は ウォレットのセキュア登録 で NFCウォレット.

SDK統合

前提条件

開始前に、以下を確認してください:

• デジタルウォレットアプリケーションが NFCウォレット バックエンドにオンボーディングされている。
• 〜を初期化した NFC Wallet SDK.
• ウォレットは登録されていない（WalletSecureEnrollmentService.isEnrolled() を返す false).
• 非接触決済をサポートする場合は、デバイスが対象であることを確認してください。参照: 非接触対応を確認する.

デジタルウォレットアプリケーションが非接触決済をサポートしない場合は、非接触機能のチェックをスキップします（たとえば、QRコードのみ、またはDSRPリモート決済のみの場合）。

ウォレット登録を実行する

ウォレット登録は、デジタルウォレットアプリケーションのライフサイクルにおける一度きりの操作です。

SDK初期化後に実行し、ウォレットが未登録の場合のみ行います。

1. 次を WalletSecureEnrollmentService インスタンスを作成します。
2. 確認 wse.isEnrolled().
3. 必要に応じて、次を呼び出します: wse.enroll() して処理を開始します。操作が成功すると、ウォレットの安全な登録は完了します。失敗した場合はエラーがスローされます。

ウォレットの安全な登録が正常に完了したら、次へ進みます: カードをトークン化する.

func invokeWSEAsync() async {
   do {
        let wse = try WalletSecureEnrollmentService()
        // ウォレットの登録状態を確認します。
        if wse.isEnrolled() {
            // WSEは登録済み
        } else {
            // ウォレットの安全な登録を開始します。
            try await wse.enroll()
            // ここで登録処理が正常に完了します。
        }
    } catch {
        // WSEエラー 
    }
}

エラー

ウォレット登録に失敗した場合は、次のエラー種別を処理してください:

• clientError: SDK内部エラー。メッセージがデジタルウォレットアプリケーションに提供されます。
• serverError: バックエンドエラー。メッセージ、 httpStatus, errorCode、および任意の additionalInfo がデジタルウォレットアプリケーションに提供されます。
• networkError: デバイスにインターネット接続がありません。

この WalletSecureEnrollmentService.eventStream と WalletSecureEnrollmentService.State APIは非推奨であり、次のリリースで削除されます。そのため、コードを移行して次を使用する必要があります: WalletSecureEnrollmentService.enroll API、および上記で示したすべての新しい実装で

非推奨のAPI

以下の例は、次の使用方法を示します: WalletSecureEnrollmentService.State と WalletSecureEnrollmentService.eventStream 非推奨のAPIです。

次は、 WalletSecureEnrollment のときに WalletSecureEnrollmentService.eventStream （非推奨）APIが使用される場合:

• .started: ウォレットの安全な登録プロセスが開始されます。
• .completed : ウォレットの安全な登録プロセスが完了します。
• .errorEncountered: ウォレットの安全な登録エラーが返されます。

// 非推奨API
func invokeWSEAsync() async {
    do {
        let wse = try WalletSecureEnrollmentService()
        // ウォレットの登録状態を確認します。
        if wse.isEnrolled() {
            // WSEは登録済み
        } else {
          // ウォレットの安全な登録を開始します。
            wse.enroll()
            for await state in wse.eventStream {
              switch state {
                case .started:
                  // WSE開始時にトリガーします。
                case .completed:
                  // WSE完了時にトリガーします。
                case .errorEncountered(let error):
                  switch error {
                    case .clientError(let message):
                        // エラー処理 
                    case .serverError(let message, let httpStatus, let errorCode, let additionalInfo):
                        // エラー処理 
                    case .networkError:
                        // エラー処理 
                    }
                }
            }
        }
    } catch {
        // WSE初期化エラー 
    }
}