> 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/backend-error-codes.md).

# バックエンドエラーコード

次のサーバーエラーコードは、Thales SDK と Thales バックエンド間の API 呼び出し中に発生する可能性があります。

## Android

| エラーコード                                | ユースケース                                                    | 推奨事項                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------------------------- | --------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| SERVER\_IS\_NOT\_ACCESSIBLE           | このエラーは、ネットワーク接続の問題により SDK が Thales バックエンドに到達できない場合に返されます。 | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li><li>エンドユーザーにインターネット接続を確認するよう伝えてください。</li></ul>                                                                                                                                                                                                                                                                                                                            |
| SERVER\_ERROR\_CRYPTO\_ERROR          | キーストアに問題がある場合にこのエラーが返されます。                                | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                                                                                                                                                                                                                                                                                                                                     |
| SERVER\_ERROR\_INVALID\_TOKEN\_STATE  | このエラーは、トークンの状態が無効な場合に返されます。                               | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                                                                                                                                                                                                                                                                                                                                     |
| SERVER\_ERROR\_IDV\_NOT\_AVAILABLE    | このエラーは、エンドユーザーが利用できない ID\&V 方法を選択した場合に返されます。              | <ul><li>Thales バックエンドは、SDK が次の <code>POST /idv-method</code> または <code>POST /otp</code> リクエストを送信したときにエラーを返します。SDK はこのエラーコードを <code>TokenBindingListener.onIssuerAuthenticationError()</code> コールバックを介して加盟店アプリケーションに返します。</li><li>使用する <code>IDVSession.getIdvMethods()</code> を呼び出して、エンドユーザーを認証するために使用できる ID\&V 方法の一覧を取得します。セッションがアクティブなままであれば、加盟店アプリケーションは <code>IDVSession.selectIdvMethod()</code>.</li></ul> |
| SERVER\_ERROR\_NO\_SESSION\_FOUND     | このエラーは、セッションが見つからない場合に返されます。                              | <ul><li>Thales バックエンドは、SDK が次の <code>POST /idv-method</code> または <code>POST /otp</code> リクエストを送信したときにエラーを返します。SDK はこのエラーコードを <code>TokenBindingListener.onError()</code> コールバックを介して加盟店アプリケーションに返します。</li><li>を呼び出します <code>VisaCTFHelper.createBinding()</code> を再度呼び出して、エンドユーザーが ID\&V 方法を選択するか OTP を検証する前に新しいセッションを作成します。</li></ul>                                                                            |
| SERVER\_ERROR\_WRONG\_OTP\_VALUE      | このエラーは、エンドユーザーが誤った OTP を入力した場合に返されます。                     | <ul><li>Thales バックエンドは、SDK が次の <code>POST /otp</code> リクエストを送信したときにエラーを返します。SDK はこのエラーコードを <code>TokenBindingListener.onIssuerAuthenticationError()</code> コールバックを介して加盟店アプリケーションに返します。</li><li>セッションはアクティブなままであり、加盟店アプリケーションは再試行するか、 <code>IDVSession</code> オブジェクトから取得できます。</li></ul>                                                                                                                           |
| SERVER\_ERROR\_EXPIRED\_OTP           | このエラーは、エンドユーザーが期限切れの OTP を入力した場合に返されます。                   | <ul><li>Thales バックエンドは、SDK が次の <code>POST /otp</code> リクエスト。</li><li>SDK はこのエラーコードを完了ハンドラーを介して加盟店アプリケーションに返します。 <code>TokenBindingListener.onIssuerAuthenticationError()</code> コールバックを介して加盟店アプリケーションに返します。</li><li>セッションはアクティブなままであり、加盟店アプリケーションは再試行するか、 <code>IDVSession</code> オブジェクトから取得できます。</li></ul>                                                                                                      |
| SERVER\_ERROR\_RETRY\_LIMIT\_EXCEEDED | このエラーは、エンドユーザーが許可された再試行回数を超えた場合に返されます。                    | <ul><li>Thales バックエンドは、SDK が次の <code>POST /otp</code> リクエストを送信したときにエラーを返します。SDK はこのエラーコードを <code>TokenBindingListener.onIssuerAuthenticationError()</code> コールバックを介して加盟店アプリケーションに返します。</li><li>セッションはアクティブなままであり、加盟店アプリケーションは再試行するか、 <code>IDVSession</code> オブジェクトから取得できます。</li></ul>                                                                                                                           |
| SERVER\_ERROR\_TOO\_MANY\_REQUEST     | このエラーは、特定の期間内にあまりにも多くのリクエストが送信された場合に返されます。                | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                                                                                                                                                                                                                                                                                                                                     |
| SERVER\_ERROR\_RETRYABLE              | このエラーは、サーバーが一時的な負荷過多または保守のためにリクエストを処理できない場合に返されます。        | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li><li>リクエストを再試行してください。</li></ul>                                                                                                                                                                                                                                                                                                                                            |
| SERVER\_ERROR                         | このエラーは、サーバーエラーが発生し、上記のいずれのエラーコードにも該当しない場合に返されます。          | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                                                                                                                                                                                                                                                                                                                                     |

