カード認証情報を取得

概要

カード登録をサポートするには、デジタルウォレットアプリケーションが最初にカード情報を取得する必要があります。

カード情報は次のいずれかから提供できます:

• デジタルウォレットのバックエンド。たとえば、デジタルウォレットアプリケーションがイシュアアプリケーションである場合です。
• エンドユーザー入力。たとえば、複数のイシュアのカードをサポートするオープンウォレットでの手動入力またはカメラスキャンです。

カード情報は機密情報です。NFC Wallet SDK を使用してカード登録を開始する前に、それらを暗号化してください。

次へ:

• 確認 暗号化要件 を確認して、サポートされている暗号化形式を確かめます。
• 参照 カード情報ペイロード を参照して、暗号化前にカード情報ペイロードを形式化します。

参照 トークン情報ペイロード トークンからトークンへの登録をサポートする場合。

要件

暗号化要件

カード情報は、RFC 2315 および RFC 5652 で定義された PKCS#7 暗号化形式を使用します。

次の暗号化基準を使用してください:

• コンテンツ暗号化アルゴリズム: AES256/CBC/PKCS7Padding
• 鍵暗号化アルゴリズム: RSA イシュアの公開鍵長が 2048 ビットであること

カードペイロードは有効な JSON であり、以下に示すフィールドを含める必要があります。

暗号化結果を Base64 エンコードします。

カード情報ペイロード

カード登録をサポートするには、次の暗号化済みペイロードを提供してください。

JSON フィールド	説明	要件	長さ
fpan	デジタル化する資金供給 PAN。	必須	16-20
exp	カードの有効期限 MMYY 形式。	必須	4
cvv	カードセキュリティコード。イシュアが必要とする場合のみ指定してください。	条件付き	3-4
name	カード上の氏名。Mastercard (MDES) では、 姓/名 または 名 姓を使用します。Visa (VTS) では、カードに印字されているフルネームを使用します。	任意	27
billingAddress	エンドユーザーの請求先住所。以下の定義を参照してください。	任意	-
nonce	グリーン登録でのみ使用される一時的な値。これを提供する場合は、認証トークン内の nonce の SHA-256 ハッシュも提供してください。使用可能な文字: 0-9, A-Z, a-z, -, _.	任意	1-50

請求先住所ペイロード

以下の表は、請求先住所を提供する場合にサポートされる JSON フィールドを説明しています。

JSON フィールド	説明	要件	長さ
line1	エンドユーザーの住所の 1 行目。	任意	1-64
line2	エンドユーザーの住所の 2 行目。	任意	1-64
city	エンドユーザーの住所の市区町村。	任意	1-34
state	ISO 3166-2 形式の州または都道府県コード。	任意	1-6
country	ISO 3166-1 alpha-2 形式の国コード。例: FR.	任意	2
postalCode	郵便番号。	任意	1-16

トークン情報ペイロード

トークンからトークンへの登録をサポートするには、次の暗号化済みペイロードを提供してください。

JSON フィールド	説明	要件	長さ
scheme	カードスキーム。サポートされている値: VISA, MASTERCARD.	必須	-
issuerId	イシュアの一意識別子。	必須	10
cardProductId	同じスキームに対してイシュアが複数のカード製品をサポートしている場合に必須のカード製品 ID。	条件付き	1-48
dpan	Visa のトークンからトークンへの登録のためにデジタル化する元のトークンの DPAN。	任意	16-20
cvv	元のトークンに関連付けられた資金供給カードの CVV。Visa の場合に指定してください。その使用はプロジェクトに依存し、Visa 担当者と定義する必要があります。	任意	3-4
digitalCardId	TSP によって定義された、元のトークンのデジタルカード ID。Mastercard では、このフィールドは必須です。Visa では、このフィールドは任意です。MDES API では、これは tokenUniqueReferenceに対応します。VTS API では、これは vProvisionedTokenIDに対応します。Visa では、トークンリクエスタは digitalCardId, dpan、またはその両方を提供できます。	条件付き	1-64
digitalCardRequestorId	元のトークンのデジタルカードリクエスタ ID。この値は TSP が定義します。	任意	1-11
nonce	認証トークンがウォレットスコアリングの定義に提供される場合にのみ使用される一時的な値。これを提供する場合は、次の SHA-256 ハッシュも提供してください。 nonce の SHA-256 ハッシュも提供してください。使用可能な文字: 0-9, A-Z, a-z, -, _.	任意	1-50