> 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/apipurotokoru.md).

# APIプロトコル

### プロトコルとメッセージ形式 <a href="#protocol-and-message-format" id="protocol-and-message-format"></a>

イシュアゲートウェイAPIはRPCスタイルのAPIです。各メソッドはHTTPエンドポイントに対応します。リクエストとレスポンスはJSONペイロードを使用します。

A `200 OK` HTTPステータスはリクエストが成功したことを意味します。

### Swaggerファイル <a href="#swagger-files" id="swagger-files"></a>

トークナイゼーションサービスAPI（イシュアゲートウェイAPI）はSwagger（OpenAPI）定義として利用可能です。クライアントコードを生成したり、リクエストを検証するために使用してください。

OpenAPI定義をダウンロード：

* [インバウンド（イシュアバックエンド → トークナイゼーションサービス）](/classic-tokenization/ja/apirifarensu/ishuagtoweiapi/inbaundoishuakara.md)
* [アウトバウンド（トークナイゼーションサービス → イシュアバックエンド）](/classic-tokenization/ja/apirifarensu/ishuagtoweiapi/autobaundoishua.md)

### API概要 <a href="#api-overview" id="api-overview"></a>

APIにはインバウンドとアウトバウンドのエンドポイントがあります：

* **アウトバウンド**：トークナイゼーションサービスが **イシュアバックエンド**.
* **インバウンド**： **イシュアバックエンド** がトークナイゼーションサービスを呼び出します。

**アウトバウンド**

| THALES から イシュアへのリクエスト     | 説明                                                                                                            |
| ------------------------- | ------------------------------------------------------------------------------------------------------------- |
| NotifyVirtualCardChange   | このリクエストはトークナイゼーションサービスがトークンの状態の変更をイシュアバックエンドに通知するために使用します。                                                    |
| RequestCardDigitalization | このリクエストはトークナイゼーションサービスが資金用カードのデジタル化に対するイシュアバックエンドの同意を求めるために使用します。                                             |
| CheckCardEligibility      | このリクエストはトークナイゼーションサービスが資金用カードがトークナイゼーションの対象となるかどうかを確認するために使用します。                                              |
| SendOTP                   | このリクエストはトークナイゼーションサービスがステップアップ認証のために決済ネットワークが生成したOTPを送信するために使用します。イシュアバックエンドは選択された方法でエンドユーザーにOTPを送信する必要があります。 |

**インバウンド**

| イシュアから THALES へのリクエスト | 説明                                                                                            |
| --------------------- | --------------------------------------------------------------------------------------------- |
| UpdateCard            | <p>このリクエストはイシュアバックエンドがカード情報を更新するために使用します。例えば：<br>- 資金用カードのPANと有効期限（カード更新時）<br>- カードプロファイル</p> |
| UpdateCardState       | このリクエストはイシュアバックエンドがカードまたはトークンの状態更新を要求するために使用します。                                              |
| GetCardInfo           | このリクエストはイシュアバックエンドが特定の資金用カードに対して発行されたトークン情報を取得するために使用します。                                     |
| SendMessage           | Apple Pay限定。このリクエストはイシュアバックエンドがウォレットアプリ内のエンドユーザーにテキストメッセージを送信するために使用します。                      |

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

イシュアゲートウェイAPIはほとんどの操作でステートフルです。イシュアバックエンドはトークナイゼーションサービスのリクエストを正しく処理するためにセッション状態を管理する必要があります。

*登録（Enrollment）*

* 複数のAPIコールを使用します。
* 各ステップで返される必要な情報を保存してください。
* 次を使用してください `x-correlation-id` ヘッダーを使用して同じセッションからのすべてのリクエストを相関させてください。

*LCM（ライフサイクル管理）*

* 完了および未完了のシナリオを管理するためにトークナイゼーションサービスに依存してください。
* 次を使用してください `x-correlation-id` ヘッダーを使用して同じセッションからのすべてのリクエストを相関させてください。

<br>


---

# 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/apipurotokoru.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.