## iOS

| エラーコード                                                            | ユースケース                                                                                                           | 推奨事項                                                                                                                                                                                                                                                                                                                                          |
| ----------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `TMGError.serverIsNotAccessible`                                  | このエラーは、ネットワーク接続の問題により SDK が Thales バックエンドに到達できない場合に返されます。                                                        | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li><li>エンドユーザーにインターネット接続を確認するよう伝えてください。</li></ul>                                                                                                                                                                                                                                                         |
| `TMGError.serverErrorCryptoError`                                 | キーストアに問題がある場合にこのエラーが返されます。                                                                                       | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                                                                                                                                                                                                                                                                  |
| `TMGError.serverErrorInvalidTokenState`                           | このエラーは、トークンの状態が無効な場合に返されます。                                                                                      | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                                                                                                                                                                                                                                                                  |
| `TMGError.serverErrorIdvNotAvailable`                             | このエラーは、エンドユーザーが利用できない ID\&V 方法を選択した場合に返されます。                                                                     | <ul><li>Thales バックエンドは、SDK が次の <code>POST /idv-method</code> または <code>POST /otp</code> リクエスト。SDK はこのエラーコードを完了ハンドラーを介して加盟店アプリケーションに返します。</li><li>使用する <code>PendingBindingSession.getIdvMethods()</code> を呼び出して、エンドユーザーを認証するために使用できる ID\&V 方法の一覧を取得します。セッションがアクティブなままであれば、加盟店アプリケーションは <code>PendingBindingSession.select()</code>.</li></ul> |
| `TMGError.serverErrorNoSessionFound`                              | このエラーは、セッションが見つからない場合に返されます。                                                                                     | <ul><li>Thales バックエンドは、SDK が次の <code>POST /idv-method</code> または <code>POST /otp</code> リクエスト。SDK はこのエラーコードを完了ハンドラーを介して加盟店アプリケーションに返します。</li><li>を呼び出します <code>VisaCTFHelper.createBinding()</code> を再度呼び出して、エンドユーザーが ID\&V 方法を選択するか OTP を検証する前に新しいセッションを作成します。</li></ul>                                                                     |
| `TMGError.serverErrorWrongOTP`                                    | このエラーは、エンドユーザーが誤った OTP を入力した場合に返されます。                                                                            | <ul><li>Thales バックエンドは、SDK が次の <code>POST /otp</code> リクエスト。SDK はこのエラーコードを完了ハンドラーを介して加盟店アプリケーションに返します。</li><li>セッションはアクティブなままであり、加盟店アプリケーションは再試行するか、 <code>PendingBindingSession</code> オブジェクトから取得できます。</li></ul>                                                                                                                             |
| `TMGError.serverErrorExpiredOTP`                                  | このエラーは、エンドユーザーが期限切れの OTP を入力した場合に返されます。                                                                          | <ul><li>Thales バックエンドは、SDK が次の <code>POST /otp</code> リクエスト。</li><li>SDK はこのエラーコードを完了ハンドラーを介して加盟店アプリケーションに返します。</li><li>セッションはアクティブなままであり、加盟店アプリケーションは再試行するか、 <code>PendingBindingSession</code> オブジェクトから取得できます。</li></ul>                                                                                                                    |
| `TMGError.serverErrorRetryLimitExceeded`                          | このエラーは、エンドユーザーが許可された再試行回数を超えた場合に返されます。                                                                           | <ul><li>Thales バックエンドは、SDK が次の <code>POST /otp</code> リクエスト。SDK はこのエラーコードを完了ハンドラーを介して加盟店アプリケーションに返します。</li><li>セッションはアクティブなままであり、加盟店アプリケーションは再試行するか、 <code>PendingBindingSession</code> オブジェクトから取得できます。</li></ul>                                                                                                                             |
| `TMGError.serverErrorTooManyRequest`                              | このエラーは、特定の期間内にあまりにも多くのリクエストが送信された場合に返されます。                                                                       | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li></ul>                                                                                                                                                                                                                                                                                                  |
| `TMGError.serverRetryable`                                        | このエラーは、サーバーが一時的な負荷過多または保守のためにリクエストを処理できない場合に返されます。                                                               | <ul><li>エラーメッセージをエンドユーザーに表示してください。</li><li>リクエストを再試行してください。</li></ul>                                                                                                                                                                                                                                                                         |
| `TMGError.serverError(let httpStatusCode, let additionalMessage)` | このエラーは、サーバーエラーが発生し、上記のいずれのエラーコードにも該当しない場合に返されます。 `httpStatusCode` です。難読化の詳細は、 `additionalMessage` はエラーの詳細を提供します。 | <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/backend-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.