3. 初期化

NFC Wallet SDK の初期化

注

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

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

次を使用できます TSHPay.configure SDK を初期化する API。ウォレットは 2 つのパラメータを提供する必要があります:

• カード所有者認証方法（CVM）

• 構成 PLIST ファイル

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

カード所有者認証方法

ウォレットは、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] ウォレットプロバイダーの ID です。
MG_WALLET_APPLICATION_ID	[String] ウォレットプロバイダーのアプリケーションの ID で、顧客からの任意入力です。これは、ウォレットプロバイダーが複数のウォレットアプリケーションをサポートしている場合に必要です。
TRANSACTION_HISTORY_CONNECTION_URL	[String] 取引履歴を取得するための URL で、Thales により提供されます。
SECURE_LOG_LEVEL	[Number] 書き込むログのレベルを定義します。 off = 0, fatal = 1, error = 2, warn = 3, info = 4、および debug = 5.
DOMESTIC_CURRENCY_CODE	[Number] 国内通貨コードの構成は、ISO-4217 標準の数値形式に従って提供されます。通貨コード番号の先頭の「0」は省略してください。設定されていない場合、デフォルト値は 978（ユーロ）です。
VISA_ONLINEPIN_PRIORITY	[Boolean] Visa Online PIN Priority を構成します。これが設定されていない場合、SDK は CDCVM 優先で Visa トランザクションを処理します。詳細は、 Visa CVM priority の構成.

構成 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 の初期化後、デバイスの有効性を確認して以下をチェックします:

• 次を使用するデバイス所有者認証方法 deviceEligibility.

• 次を使用する非接触決済機能 contactlessPaymentEligibility.

デバイスが要件を満たしている場合、SDK は次を返します supported.

func checkDeviceEligibility() {
    Task {
        let eligibility = await TSHPay.shared.deviceEligibility
        switch eligibility.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("Retrieved wallet ID: \(walletIdentifier)")