> 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/ysuksu/kdo/fur/suteppu1-kdowosuru/sukmunorii.md). # 国内スキームの取り扱い このセクションは次の場合にのみ使用してください： * トークナイゼーションサービスが国内スキームまたはプライベートラベルのTSPブローカーとして機能する場合。 * 次のいずれかのxPayウォレットを有効にしている場合：Apple Pay、Google Pay、または Samsung Pay。 プッシュプロビジョニングでは、イシュアアプリケーションがペイロードを準備します。イシュアアプリケーションはそれをトークンリクエスタ（ウォレットプロバイダ）を通じてトークナイゼーションサービスに渡します。 このペイロードは次と呼ばれます **App2App登録データ** （CryptoOTP）。これは2つの部分から構成されます： * **ファンディングカードデータ** トークン化するための詳細（PAN、有効期限など）を含むデータ。 * **認証値** 追加のセキュリティ証明を含むデータ。 認証値には2つの実装オプションがあります：

認証値検証のオプション。

* **オプション1（推奨）：トークナイゼーションサービスが認証値を検証します。** * 認証値はThalesフォーマットに従う必要があります。 * **オプション2：イシュアのバックエンドが認証値を検証します。** * 認証値のフォーマットはイシュア依存です。 ### App2App登録データ（JWE） {% hint style="info" %} このセクションはSamsung PayおよびGoogle Payにのみ適用されます。 {% endhint %} App2App登録データはRFC 7516で定義されたJWE（JSON Web Encryption）であり、次のプロパティを持ちます： * コンパクトシリアライゼーションを使用してください。 * 鍵タイプ：RSA 2048ビットまたは4096ビット。 * アルゴリズム： * 鍵暗号化： `RSA1_5` （非推奨）または `RSA-OAEP-256` * コンテンツ暗号化： `A256GCM` | JWEヘッダー | 説明 | 値 | MOC | | --------------- | -------------------------------------------------------------------------------------------------------------- | ------------------------------- | --- | | alg | コンテンツ暗号化鍵（CEK）を暗号化するために使用される暗号アルゴリズム。 | 「RSA1\_5」（非推奨）または「RSA-OAEP-256」 | M | | enc | 平文に対して認証付き暗号化を実行して暗号文と認証タグを生成するために使用されるコンテンツ暗号化アルゴリズム。 | 「A256GCM」 | M | | kid | 鍵暗号化に使用されるRSA鍵の識別子。オンボーディング時に定義されます。Thalesがイシュアに提供します。 | 文字列 | O | | x-gto-issuerid | オンボーディング時に定義されたカスタムJWEヘッダーを含む `issuerId` オンボーディング時に定義されます。 | 文字列 | M | | x-gto-productid |

オンボーディング時に定義されたカスタムJWEヘッダーを含む productId オンボーディング時に定義されます。

その存在はあなたのオンボーディング構成に依存します。

| 文字列 | O | JWEヘッダーの例： ```json { "alg":"RSA1_5", "enc":"A256GCM", "kid":"key_123", "x-gto-issuerid":"IssuerABC", "x-gto-productid":"Product123" } ``` | JWE平文 | 説明 | TYPE | MOC | | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ---- | -------------------------------- | | fpan | トークン化するファンディングカードのFPAN。 | 文字列 | M | | exp | 有効期限の形式： `MMYY` 形式。 | 文字列 | O | | issuerCardLastDigits | ウォレットに表示するファンディングカードの末尾桁。 | 文字列 | O | | authvalue |

2つのオプション：

  1. トークナイゼーションサービスによって検証されるThalesフォーマット
  2. イシュアのバックエンドに渡される不透明な識別子（ requestCardDigitization operation
