> 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/kdowo-1.md). # カード認証情報を取得 ## 概要 カード登録をサポートするには、デジタルウォレットアプリケーションが最初にカード情報を取得する必要があります。 カード情報は次のいずれかから提供できます: * **デジタルウォレットのバックエンド**。たとえば、デジタルウォレットアプリケーションがイシュアアプリケーションである場合です。 * **エンドユーザー入力**。たとえば、複数のイシュアのカードをサポートするオープンウォレットでの手動入力またはカメラスキャンです。 カード情報は機密情報です。NFC Wallet SDK を使用してカード登録を開始する前に、それらを暗号化してください。 次へ: * 確認 [暗号化要件](/nfc-wallet/ja/nfcworetto-bakkuendo/kdo/kdowo-1.md#encryption-requirements) を確認して、サポートされている暗号化形式を確かめます。 * 参照 [カード情報ペイロード](/nfc-wallet/ja/nfcworetto-bakkuendo/kdo/kdowo-1.md#card-information-payload) を参照して、暗号化前にカード情報ペイロードを形式化します。 {% hint style="info" %} 参照 [トークン情報ペイロード](/nfc-wallet/ja/nfcworetto-bakkuendo/kdo/kdowo-1.md#token-information-payload) トークンからトークンへの登録をサポートする場合。 {% endhint %} ## 要件 ### 暗号化要件 カード情報は、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 | --- # 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/kdowo-1.md?ask=&goal= ``` `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.