> 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/transit-digitization/ja/d1-transit-api-wosuru/psonaraizshondtawosuru.md).
# パーソナライゼーションデータを準備する
以下のセクションでは、デジタルカードバンドルを構築するために、getDigitalCardBundleData レスポンスで Transit イシュア により返されるデータ要素の一覧を定義します。
アプリケーションの技術によって、要素の一覧は異なります。
### EMV
| 名前 | 形式 | 説明 | 例 |
| -------------------- | --- | --------------------------------------------------------------------- | ------------------------------- |
| acIssuerMasterKeyId | 文字列 | アプリケーション暗号を計算するために使用される ICC マスターキーを取得するために派生される IMK の識別子。 | "G0DB5.LIVE.IMK225563.IMKAC.01" |
| acDerivationKeyIndex | 文字列 | ICC マスターキーを派生するために使用される IMK AC を識別する派生キーインデックス。この値はデジタルカードに個別化されます。 | "01" |
| cardData | 文字列 | データ暗号化で定義されている JWE 暗号化を使用して暗号化された cardData。
以下の形式を参照してください。
| |
#### カードデータ
JSON オブジェクトは次のように定義されます。
| JSON パラメータ名 | 説明 | サンプル値 |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- |
| pan | PAN（Primary Account Number）の値。
必須
| "4929403965000868" |
| exp | カードの有効期限の 'MMYY' 形式。
必須
| "1228" |
| panSequenceNumber | PAN のシーケンス番号。
デフォルト値は "01" に設定されます
| "03" |
| paymentAccountReference | Payment Account Reference（PAR）。
PAR データは、EMVCo により Registered BIN Controllers に割り当てられる 4 文字の BIN Controller Identifier と、その後に続く一意の 25 文字の値で構成されます。
| "512381D9F8E0629211E3949A08002" |
| initialAtc | 初期 Application Transaction Counter の値。
デフォルト値は "0001" に設定されます
| "000A" |
サンプルペイロード:
```json
{
"pan": "4929403965000868",
"exp": "1228",
"panSequenceNumber": "01",
"paymentAccountReference": "512381D9F8E0629211E3949A08002",
"initialAtc": "0001"
}
```
#### PURE
PURE アプリケーションを使用する場合は、以下のデータ要素を追加で提供する必要があります（Apple には適用されません）。
| 名前 | 形式 | 説明 | 例 |
| -------------------- | --- | ------------------------------------------------------------------- | ------------------------------- |
| lcIssuerMasterKeyId | 文字列 | ローカル CDCVM スタンプ暗号を計算するために使用される ICC マスターキーを取得するために派生される IMK の識別子。 | "G0DB5.LIVE.IMK225563.IMKAC.12" |
| lcDerivationKeyIndex | 文字列 | ICC マスターキーを派生するために使用される IMK LC を識別する派生キーインデックス。この値はデジタルカードに個別化されます。 | "04" |
### Calypso
| 名前 | 形式 | 説明 | 例 |
| --------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |
| applicationType | 文字列 | 個別化する Calypso アプリケーションの種類を示します。
- Navigo の場合は 01
- Triangle 2/Hoplink の場合は 02
- AMC の場合は 03
- その他の Calypso アプリケーションの場合は 00
| "00" |
| issuerKeyId | 16進文字列 | イシュアキー識別子（KIF KVC）
DGI 4101 に使用
| "217E" |
| loadKeyId | 16進文字列 | ロードキー識別子（KIF KVC）
DGI 4102 に使用
| "277E" |
| validationKeyId | 16進文字列 | バリデーションキー識別子（KIF KVC）
DGI 4103 に使用
| "307E" |
| signatureKey1Id | 16進文字列 | 次のいずれかを表すキー識別子（KIF KVC）：
- applicationType ='02' または '03' の HSM キーによる署名
- または applicationType ='01' の署名キー #1
applicationType = '00' には適用されません
| "EC15" |
| signatureKey2Id | 16進文字列 | 次のいずれかを表すキー識別子（KIF KVC）：
- applicationType = '02' または '03' の AES-CTR 暗号化キー
- または applicationType = '01' の署名キー #2
applicationType = '00' には適用されません
| "EC45" |
| signatureKey3Id | 16進文字列 | applicationType = '03' の PID 生成キーを表すキー識別子（KIF KVC）
applicationType = '00'、'01'、'02' には適用されません
| "EC75" |
| signatureKey4Id | 16進文字列 | applicationType = '03' の PID 署名キーを表すキー識別子（KIF KVC）
applicationType = '00'、'01'、'02' には適用されません
| "EC95" |
| dgixxxx | 16進文字列（29 バイト） | 個別化する DGI の値。
'xxxx' は DGI タグを表します。たとえば、dgi0903 は DGI タグ = '0903' を意味します。
| "00000FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF" |
---
# 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/transit-digitization/ja/d1-transit-api-wosuru/psonaraizshondtawosuru.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.