> 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/nfc-wallet/ja/nfcworetto-bakkuendo/kdo/tkunwo-1/noworettodtawo.md).

# 追加のウォレットデータを提供

## 概要

デジタルウォレットは、登録時に追加データを提供できます。

このデータは、その後、イシュアのバックエンドに送信されるTSPトークン化承認リクエストに含まれます。

イシュアのバックエンドは、このデータを他のシグナルと組み合わせてリスクスコアリングを精緻化し、最終的なトークン化の判断を行うことができます。

イシュアによるトークン化の判断は、次のいずれかです。

* **Green**：ステップアップ認証なしでトークン化を承認します。
* **Yellow**：ステップアップ認証ありでトークン化を承認します（**ID\&V**).
* **Red**：トークン化を拒否します。

追加のウォレットデータを `wallet` 認証トークンペイロードのオブジェクトに含めます。

このページでは、サポートされている `wallet` ペイロード形式について説明します。

## ウォレットペイロード形式

この `wallet` ペイロードはJSONを使用します。

以下の表は、サポートされているフィールドを要約したものです。

すべてのフィールドは任意です。

{% hint style="warning" %}
一部の `wallet` フィールドは、すべての決済ネットワークTSPで転送されるわけではありません。イシュアのバックエンドがそれらを受信しない場合があります。
{% endhint %}

### `wallet` ペイロードフィールド

| フィールド                      | スキームのサポート       | 型                                | 説明                                                                                               |
| -------------------------- | --------------- | -------------------------------- | ------------------------------------------------------------------------------------------------ |
| `recommendedFlow`          | Mastercard      | 列挙型： `Green`, `Yellow`, `Orange` | ウォレットのスコアリングに基づくデジタルウォレットの推奨。                                                                    |
| `reasonCodes`              | Mastercard      | 文字列の配列                           | 説明するコードの一覧 `recommendedFlow`.                                                                    |
| `deviceScore`              | Mastercard、Visa | 整数                               | デバイスの信頼レベルを示すデジタルウォレットスコア。以下を参照してください [スコアの定義](#score-definition).                               |
| `accountScore`             | Mastercard、Visa | 整数（`1` ～ `5`)                    | アカウントの信頼レベルを示すデジタルウォレットスコア。以下を参照してください [スコアの定義](#score-definition).                              |
| `fourLastDigitPhoneNumber` | Mastercard、Visa | 文字列（`1` ～ `4` 桁）                 | エンドユーザーの電話番号の下4桁。                                                                                |
| `accountIdHash`            | Mastercard      | 文字列、最大48文字                       | トークンリクエスタにおけるエンドユーザーのアカウントIDの、Base64エンコードされたSHA-256ハッシュ。値がメールアドレスである場合は、 `emailHash` を代わりに使用します。 |
| `emailHash`                | Mastercard、Visa | 文字列、最大48文字                       | メールアドレスの、Base64エンコードされたSHA-256ハッシュ。                                                              |

### スコアの定義

スコアは次の範囲の整数です `1` ～ `5`.

これはアカウント（`accountScore`）またはデバイス（`deviceScore`):

* `1` を示します **高リスク**
* `2` を示します **リスクあり**
* `3` を示します **中立**
* `4` を示します **信頼済み**
* `5` を示します **高度に信頼済み**

### 理由コード

この `reasonCodes` フィールドは、 `recommendedFlow` の値を説明します。

デジタルウォレットは複数の理由コードを提供できます。

{% hint style="warning" %}
`reasonCodes` および `recommendedFlow` はMastercard（`MDES`).
{% endhint %}

#### **Green推奨の理由コード**

| コード | 説明                                                                                                                                                                                  |
| --- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A3  | アカウントが少なくとも1年間存在していること。トークンリクエスタは、より長い継続期間を要求できます。                                                                                                                                  |
| A4  | 少なくとも6か月間、アカウントに金融活動が存在すること。少なくとも1年間、疑わしい活動がそのアカウントに関連付けられていないこと。                                                                                                                   |
| A5  | 同じアカウントPANおよび消費者アカウントに対する追加デバイスについて、デジタル化が要求されています。同じアカウントPANおよび消費者アカウントについて、別のデバイス上ですでにトークンが有効であり、かつ停止されていない必要があります。                                                               |
| A6  | 認証済みのオペレーティングシステムまたはソフトウェアアップデートによってモバイル決済データが消去され、復旧できなくなった後に、デジタル化が要求されています。リクエストでは、同じ `paymentAppInstanceId` を、同じアカウントPANおよび消費者アカウントに対して以前にデジタル化され有効化されたトークンと同じものとして使用する必要があります。 |

#### **Yellow推奨の理由コード**

| コード | 説明                                                  |
| --- | --------------------------------------------------- |
| 01  | ウォレットアカウントIDが、開始時期と比較して新しすぎます。                      |
| 02  | ウォレットアカウントIDが、プロビジョニングリクエストと比較して新しすぎます。             |
| 03  | ウォレットアカウントIDとカードの組み合わせが、しきい値日付より新しいです。              |
| 04  | しきい値期間内にアカウントデータが変更されました。                           |
| 05  | 疑わしい取引がこのアカウントに関連付けられています。                          |
| 06  | このアカウントは過去1年間アクティビティがありません。                         |
| 07  | セキュアエレメント内のカードは停止されています。                            |
| 08  | このデバイスは過去7日間に、しきい値を超える時間、紛失モードに入りました。               |
| 09  | このデバイスで72時間以内に行われたプロビジョニング試行回数がしきい値を超えています。         |
| 0A  | 24時間以内に、この電話でしきい値を超える数の異なるカードが試行されました。              |
| 0B  | プロビジョニングリクエストに、許容しきい値を超える異なる名前が含まれています。             |
| 0C  | デバイススコアが3未満です。                                      |
| 0D  | アカウントスコアが4未満です。                                     |
| 0E  | デバイスのプロビジョニング場所が、OEMマーケットプレイスの本国の外です。               |
| 0F  | 現時点ではモデルルールを利用できません。たとえば、バックエンドシステムがタイムアウトした場合などです。 |
| 0G  | Orangeパスフラグが設定されています。                               |


---

# 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/nfc-wallet/ja/nfcworetto-bakkuendo/kdo/tkunwo-1/noworettodtawo.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.