> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/merchant-tokenization/ja/sdk-tong-he/integration/ios.md). # iOS このガイドを使用して、を統合します **Thales SDK** iOSのマーチャントネイティブアプリケーションに。 ## 配布パッケージ SDK配布パッケージには以下が含まれます:

名前	説明
バイナリ	Thales SDKのリリースおよびデバッグバリアント。
デモ	Thales SDKの統合方法と使用方法を示すサンプルプロジェクト。
Apidoc	Thales SDK APIドキュメント。
ライセンス	Thales SDKに同梱されているサードパーティフレームワークのライセンス。

## SDKを統合する 1. というフォルダを作成します `Framework`. 2. をコピーします `.xcframework` バンドルをから `Binaries//` へ `Framework` フォルダ。

例 `Framework` SDKを含むフォルダ `.xcframework` バンドル。

3. をドラッグします `TMGSDK.xcframework` です。難読化の詳細は、 `SecureLogAPI.xcframework` から `Framework` フォルダへ **Frameworks, Libraries, and Embedded Content** ターゲット設定の中に。

4. アプリのFace ID使用説明を追加します `Info.plist`.

## SDKを構成する SDKのいかなるAPIを呼ぶ前にもThales SDKを構成してください。を作成します `TMGClientConfiguration` 必要なパラメータで: * サーバーURL * サーバー証明書 * キー識別子 * 証明書PIN #### 1. を作成します `TMGClientConfiguration` オンボーディング中にサーバーURL、サーバー証明書、およびキー識別子を取得します。 ```swift let serverURL = "" let serverCertificate = "" let serverKeyID = "" let configuration = TMGClientConfiguration(serverURL: serverURL, serverCertificate: Data(serverCertificate.utf8), serverKeyID: serverKeyID) ``` #### 2. を作成します `VisaCTFHelper` Visa CTFおよびDAFのデバイスバインディング開始とトランザクション認証のためのヘルパーを作成します。 ```swift do { let visaCTFHelper = try TMGClient.sharedInstance.createVisaCTFHelper(withConfiguration: configuration) } catch let error { // エラーを処理します } ``` #### 3. を作成します `MastercardTAFHelper` Mastercard TAFのデバイスバインディング開始とトランザクション認証のためのヘルパーを作成します。 ```swift do { let mastercardTAFHelper = try TMGClient.sharedInstance.createMastercardTAFHelper(withConfiguration: configuration) } catch let error { // エラーを処理します } ``` SDKがヘルパーを作成できない場合、エラーをスローします。 {% hint style="info" %} SDKの各バリアントは意図された環境でのみ使用してください。を作成すると、SDKはを返します `VisaCTFHelper`、SDKはを返します `deviceEnvironmentUnsafe` 次の場合: * `デバッグ`: アプリに配布またはアドホックの証明書で署名しています。 * `リリース`: アプリをデバッグしている、またはXcodeから起動している、もしくは `xcodebuild`. このエラーが発生した場合は、デバッグを停止してデバイスでアプリを再起動してください。 {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.payments.thalescloud.io/merchant-tokenization/ja/sdk-tong-he/integration/ios.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.