3. 初期化

NFC Wallet SDKの初期化時に

注記

NFC Wallet SDK は iCloud およびデバイスバックアップからの復元機能をサポートしていません。

デジタルウォレットアプリケーション（wallet）は、NFC Wallet SDK の機能を使用できるようになる前に SDK を初期化する必要があります。

次を使用できます TSHPay.configure API を使用して SDK を初期化します。wallet では、次の 2 つのパラメーターを提供する必要があります。

• カード所有者の検証方式 (CVM)
• Configuration PLIST ファイル

SDK の初期化は、アプリケーションが起動されるたびに実行する必要があります。

カード所有者の検証方式

wallet は、SDK 初期化時に認証方式を提供する必要があります。次の認証方式のいずれかが選択されます。

• .userPresence : 生体認証（TouchID/FaceID）を使用し、フォールバックとしてデバイスのパスコードを使用する認証方式、またはカードのデジタル化後に生体認証が削除された場合にデバイスのパスコードを使用する認証方式です。MPA は、支払い確認の手順中に認証方式を生体認証またはデバイスのパスコードに変更できます。
• biometricOnly :TouchID/FaceID のみを使用する認証方式です。

カード所有者の検証方式の詳細については、API ドキュメントを参照してください。

PLIST ファイルの設定

PLIST ファイルを作成し、モバイルアプリケーションのメインバンドルに保存する必要があります。

TSHPay.plist

TSHPay.plist パラメーターの説明

キー	コメント
REALM	[String] 固定パラメーター。例: "CBP"。
OAUTH_CONSUMER_KEY	[String] Thales から提供される Consumer Key です。
GATEWAY_URL	[String] Thales から提供される Rages の URL です。
CSR_DOMAIN	[String] HTTPS 呼び出しを保護するコンポーネント内の証明書署名要求に使用されます。設定する値については、Thales のインテグレーターにお問い合わせください。
CSR_EMAIL	[String] 会社のメールアドレス。
CPS_URL	[String] Thales のインテグレーターから提供される CPS サーバーの URL です。
MG_CONNECTION_URL	[String] Thales から提供される MG サーバーの URL です。
MG_WALLET_PROVIDER_ID	[String] wallet プロバイダーの ID です。
MG_WALLET_APPLICATION_ID	[String] wallet プロバイダーのアプリケーションの ID です。これは顧客からの任意入力です。wallet プロバイダーが複数の wallet アプリケーションをサポートしている場合に必要です。
TRANSACTION_HISTORY_CONNECTION_URL	[String] Thales から提供される取引履歴取得用の URL です。
SECURE_LOG_LEVEL	[Number] 書き込むログのレベルを定義します。 off = 0, fatal = 1, error = 2, warn = 3, info = 4、および debug = 5.
DOMESTIC_CURRENCY_CODE	[数値] 国内通貨コードの設定は、ISO-4217 標準の数値形式に従って指定されます。通貨コード番号の先頭の「0」は省略してください。設定されていない場合の既定値は 978（ユーロ）です。
VISA_ONLINEPIN_PRIORITY	[ブール値] Visa Online PIN の優先順位を設定します。これが設定されていない場合、SDK は CDCVM の優先順位で Visa トランザクションを処理します。詳細については、以下を参照してください Visa の CVM 優先順位を設定する.

構成 PLIST ファイルには、たとえば「YourPlistName.plist」のようにカスタム名を定義できます。カスタム名は SDK の初期化時に指定できます。

既定では、NFC Wallet SDK は TSHPay.plist モバイルアプリケーションから指定がない場合、アプリケーションのメインバンドル内で

以下の例は、既定の TSHPay.plist を使用して SDK を初期化する方法を示しています

Task {
    do {
        try await TSHPay.shared.configure(withVerificationMethod: .userPresence)
    } catch let error as TSHPaySDK.TSHPay.Error {
        switch error {
        case .storageUnrecoverableError:
            do {
                try await TSHPay.shared.reset()
                try await TSHPay.shared.configure(withVerificationMethod: .userPresence)
            } catch {
                // エラーを処理します。
            }
            
        default: break
            // 他のエラーを処理します。
        }
    }
}

デバイスの有効性を確認する

SDK の初期化後、次を確認するためにデバイスの有効性を確認してください:

• 使用するデバイス所有者の認証方法 デバイスの適格性.
• を使用した非接触決済機能 非接触決済の利用資格.

デバイスが要件を満たしている場合、SDK は返します サポート済み.

func checkDeviceEligibility() {
    Task {
        let 有効性 = await TSHPay.shared.device有効性
        switch 有効性.deviceOwnerAuthentication {
        case .supported:
            // デバイスは対象です。トークン化を開始できます。
        case .passcodeNotSet:
            // デバイスのパスコードを設定するようエンドユーザーに求めます。
        case .biometricNotSet:
            // エンドユーザーに生体認証（Touch ID / Face ID）の登録を求めます。
        }
    }
}

ウォレットIDの取得

使用する TSHPay.walletID を使ってウォレット識別子を取得します。

SDK は、最初に呼び出したときにウォレット ID を生成します TSHPay.configure.

ウォレット ID はアプリケーションの再起動後も維持されます。

SDK をリセットすると、ウォレット ID は再生成されます。

ウォレット ID はトラブルシューティングとサポートに使用します。

let walletIdentifier = TSHPay.walletID
print("取得したウォレットID: \(walletIdentifier)")