| 文字列 | C（補助フローまたはApple Payのフォーマット3には不要） | JWE平文の例： ```json { "fpan":"3450163332324735", "authvalue":"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJCYW5jb21hdEkxIiwic3ViIjoiYzQxZTdiZmQ3MWQ3ZiIsImV4cCI6MTUzMTgyOTUyNiwiaWF0IjoxNTMxODI1OTI2LCJwcm9kdWN0SWQiOiJCYW5jb21hdF9QVVJFIn0.Pjv-rS6s2O8I5IXSKi8eBxwhIDquUUYEegDQzqWqQjxAfYyQlJ7fNAt33p7cFhbWSuEVHowyy0xkYOorqZHC3TaAGMqB-pcU5KrwtGkXKUPPzdTOfUnZ8qmg1opiN1PfgCOHF0jja61QmAjcMPEHRSrTeK7EUogA-WM7ozSn6BAX0nTDb4dICr9bpksVKvB53DG5GTqTV00cX4EjSP_QuuiUpAvuiZFRcWaDzGzTECB8DptcOUmaHhuuuHIgPng5DNJeMtPvPqEmCNdSpMJ7eq-kg0RWsHmkbNpgVpk2pLm8AB_MPoq0wZ7hs660qnnU9d-9AG28VQrASsvkBolHZg", "exp":"0221" } ``` 完全なJWEの例： ``` eyJhbGciOiJSU0ExXzUiLCJlbmMiOiJBMjU2R0NNIiwieC1ndG8tcHJvZHVjdGlkIjoiQmFuY29tYXRfUFVSRSIsIngtZ3RvLWlzc3VlcmlkIjoiQmFuY29tYXRJMSJ9.m0WJhih-DYQOFJBHHvJGyuMcFYMsUTeEFkfRB1YOgODMNzZoYDhyhnx2kNQWr382Zw8qc-QmhGGnrhVw5EVoffpS5CSF5JP4Y1aSffssTFTeYtGGrVWF4GWSvQGCBZs9fEJMT9SpKpCLbVl7LJXJ5oHbsFu_MG9jkYZFvyyVVJ6xq97iQE6Co8zEYD5uPrQXX7jJlqqGX1VhA_Bs1aklTgaPYvt-mpYauPl8qIKSFL2w2yJZ3LwQxffuQxCMc6aaAu5k0VWPGtez7zimRd044n5WqErUfguSTxVOLhODpB0HanOwq7YVqeE40TqOtzzgWENzNm2KSraXjXUHuL5smg.z3nyT9uJ30YRNarp.Tt3avmBS0_Svg0yxG-yq0WLJ6BZn7xEtOcYHg0465T_TAP-3tKbCsDe5RG-kGADHB6oHy-oJa1YYn3nybkBl9SVsBWBPTJ9f1gPJvtY4jLkbq7nolTr3XjvK9ljtdE2G0IbcCZ4s7pLoQHf459AxilP8U-M3R3SEayMRsJocJQOlhVBLz6rTMgKEwAV52mtPccOTPpwL351fX4ssCG4oeTcM_gB7kDMuYgHLBmCW3XCKkRg7QLBybPP7TNhBy78JHcZe8DZ3mNHfL8tFEntnEYEGAWWHUQKm3H8qYoIlEVGqAz9j-UpDfyok8wohm5RxblH0NWMitarPjH01MNouMvomfM5FCaze7PErNNoaAw5Mp5I2h0QeEI3sJJkAkbzDq0R0UEbheNbhFdm3h10qSZ-mnJCp8ju1dcneOFxxlGwCQFO13EnDKFLuj4Qvnm9ARdIoQJiqWl4M8deiRPq2jrksrlEnavyADTnr4Dj1J56KS-eI8QIlSZEMqzGKZ6LsxLkEQE7Jy9-RW1-VctBczTJvdUpk-41IxrJdeGUV8UQPQGGwZ9CCa_2gmxjxByEL0UtO0mzno8UBUaI-Rmho7xvOjHLm73fkk2OeXJzNVgbNo4f5IrEW-e6GKAMhsBudcw2upSh0u2Cew8ruvPKzfu3JNSdSUaQv8lO_Yc6yH8x4UxqsylO1hsGaEpIogkTqnMWfTJHDTkK0VVwuoDye48aOhDWv8XWIsiyMIyFp0bEDCkfKQpDCXaANUhXgqQ.fewcSD5vzA5ICFBT_XBISg ``` ### 認証値（Thalesフォーマット）（JWT） {% hint style="info" %} このセクションはApple Pay、Samsung Pay、およびGoogle Payにのみ適用されます。 {% endhint %} 認証値はRFC 7519で定義されたJWT（JSON Web Token）であり、次のプロパティを持ちます： * 鍵タイプ：RSA 2048ビットまたは4096ビット。 | JWTヘッダー | 説明 | 値 | MOC | | ------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------ | --- | | typ | 完全なJWTのメディアタイプ。 | 「JWT」 | M | | alg | JWTで使用されるアルゴリズム。 |

