> 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/nfc-wallet-sdk-ios/get-started/configuration/1.-binary-integration.md).

# 1. Binary integration

## Integrate the NFC Wallet SDK for iOS

Use this guide to add the prebuilt NFC Wallet SDK frameworks to your iOS **digital wallet application**.

### Supported environment

NFC Wallet SDK for iOS supports the following configurations:

* **iOS version**: 16.0 and later.
* **Processor architectures:** arm64, arm64 & x86\_64 simulator.

NFC Wallet SDK for iOS has been tested with:

* Xcode 15.3
* Swift 5
* `ENABLE_BITCODE=NO`

{% hint style="warning" %}
Contacless payment is only supported for iOS version 17.4 and later. See [Check contactless capability](/nfc-wallet-sdk-ios/implement-nfc-wallet/check-contactless-capability.md).
{% endhint %}

{% hint style="info" %}
Supported environment for the **latest SDK version**.

Check the supported iOS versions for your SDK release in release note.
{% endhint %}

### Add the SDK frameworks to your Xcode project

To integrate NFC Wallet SDK to your application's project:

1. Copy the TSH Pay and SecureLogAPI folders containing the `TSHPaySDK.xcframework` and `SecureLogAPI.xcframework` to your application folder.
2. Go to **General** pane of your application target.
3. Drag and drop the SDKs in the configuration directory to the `Frameworks, Libraries and Embedded Content`.

{% hint style="warning" %}
**Use the correct build type**

When you submit your application to the App Store, use the **Release** build of the SDK.

Debug builds are intended only for development and troubleshooting.

For details, see [Deliverables](/nfc-wallet-sdk-ios/general/deliverables.md).
{% 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.payments.thalescloud.io/nfc-wallet-sdk-ios/get-started/configuration/1.-binary-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
