> 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/ji-ben-gai-nian.md).

# 基本概念

## 開発 <a href="#development" id="development"></a>

リクエストを送受信するには、イシュアのバックエンドがインバウンドおよびアウトバウンドの実装を行う必要があります [イシュアゲートウェイAPI](/classic-tokenization/ja/apirifarensu/ishuagtoweiapi.md).

イシュアのバックエンドはPKCS#7のアプリケーションレベル暗号化に対応している必要があります。PANや有効期限などの機微データを保護するために使用してください。詳細は次に説明されています [データ暗号化とセキュリティ](/classic-tokenization/ja/meru/apino/dtatosekyuriti.md).

サンドボックス環境の構成からこれらの鍵を使用してください：

* Thalesの公開鍵。Thalesに送信する機微データを暗号化します。
* サンドボックスの秘密鍵。Thalesから受信した機微データを復号します。

本番環境では、イシュアが秘密鍵を生成して保管します。イシュア証明書を本番構成ポータルでThalesに提供してください。

## 用語集とデータモデル <a href="#glossary-and-data-model" id="glossary-and-data-model"></a>

以下の図と表は、イシュアゲートウェイAPIを通じて交換される主要な識別子について説明しています。

<figure><img src="/files/bf3fe89094665d4227c5625c8a6d2e536b29377e" alt=""><figcaption></figcaption></figure>

| イシュアゲートウェイAPIパラメータ  | 説明                                                                                                                                                                                                                                                                                                                |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| issuerCardRefId     | <ul><li>を識別します <strong>FPAN</strong> イシュアのバックエンド内の。</li><li>カードレベルのユースケースについて、将来のイシュアゲートウェイAPI呼び出しでこの識別子を使用してください。</li><li>PANが置き換えられた場合（例えば、カードの交換や更新）にはこの識別子を更新してください。</li></ul>                                                                                                                                |
| virtualCardId       | トークンの一意の識別子。                                                                                                                                                                                                                                                                                                      |
| walletCardRefId     | <ul><li>ウォレットプロバイダによって参照されるカードを識別します。</li><li>今後のウォレットプロバイダとThales間のAPI呼び出しでこの識別子を使用してください。</li><li>コーベッディングの場合、決済ネットワークがこの識別子を生成することがあります。</li><li>この値をにマップしてください <code>walletCardRefId</code> イシュアゲートウェイAPIでイシュアのバックエンドに送信します。</li><li>この値をにマップしてください <code>cardRefId</code> TSP APIでにマップし、TSPに送信します。</li></ul> |
| walletVirtualCardId | <p>トークンPAN（<strong>DPAN</strong>）。将来のウォレットプロバイダとThales間のAPI呼び出しでこの識別子を使用してください。<br><br>コーベッディングの場合、決済ネットワークは主トークンのためにこの識別子を生成します。Thalesは補助トークンのためにそれを生成します。</p>                                                                                                                                                   |
| tokenStorageId      | <p>デバイス上のトークン保管場所を識別します：</p><ul><li>セキュアエレメントベースのデバイスのためのセキュアエレメントID。</li><li>のためのアプリケーションインスタンスID <strong>HCE</strong>ベースのアプリケーション。</li></ul><p>この値をイシュアゲートウェイAPIを通じてイシュアのバックエンドと共有します（ <code>tokenStorageId</code>.</p>                                                                                         |

## カードのデジタル化 <a href="#card-digitization" id="card-digitization"></a>

カードのデジタル化は、物理カードをトークンに変換します。トークンはデジタルカードを表します。これはカード登録とも呼ばれます。

このプロセスには主に4つの関係者が関与します：

* カードをデジタル化したいエンドユーザ。
* 決済ネットワークに接続されたウォレットプロバイダ。
* トークンを発行するTSP（トークンサービスプロバイダ）。
* カード口座を保有するイシュア。

Thales **TIG** もフローに参加します。TIGは決済ネットワークとイシュアのバックエンドの間のゲートウェイとして機能します。イシュアゲートウェイAPIを公開し、決済ネットワークのAPIを抽象化します。

各カード登録にはイシュアの判断が必要です。イシュアは次のことができます：

* 追加の認証なしでリクエストを受け入れる。
* （識別と検証）を使用したステップアップ認証でリクエストを受け入れる。 **ID\&V** （識別と検証）。
* リクエストを拒否する。

下の図は基本的なカードのデジタル化フローを示しています。

<figure><img src="/files/4a921ec91818a976e04c6f0e0fe49723f3defb05" alt=""><figcaption></figcaption></figure>

各フローには“色”があります。これはウォレットプロバイダの推奨とイシュアの判断を表します。

エンドツーエンドのフローについては、次を参照してください [ユースケース](/classic-tokenization/ja/ysuksu/kdo.md).

## フローの色 <a href="#what-is-flow-colors" id="what-is-flow-colors"></a>

ウォレットプロバイダと決済ネットワークに応じて、ウォレットプロバイダは次の推奨を送信できます：

* デジタル化する（緑）
* ステップアップ認証でデジタル化する（黄色）
* 不正の疑いでデジタル化する（オレンジ）

この推奨とリスクスコアに基づいて、イシュアは次の判断で応答します：

* デジタル化する（緑）
* ステップアップ認証でデジタル化する（黄色）
* 登録を停止する（赤）

イシュアゲートウェイAPIはパラメータを使用して色を管理します `levelOfTrust` 。このパラメータはカードのデジタル化APIリクエスト（ウォレットプロバイダ）とレスポンス（イシュア）に存在します。以下のセクションでは一般的なケースを説明します。

### ウォレットプロバイダからの推奨 <a href="#recommendation-from-the-wallet" id="recommendation-from-the-wallet"></a>

#### 緑 <a href="#green" id="green"></a>

* エンドユーザを信頼することを推奨します（例：Card-on-file（COF）やデバイスのペアリング）。イシュアは通常リクエストを信頼できます。

#### 黄色 <a href="#yellow" id="yellow"></a>

* エンドユーザを認証するためにID＆Vフローを使用することを推奨します。イシュアはID＆Vを要求するべきです。

#### オレンジ <a href="#orange" id="orange"></a>

* 不正の疑いやデバイスの整合性の問題（例：ルート化されたデバイス）を示します。イシュアはリクエストを拒否するか、ID＆Vを要求することができます（例：カスタマーサービス経由）。

### イシュアからの判断 <a href="#decisions-from-the-issuer" id="decisions-from-the-issuer"></a>

イシュアはウォレットプロバイダの推奨とスコア情報を受け取ります。イシュアはそれから独自のを返します。 `levelOfTrust`。以下のケースが一般的です：

#### 緑 <a href="#green-1" id="green-1"></a>

* リクエストを信頼し、追加の検証を要求しない。ID＆Vフローはトリガーされません。

#### 黄色 <a href="#yellow-1" id="yellow-1"></a>

* 追加の検証を要求する。リクエストに信頼シグナルが欠けている場合に使用します。例：CVVが欠落している、または黄色の推奨。イシュアはサポートされるID＆V方法を返します。

#### 赤 <a href="#red" id="red"></a>

* リクエストを拒否する。シグナルが高リスクを示す場合に使用します。例：無効なCVV、繰り返しのCVV失敗、またはオレンジの推奨。


---

# 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/classic-tokenization/ja/meru/ji-ben-gai-nian.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.