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

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

```
1) NFC Wallet SDKのバージョンとビルドタイプ（`dev`または`release`）：<ここに入力してください>

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

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

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

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

6) 期待される挙動：<ここに入力してください>

7) 環境（`Pre-Production`または`Production`）と配布形態（社内テスト、ベータ、一般ユーザー）：<ここに入力してください>

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

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

10) ウォレット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:

```
GET https://docs.payments.thalescloud.io/nfc-wallet-sdk-android/ja/help/knowledge-base/report-nfc-wallet-sdk-issues.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.