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

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

11. **NFC Wallet SDK のログ**

* 制御された環境で再現できる場合は、次のものを使用して再現してください: `debug` ビルドしてログを収集してください。
* 次を参照してください [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`?
   * 使用しているプロファイルはどれですか：card-like または flexible **CDCVM**?
3. 正確なエラー（ある場合）を共有してください。
   * エラーコードとメッセージは何ですか？

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

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

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

テンプレートの各項目は、たとえば次のように置き換えてください `< ここに記入してください >` 該当する詳細に置き換えるか、次を記入してください `該当なし` その情報が利用できない場合。

```
1) Thales TSH Pay SDK のバージョンとバリアント: < ここに記入してください >

2) 問題の種類: < ここに記入してください 次のいずれか: crash, SDK error, user experience, other >

3) 関連するユースケース: < ここに記入してください 次のいずれか: SDK init, token enrollment, payment, replenishment, life-cycle management, other >

4) 問題の概要: < 自由記述でここに記入してください >

5) 再現手順: < 自由記述でここに記入してください >

6) 期待される動作: < 自由記述でここに記入してください >

7) アプリケーション環境: < ここに記入してください。次の中から最も適切なもの: PPROD/PROD; internal testing, beta, publicsssss >

8) 影響を受けるデバイス: < OS バージョンを含むデバイス情報をここに記入してください >

9) 発生率: < 問題の発生状況に関する統計をここに記入してください >

10) Token ID/Wallet ID 参照: < ここに記入してください >

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 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/nfc-wallet-sdk-ios/ja/help/knowledge-base/how-to-report-issues-with-thales-nfc-wallet-sdk.md?ask=<question>&goal=<user_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.