サポートされているアルゴリズム：

| M | | kid | JWTに署名するために使用される鍵の識別子。オンボーディング時に定義されます。イシュアがThalesに提供します。 | 文字列 | O | 例： ```json { "typ":"JWT", "alg":"RS256", "kid":"key_456" } ``` | JWTクレーム | 説明 | 値 | MOC | | -------------- | ------------------------------------------------------------------------------------------ | --- | ----------------- | | iss | オンボーディング時に割り当てられる一意のイシュア識別子。 | 文字列 | M | | sub | その `issuerCardRefId` イシュアによって定義されます。 | 文字列 | M | | iat | RFC 7519で定義されるトークン作成日時。 | int | M | | exp | RFC 7519で定義されるトークンの有効期限。 | int | M | | productId | オンボーディング時に定義されたカードプロダクト識別子。 | 文字列 | O | | nonce | Apple Payで使用されるプライベートクレーム。これは `nonce` 値であり、イシュアアプリケーションがiOSのPassKit SDKを通じて取得します。 | 文字列 | C（Apple Payのみに適用） | | nonceSignature | Apple Payで使用されるプライベートクレーム。これは `nonceSignature` 値であり、イシュアアプリケーションがiOSのPassKit SDKを通じて取得します。 | 文字列 | C（Apple Payのみに適用） | 例： {% tabs %} {% tab title="基本クレーム" %} ```json { "iat":1456815010, "exp":1456851010, "iss":"IssuerABC", "sub":"11111", "productId":"Product123" } ``` {% endtab %} {% tab title="Apple Payクレーム" %} ```json { "iat":1456815010, "exp":1456851010, "iss":"acmeBank", "sub":"111111", "nonce":"iYWNtZUJhbmsiLCJzdWIiOiIxMTExMTEifQ.WIo8cL1d71CZuxQ", "nonceSignature":"aXNzIjoiYWNtZUJhbmsiLCJzdWIiOiIxMTExMTEifQ.WIo8cL1d71CZuxQZ2re2TnBuRfQy-6p_OowGuaN9Hp1SMSY01BN-hl1q7TI67WdP5Vz2Em6BXzOdE1I1anPzoLeJXQW-y8UVWOMQN3hLn6hYoNDYye0Y3m-_jsOIJ7a7yr33ODKmgq4ieQoceeaZNpMEGeZr1X3G2a3iS-1tP9515qgcp-UoM9TjrP5kvP1cTjVG7djsb1UNlPwbnXdMRh8cxHa4bYqZ8fJYqcMcUVLLc08C9ejNwn2lL3eX2tU9Ofkrs2sf44stDxhwSLRP3I3x15_rEMeW6FtvN83_ecmROcI" } ``` {% endtab %} {% endtabs %} 完全なJWTの例： ``` eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJCYW5jb21hdEkxIiwic3ViIjoiYzQxZTdiZmQ3MWQ3ZiIsImV4cCI6MTUzMTgyOTUyNiwiaWF0IjoxNTMxODI1OTI2LCJwcm9kdWN0SWQiOiJCYW5jb21hdF9QVVJFIn0.Pjv-rS6s2O8I5IXSKi8eBxwhIDquUUYEegDQzqWqQjxAfYyQlJ7fNAt33p7cFhbWSuEVHowyy0xkYOorqZHC3TaAGMqB-pcU5KrwtGkXKUPPzdTOfUnZ8qmg1opiN1PfgCOHF0jja61QmAjcMPEHRSrTeK7EUogA-WM7ozSn6BAX0nTDb4dICr9bpksVKvB53DG5GTqTV00cX4EjSP_QuuiUpAvuiZFRcWaDzGzTECB8DptcOUmaHhuuuHIgPng5DNJeMtPvPqEmCNdSpMJ7eq-kg0RWsHmkbNpgVpk2pLm8AB_MPoq0wZ7hs660qnnU9d-9AG28VQrASsvkBolHZg ``` --- # 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/classic-tokenization/ja/ysuksu/kdo/fur/suteppu1-kdowosuru/sukmunorii.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.