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

# NFC Wallet SDKの問題を報告する

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

効率的にトラブルシューティングするために、Thales サポートは重要な詳細を最初に必要とします。

文脈が不足していると、たいていはやり取りが増え、解決が遅くなります。

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

1. **NFC Wallet SDK のバージョンとビルド種別**
   * SDK のバージョンを指定してください。
   * 使用しているのが `dev` または `リリース` ビルド。
2. **問題の種類**
   * クラッシュ（クラッシュログを含めてください）。
   * SDK エラー（エラーの詳細を含めてください）。
   * ユーザー体験の問題
   * その他（明確に説明してください）。
3. **ユースケース**
   * 初期化またはウォレットのセキュア登録（WSE）。
   * トークン化（デジタルカードを作成してプロビジョニングする）。
   * LCM（停止、再開、削除）。
   * その他（説明してください）。
4. **問題の概要**
   * 何が起こったのか、いつ始まったのかを説明してください。
   * クラッシュの場合はスタックトレースを添付してください。スタックトレースがアプリケーションのマッピングファイル（アプリケーションのビルド時に生成）によってすでにデコードされていることを確認してください。
   * SDK エラーの場合は、以下を含めてください:
     * 最後に呼び出した NFC Wallet SDK の API メソッド。
     * エラーコードとメッセージ。
     * エラーオブジェクトの追加フィールド。
   * ユーザー体験の問題の場合は、スクリーンショットまたは画面録画を添付してください。
5. **再現手順**
   * 正確な番号付きの手順を記載してください。
   * 前提条件（設定、テストアカウントの状態、ネットワークなど）を明記してください。
   * 系統的（100% 再現可能）か断続的かを明確にしてください。
6. **期待される動作**
   * 期待していた内容と実際に観測した内容を説明してください。
   * **注記**: ときどき、SDK 機能の動作の誤解が問題として報告されることがあります。
7. **環境**
   * 指定してください `プリプロダクション` または `本番`.
   * 配布先（内部テスト、ベータ版、または一般ユーザー）を指定してください。
8. **影響を受けるデバイスと Android バージョン**
   * 問題が再現するデバイスモデルと Android バージョンを列挙してください。
   * 問題が〜するデバイスを列挙してください。 *しない* 再現しない場合（判明している場合）。
9. **発生率**
   * 件数と時間枠を記載してください（たとえば「10回中2回」または「24時間で10回」）。
   * 影響を受けるエンドユーザーの割合を見積もってください。
10. **影響を受けるウォレットインスタンスとデジタルカード**
    * ウォレット ID を共有してください（参照 [ウォレット ID を取得する](/nfc-wallet-sdk-android/ja/get-started/configuration/4.-initialize-the-nfc-wallet-sdk.md#retrieve-the-wallet-id)).
    * デジタルカード識別子を共有してください（参照 [トークン化カード ID とデジタルカード ID](/nfc-wallet-sdk-android/ja/implement-nfc-wallet/manage-digital-cards/display-digital-cards.md#tokenized-card-id-versus-digital-card-id)).
11. **NFC Wallet SDK のログ**
    * 制御された環境で再現できる場合は、あなたのビルドを使用して再現してください **デジタルウォレットアプリケーション** のビルドを使用して再現します `dev` ビルド。
    * に従ってください [Android デバイスからログを取得する](/nfc-wallet-sdk-android/ja/help/knowledge-base/retrieve-logs-from-an-android-device.md).

{% 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. 期待されるフローを確認してください。
   * これは〜ですか **green フロー** または **yellow フロー**?
   * しましたか **ウォレットセキュア登録** 正常に完了しましたか？
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 サポートに問題を報告する際は、このテンプレートを使用してください。

置き換えてください `<ここに記入してください>` をあなたの値で。使用してください `該当なし` 該当しない場合に使用してください。

```
1) NFC Wallet SDK のバージョンとビルド種別（`dev` または `release`）: <ここに記入してください>

2) 問題の種類（クラッシュ、SDK エラー、ユーザー体験、その他）: <ここに記入してください>

3) ユースケース（SDK 初期化、ウォレットのセキュア登録、トークン化、支払い、LCM、その他）: <ここに記入してください>

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

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

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

7) 環境（`Pre-Production` または `Production`）および配布先（内部テスト、ベータ版、一般ユーザー）: <ここに記入してください>

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

9) 発生率: <ここに記入してください>

10) Wallet ID と `digitalCardID`（該当する場合）: <ここに記入してください>

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-android/ja/help/knowledge-base/report-nfc-wallet-sdk-issues.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.
