> 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/ja/help/knowledge-base/how-to-report-issues-with-thales-nfc-wallet-sdk.md).

# Thales NFC Wallet SDKの問題を報告するには？

### 一般的な注意事項 <a href="#general-notes" id="general-notes"></a>

効率的にトラブルシューティングするため、Thales のオンボーディングおよびサポートチームは最初に重要な詳細を必要とします。コンテキストが不足していると往復が増え、解決が遅くなることが多いです。

すべての問題報告に以下を含めてください:

1. **NFC Wallet SDK のバージョンとバリアント**
   * SDK のバージョンを指定してください。
   * 次のいずれを使用しているか指定してください `デバッグ` または `リリース` バリアント。
2. **問題の種類**
   * クラッシュ（クラッシュログを添付してください）。
   * SDK エラー（エラーの詳細を含めてください）。
   * ユーザー体験の問題
   * その他（明確に説明してください）。
3. **ユースケース**
   * 初期化またはウォレットのセキュア登録（WSE）。
   * トークン化（デジタルカードの作成とプロビジョニング）。
   * ライフサイクル管理（停止、再開、削除）。
   * その他（説明）。
4. **問題の要約**
   * 何が起きたか、いつ始まったかを説明してください。
   * クラッシュについてはスタックトレースを添付してください。スタックトレースはアプリケーションマッピングファイル（アプリビルド時に生成）によって既にデコードされていることを確認してください。
   * SDK エラーの場合、次を含めてください:
     * 最後に呼び出された NFC Wallet SDK の API メソッド。
     * エラーコードとメッセージ。
     * エラーオブジェクトのその他のフィールド（あれば）。
   * ユーザー体験の問題については、スクリーンショットまたは画面録画を添付してください。
5. **再現手順**
   * 正確な番号付きの手順を提供してください。
   * 前提条件（設定、テストアカウントの状態、ネットワークなど）を明示してください。
   * それが体系的（100% 再現）か断続的かを明確にしてください。
6. **期待される動作**
   * 期待したことと観察したことを説明してください。
   * **注意**: 場合によっては SDK 機能の誤解釈が問題として報告されることがあります。
7. **環境**
   * 指定してください `PreProd` または `Production`.
   * 配布方法を指定してください
   * 対象（社内テスト、ベータユーザー、一般ユーザー）を指定してください。
8. **影響を受けるデバイスと iOS バージョン**
   * 問題が再現するデバイスモデルと iOS バージョンを列挙してください。
   * 問題が *再現しない* デバイス（既知であれば）を列挙してください。
9. **発生率**
   * 回数と時間範囲を提供してください（例：「10 回中 2 回」または「24 時間で 10 回」）。
   * 影響を受けるエンドユーザーの割合を推定してください。
10. **影響を受けるウォレットインスタンスまたはデジタルカード**

* 影響を受けるウォレットインスタンス（特定のエンドユーザーデバイスにインストールされたアプリケーション）を定義してください。
  * 対応する Wallet ID を共有してください
  * 使用方法 `TSHPay.walletID` でウォレット識別子を取得します。
* 影響を受けるデジタルカードを特定してください（該当する場合）。
  * 可能な場合は対応する識別子（`digitalCardID`）を共有してください。
  * 取得する `digitalCardID` から `DigitalCard#digitalCardID`.

11. **NFC Wallet SDK ログ**

* 制御された環境で再現できる場合は、 `デバッグ` ビルドで再現しログを収集してください。
* 次に従ってください [iOS デバイスからログを取得する方法](https://thales-dis-dbp.stoplight.io/docs/tsh-hce-ios/824559a389952-how-to-retrieve-logs-from-an-i-os-device).

{% hint style="warning" %}
チケットに PAN、CSC/CVV2、OTP、またはその他のエンドユーザーの機微なデータを共有しないでください。代わりに次のような識別子を使用してください: `digitalCardID` 代わりに。
{% endhint %}

### ユースケース固有の詳細を提供してください <a href="#issues-in-certain-use-cases" id="issues-in-certain-use-cases"></a>

一部のユースケースには追加のコンテキストが必要です。標準テンプレートに加えて以下の詳細を追加してください。

“トークン化が失敗する”や“支払いが動作しない”のような一般的な記述は避けてください。トリアージを妨げ、解決を遅らせます。

{% tabs %}
{% tab title="トークン化" %}

1. 期待されるフローを確認してください。
   * これは **グリーンフロー** または **イエローフロー**?
   * ウォレットのセキュア登録は **正常に** 完了しましたか？
2. フローがどこで止まるかを特定してください。
   * 最後に呼び出された NFC Wallet SDK の API メソッドは何ですか？
   * 最後に正常に完了した NFC Wallet SDK の API メソッドは何ですか？
3. 正確なエラー（ある場合）を共有してください。
   * エラーコードとメッセージは何ですか？
   * エラーオブジェクトに返される追加フィールドは何ですか（存在する場合）？
     {% endtab %}

{% tab title="支払い" %}

1. 支払いのユースケースを説明してください。
   * これは **非接触支払い**, **DSRP リモート支払い**, または **QR コード支払い**?
   * どの **決済ネットワーク** が影響を受けていますか（例：Visa または Mastercard）？
2. 非接触支払いの場合、セットアップを共有してください。
   * あなたの **デジタルウォレットアプリケーション** がデフォルトの支払いアプリに設定されていますか？
   * どのモードを使用していますか：ダブルクリック、フィールド検出、または手動モード？
   * 支払いはデフォルトの支払いカードで開始しますか、それとも特定の `digitalCardID`?
   * どのプロファイルが使用されていますか：カードライクまたはフレキシブル **CDCVM**?
3. 正確なエラー（ある場合）を共有してください。
   * エラーコードとメッセージは何ですか？

{% hint style="info" %}
支払いの問題については、 **トークン化** および支払い試行の両方のデバイスログを含めてください。
{% endhint %}
{% endtab %}
{% endtabs %}

### 問題報告テンプレート <a href="#issue-report-template" id="issue-report-template"></a>

Thales TSH Pay SDK サポートチームに問題報告を送信する際は、次のテンプレートを使用してください。

テンプレートのフィールドを例えば次のように置き換えてください `< PLEASE FILL HERE >` 対応する詳細に置き換えるか、 `N/A` 該当情報が利用できない場合は入力してください。

```
1) Thales TSH Pay SDK バージョンとバリアント: < PLEASE FILL HERE >

2) 問題の種類: < PLEASE FILL HERE のうちの1つ: crash, SDK error, user experience, other >

3) 関連するユースケース: < PLEASE FILL HERE のうちの1つ: SDK init, token enrollment, payment, replenishment, life-cycle management, other >

4) 問題の要約: < PLEASE FILL HERE を自由記述で >

5) 再現手順: < PLEASE FILL HERE を自由記述で >

6) 期待される動作: < PLEASE FILL HERE を自由記述で >

7) アプリケーション環境: < PLEASE FILL HERE から最も適切なものを指定: PPROD/PROD; internal testing, beta, publicsssss >

8) 影響を受けるデバイス: < PLEASE FILL HERE OS バージョンを含むデバイス情報を記載 >

9) 発生率: < PLEASE FILL HERE 問題発生に関する統計を記載 >

10) トークン ID/ウォレット ID 参照: < PLEASE FILL HERE >

11) ログ: < ログをプレーンテキストファイルとして添付してください >
```


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/nfc-wallet-sdk-ios/ja/help/knowledge-base/how-to-report-issues-with-thales-nfc-wallet-sdk.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.