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

概要

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

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

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

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

• Green：ステップアップ認証なしでトークン化を承認します。

• Yellow：ステップアップ認証ありでトークン化を承認します（ID&V).

• Red：トークン化を拒否します。

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

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

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

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

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

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

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

wallet ペイロードフィールド

フィールド	スキームのサポート	型	説明
recommendedFlow	Mastercard	列挙型： Green, Yellow, Orange	ウォレットのスコアリングに基づくデジタルウォレットの推奨。
reasonCodes	Mastercard	文字列の配列	説明するコードの一覧 recommendedFlow.
deviceScore	Mastercard、Visa	整数	デバイスの信頼レベルを示すデジタルウォレットスコア。以下を参照してください スコアの定義.
accountScore	Mastercard、Visa	整数（1 ～ 5)	アカウントの信頼レベルを示すデジタルウォレットスコア。以下を参照してください スコアの定義.
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 の値を説明します。

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

reasonCodes および recommendedFlow はMastercard（MDES).

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パスフラグが設定されています。