Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

パーソナライゼーションデータを準備する

以下のセクションでは、デジタルカードバンドルを構築するために、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"

サンプルペイロード:

{
  "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"

最終更新

役に立ちましたか?