カード注文

D1 を使用して物理カードの製造と発送を依頼します。

D1 を使用すると、イシュアのバックエンドから物理カードの製造をリクエストできます。カードをエンドユーザーへ発送できます。また、支店やハブへ一括発送することもできます。

このセクションを使用して、パーソナライゼーションと配送オプションを選択します。その後、Physical Issuance API を呼び出して注文を送信します。

開始する前に

• D1 のオンボーディングを完了し、D1 の API 資格情報を取得します。

• カード製品、パーソナライゼーションプロファイル、およびレターテンプレートを設定します。

• プログラム/BIN 用の在庫品目と製品バリアントを読み込みます。

• 返送先住所と配送方法を設定します。

• プログラムごとに許可される配送先国を定義します。

フロー

イシュアのバックエンドリクエストから Thales のパーソナライゼーションセンターまでのエンドツーエンドのフロー。

仕組み

1

注文オプションを選択する

選択：

• イシュアタイプ、配送、パッケージング、およびカードキャリア設定。参照： カード注文サービスを選択する.

• パーソナライゼーション入力（印字、磁気ストライプ、チップ）。参照：

  • 磁気ストライプのトラック

  • グラフィカルパーソナライゼーション

  • チップのパーソナライゼーション

  • カードキャリアのパーソナライゼーション

  • パッケージング

  • 発送

2

注文を送信する

次を呼び出します カード注文 API して物理カードを注文します。

リクエストは冪等にしてください。イシュアのバックエンドから安定したキー（たとえば、 issuerRequestId）を再利用し、再試行によって重複が作成されないようにします。

3

製造と発送を追跡する

ステータスエンドポイントと通知を使用して、システムを同期状態に保ちます。

参照 カード注文の追跡.

必須 API

API	入出力	説明
認証トークンを取得する	イシュア -> Thales D1	D1 バックエンドを呼び出すための OAuth 2.0 アクセストークンを取得します。
カード注文	イシュア -> Thales D1	物理カードを注文する
通知	イシュア <- Thales D1	PRODUCE オペレーションのカード注文ステータスを含む通知を受信する

API 入力

必須の D1 API 入力：

• issuerId: イシュアの一意の識別子

• cardId: カードの一意の識別子。

• consumerId: コンシューマーの一意の識別子。

条件付きの D1 API 入力：

• issuerRequestId: カード製造リクエストを識別するためにイシュアが提供する一意の識別子。注文と通知を関連付けるために使用されます。

その他の D1 API 入力については、必要な入力を説明する各セクションを参照してください：

• カード注文サービスを選択する

• 磁気ストライプのトラック

• グラフィカルパーソナライゼーション

• チップのパーソナライゼーション

• カードキャリアのパーソナライゼーション

• パッケージング

• 発送

非推奨の D1 API 入力：

• state: カードの状態。指定されない場合、カードは ACTIVE と見なされます。

• oldCardId: 以前のカードの一意の識別子。カードが別のカードを置き換える場合に指定します。

エラー処理と再試行

エラーは 2 つの層で処理します：

• 同期的な API エラー （HTTP 4xx/5xx）。ペイロードを検証します。一時的な障害には冪等性を使って安全に再試行します。

• 非同期の製造エラー （たとえば、在庫切れやテンプレートの問題）。イシュアのバックエンドで最新のオペレーションステータスを追跡します。

セキュリティとデータ処理

PAN、磁気ストライプトラック値、カードセキュリティコード（CSC）は機密データとして扱います。

• 機密フィールドをログに記録しないでください。

• エンドポイントで必要な場合は機密フィールドを暗号化します。参照： 機密データを暗号化する.