> 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/merchant-tokenization/ja/sdk-tong-he/error-management/sdk-error-codes.md).

# SDKエラーコード

前提条件が構成されていない場合、マーチャントアプリケーションは次の SDK エラーコードに遭遇する可能性があります。

## Android

| エラーコード                                 | ユースケース                                                            | 推奨事項                                                                                |
| -------------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------- |
| AUTHENTICATION\_FAILURE\_CANCEL        | デバイス認証に失敗した場合にこのエラーが返されます。                                        | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                        |
| DEVICE\_AUTHENTICATION\_NOT\_SUPPORTED | デバイスで生体認証が設定されていない場合にこのエラーが返されます。                                 | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                        |
| CRYPTO\_ERROR                          | キーストアに問題がある場合にこのエラーが返されます。                                        | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                        |
| INVALID\_PARAMETERS                    | 構成パラメータが有効でない場合にこのエラーが返されます。                                      | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                        |
| INVALID\_DEVICE\_AUTHENTICATION\_PARAM | 次の場合にこのエラーが返されます： `FragmentActivity` パラメータが null です。              | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                        |
| STORAGE\_ERROR                         | デバイス認証方法がストレージで見つからない場合にこのエラーが返されます。                              | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                        |
| TOKEN\_NOT\_BOUNDED                    | 提供されたトークンがデバイスにバウンドされていない場合にこのエラーが返されます。                          | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                        |
| TOKEN\_ALREADY\_BOUNDED                | 提供されたトークンがすでにデバイスにバウンドされているか、アクティベーション保留中の場合にこのエラーが返されます。         | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                        |
| TOKEN\_DEVICE\_BINDING\_PENDING        | デバイスバインディング処理がまだ保留中の場合にこのエラーが返されます。                               | <ul><li>デバイスバインディング処理を完了してください。</li></ul>                                           |
| TOKEN\_DEVICE\_BINDING\_DECLINED       | トークンのデバイスバインディングが拒否された場合にこのエラーが返されます。                             | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                        |
| INVALID\_IDV\_METHOD                   | 提供された ID\&V 方法が無効な場合にこのエラーが返されます。                                 | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                        |
| ISSUER\_AUTHENTICATION\_REQUIRED       | エンドユーザーが先に進む前にイシュア認証が必要な場合にこのエラーが返されます。                           | <ul><li>次を使用して ID\&V 方法を選択します： <code>IDVSession.selectIdvMethod()</code>.</li></ul> |
| INVALID\_OTP                           | 入力された OTP の形式が無効な場合にこのエラーが返されます。                                  | <ul><li>OTP は null または空であってはならず、8 桁以下である必要があります。</li></ul>                          |
| JSON\_PARSING\_ERROR                   | JSON の解析中にエラーが発生した場合にこのエラーが返されます。                                 | <ul><li>エラーメッセージを表示してください。</li></ul>                                                |
| INVALID\_TOKEN\_ID                     | 提供された Visa プロビジョニングトークン ID が null または空の場合にこのエラーが返されます。            | <ul><li>エラーメッセージを表示してください。</li></ul>                                                |
| KEYSTORE\_ERROR                        | 鍵が恒久的に無効化されている場合にこのエラーが返されます。たとえば、エンドユーザーが新しい生体認証（指紋）を登録した場合などです。 | <ul><li>エラーメッセージを表示してください。</li></ul>                                                |
| ATTESTATION\_ERROR                     | アテステーションオブジェクトの生成中に問題が発生した場合にこのエラーが返されます。                         | <ul><li>エラーメッセージを表示してください。</li></ul>                                                |

## iOS

| エラーコード                                              | ユースケース                                                                                                                                 | 推奨事項                                                                                           |
| --------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| `TMGError.tokenNotBound`                            | 提供されたトークンがデバイスにバウンドされていない場合にこのエラーが返されます。                                                                                               | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                   |
| `TMGError.tokenPending`                             | デバイスバインディング処理がまだ保留中の場合にこのエラーが返されます。                                                                                                    | <ul><li>デバイスバインディング処理を完了してください。</li></ul>                                                      |
| `TMGError.tokenDeclined`                            | トークンのデバイスバインディングが拒否された場合にこのエラーが返されます。                                                                                                  | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                   |
| `TMGError.tokenAlreadyBound`                        | 提供されたトークンがすでにデバイスにバウンドされているか、アクティベーション保留中の場合にこのエラーが返されます。                                                                              | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                   |
| `TMGError.invalidConfigParams`                      | 次の場合にこのエラーが返されます： `TMGClientConfiguration` パラメータが有効ではありません。                                                                            | <ul><li>実装の詳細を確認してください。</li></ul>                                                              |
| `TMGError.invalidRequiredParams`                    | 必須パラメータが無効な場合にこのエラーが返されます。                                                                                                             | <ul><li>実装の詳細を確認してください。</li></ul>                                                              |
| `TMGError.invalidIdvMethod`                         | 提供された ID\&V 方法が無効な場合にこのエラーが返されます。                                                                                                      | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                   |
| `TMGError.invalidOTPMessage`                        | 入力された OTP の形式が無効な場合にこのエラーが返されます。                                                                                                       | <ul><li>OTP は null または空であってはならず、8 桁以下である必要があります。</li></ul>                                     |
| `TMGError.issuerAuthenticationRequired`             | エンドユーザーが先に進む前にイシュア認証が必要な場合にこのエラーが返されます。                                                                                                | <ul><li>次を使用して ID\&V 方法を選択します： <code>PendingBindingSession.selectIdvMethod()</code>.</li></ul> |
| `TMGError.biometricNotSupported`                    | デバイスで生体認証が設定されていない場合にこのエラーが返されます。                                                                                                      | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                   |
| `TMGError.authenticationFailure(reason: String)`    | デバイス認証に失敗した場合にこのエラーが返されます。                                                                                                             | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                   |
| `TMGError.authenticationKeyInvalidated`             | エンドユーザーが認証に使用する生体情報を変更した場合にこのエラーが返されます。たとえば、エンドユーザーが Face ID や指紋の設定を更新した場合などです。このエラーが返されると、暗号キー ペアにアクセスできなくなり、すべてのトークンが自動的にバインド解除されます。 | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                   |
| `TMGError.internalError(additionalMessage: String)` | 内部エラーが発生した場合にこのエラーが返されます。 `additionalMessage` が詳細を提供します。このエラーは回復不可能です。Thales サポートに連絡してください。                                            | <ul><li>一般的なエラーメッセージをエンドユーザーに表示してください。</li></ul>                                               |
| `TMGError.deviceEnvironmentUnsafe(code: Int)`       | デバイス環境が潜在的に安全でない場合にこのエラーが返されます。難読化されたエラーコードを Thales に確認してください。                                                                         | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                   |


---

# 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/merchant-tokenization/ja/sdk-tong-he/error-management/sdk-error-codes.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.