> 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/classic-tokenization/ja/meru/apino/apigaidorain.md).

# APIガイドライン

### 開発上の考慮事項 <a href="#development-considerations" id="development-considerations"></a>

以下の変更は下位互換性があると見なされます：

* 新しいAPIリクエストを追加する。
* 既存のAPIリクエストまたはレスポンスに新しいオプションパラメータを追加する。
  * 本文、クエリパラメータ、またはHTTPヘッダーとして追加してください。
* 新しい列挙値を追加する。
* 必須パラメータをオプションにする。
* APIリクエストまたはレスポンスで受信した不明なフィールドや値を無視する。

### エラー管理 <a href="#error-management" id="error-management"></a>

#### レスポンスとエラータイプ <a href="#responses-and-error-types" id="responses-and-error-types"></a>

レスポンスはカテゴリに分類されます。同じカテゴリのすべてのレスポンスを同じ方法で処理してください。以下の表はカテゴリを列挙し、次の点を示します：

* 各カテゴリのエラータイプ。
* イシュアバックエンドがこれらのエラーをどのように処理するか（再試行ポリシーを含む）。

| コードタイプ | カテゴリ       | 説明と再試行ポリシー                                                                                                                    |
| ------ | ---------- | ----------------------------------------------------------------------------------------------------------------------------- |
| K      | OK、エラーではない | N/A                                                                                                                           |
| D      | データエラー     | 関数リクエスタが送信したパラメータが、関数プロバイダがチェックするルールと一致しません。                                                                                  |
| S      | システムエラー    | <p>システムの1つ以上の部分での一時的な障害によって発生する予期しないエラーです。<br>関数リクエスタはリクエストを再試行できます。<br>注意： <strong>HTTP 5xx エラーはシステムエラーと見なされます</strong>.</p> |
| F      | 機能エラー      | <p>これは確定的なエラーです。処理を中止してください。再試行しないでください。<br>トークンはもはや使用できず、削除する必要があります。</p>                                                    |

#### エラー <a href="#errors" id="errors"></a>

以下の表は発生し得るエラーを列挙しています。

フローによって、エラーはレスポンス内で同期的に返される場合と、コールバックで非同期的に返される場合があります。

| エラーコード | コードタイプ | 説明                                                                                                                          |
| ------ | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| 111    | D      | 必須パラメータが欠落している                                                                                                              |
| 112    | D      | パラメータの形式が不正                                                                                                                 |
| 113    | D      | 不明なイシュア                                                                                                                     |
| 114    | D      | 不明なエンドユーザー                                                                                                                  |
| 115    | D      | 不明なプロダクト                                                                                                                    |
| 116    | D      | 不明なカード                                                                                                                      |
| 117    | D      | 不明なトークンストレージ                                                                                                                |
| 118    | D      | 不明なリクエスト                                                                                                                    |
| 119    | D      | 不明なバーチャルカード                                                                                                                 |
| 158    | D      | 無効なパラメータ：カードの有効期限切れ                                                                                                         |
| 159    | D      | 無効なパラメータ：カードが一時停止されている                                                                                                      |
| 160    | D      | 無効なパラメータ：カードが取り消されるか削除されている                                                                                                 |
| 161    | D      | <p>認証値が正しくありません。</p><ul><li>カードセキュリティコード（CSC）が正しくない</li><li>無効な暗号ワンタイムパスワード（OTP）</li></ul>                                  |
| 163    | D      | モバイル決済でサポートされていないプロダクト                                                                                                      |
| 164    | D      | FPANプロビジョニング回数超過                                                                                                            |
| 166    | D      | 無効なカード情報（FPAN、有効期限）またはカードが適格でない                                                                                             |
| 167    | D      | カードは既に登録済み                                                                                                                  |
| 168    | D      | エンドユーザーに紐付く電話番号がない                                                                                                          |
| 221    | S      | 再試行後もデバイスまたはウォレットプロバイダにアクセスできない                                                                                             |
| 222    | S      | デバイスまたはウォレットプロバイダがビジー状態                                                                                                     |
| 231    | F      | デバイスからの予期しないエラー                                                                                                             |
| 232    | F      | 操作を実行するためのデバイスのメモリが不足している                                                                                                   |
| 321    | S      | トークンに対する操作が既に進行中である                                                                                                         |
| 322    | S      | 操作の有効期限（タイムトゥリブ）が切れた                                                                                                        |
| 323    | S      | 操作が部分的に完了した（通常、操作が複数のバーチャルカードを対象とし、そのうちの1つが失敗した場合）                                                                          |
| 421    | S      | OTPまたはPINがロックされている（リトライ上限超過）                                                                                                |
| 422    | S      | OTPの有効期限が切れた                                                                                                                |
| 431    | F      | 無効なパーソナライゼーションデータ                                                                                                           |
| 432    | F      | 現在のトークン/カードの状態がこの操作を許可していない                                                                                                 |
| 501    | D      | ID\&VメソッドIDが無効である                                                                                                           |
| 502    | D      | OTPを送信するための通信チャネルが利用できない                                                                                                    |
| 503    | D      | <p>エンドユーザーが選択したID\&Vメソッドは <strong>もはや</strong> 有効ではありません。<br>これは、登録中にチャネルデータ（例：電話番号）がID\&Vプロセスに対して無効になった場合に発生することがあります。</p> |
| 510    | F      | ステップアップのカード所有者認証が拒否された（Visa CTFのみ）                                                                                          |
| 520    | F      | ステップアップのカード所有者認証に失敗した（Visa CTFのみ）                                                                                           |
| 521    | S      | プッシュサーバーエラー                                                                                                                 |
| 531    | F      | プッシュトークンがもはや有効でない                                                                                                           |
| 911    | F      | 操作に失敗した                                                                                                                     |
| 920    | F      | OTP生成回数の上限を超えた                                                                                                              |
| 921    | S      | 予期しないサーバーエラー                                                                                                                |


---

# 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/classic-tokenization/ja/meru/apino/apigaidorain.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.