ウォレットを登録する

概要

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

ウォレットインスタンスごとに1回実行します。
デジタルウォレットアプリケーションが NFC Wallet サービスを使用する場合のみ実行します。
非接触型決済をサポートするデバイスでのみ実行します。参照：非接触機能を確認する.

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

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

シーケンス図

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

このフローは技術的には ウォレットの安全な登録 と呼ばれます NFC Wallet.

SDK統合

前提条件

開始する前に、次の内容を確認してください：

デジタルウォレットアプリケーションが NFC Wallet バックエンドにオンボードされている。
を初期化した。 NFC Wallet SDK.
ウォレットは登録されていません（WalletSecureEnrollmentService.isEnrolled() が false).
を返します非接触機能を確認する.

非接触型決済をサポートしている場合は、デバイスが有効であることを確認してください。参照：

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

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

ウォレット登録は、デジタルウォレットアプリケーションのライフサイクルにおける1回限りの操作です。SDKの初期化後に、かつウォレットが未登録の場合にのみ実行してください。

を作成します WalletSecureEnrollmentService インスタンス。
確認 wse.isEnrolled().
必要に応じて、 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 初期化エラー 
    }
}

前へ非接触機能を確認する次へカードをトークン化する

最終更新 2 か月前

役に立ちましたか？