> 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/central-issuance/ja/wosuru/kdo.md).

# カード注文

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

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

### 開始する前に

* D1 のオンボーディングを完了し、D1 の API 資格情報を取得します。
* カード製品、パーソナライゼーションプロファイル、およびレターテンプレートを設定します。
* プログラム/BIN 用の在庫品目と製品バリアントを読み込みます。
* 返送先住所と配送方法を設定します。
* プログラムごとに許可される配送先国を定義します。

### フロー

<figure><img src="/files/a74d4bdedf6961c7c61985662e9f8c5d4660ad50" alt=""><figcaption><p>イシュアのバックエンドリクエストから Thales のパーソナライゼーションセンターまでのエンドツーエンドのフロー。</p></figcaption></figure>

### 仕組み

{% stepper %}
{% step %}

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

選択：

* イシュアタイプ、配送、パッケージング、およびカードキャリア設定。参照： [カード注文サービスを選択する](/central-issuance/ja/wosuru/kdo/kdosbisuwosuru.md).
* パーソナライゼーション入力（印字、磁気ストライプ、チップ）。参照：
  * [磁気ストライプのトラック](/central-issuance/ja/wosuru/kdo/sutoraipunotorakku.md)
  * [グラフィカルパーソナライゼーション](/central-issuance/ja/wosuru/kdo/gurafikarupsonaraizu.md)
  * [チップのパーソナライゼーション](/central-issuance/ja/wosuru/kdo/chippupsonaraizu.md)
  * [カードキャリアのパーソナライゼーション](/central-issuance/ja/wosuru/kdo/bao-zhuang.md)
  * [パッケージング](/central-issuance/ja/wosuru/kdo/bao-zhuang.md)
  * [発送](/central-issuance/ja/wosuru/kdo/fa-song.md)
    {% endstep %}

{% step %}

### 注文を送信する

次を呼び出します [カード注文 API](/central-issuance/ja/d1-api-wosuru/d1-api-rifarensu/apid1-heno/kdo-api-1.md#post-issuers-issuerid-physicalcards-cardid-operations-production) して物理カードを注文します。

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

{% step %}

### 製造と発送を追跡する

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

参照 [カード注文の追跡](/central-issuance/ja/wosuru/kdono.md).
{% endstep %}
{% endstepper %}

### 必須 API

<table><thead><tr><th width="202.39996337890625">API</th><th width="176.7999267578125">入出力</th><th>説明</th></tr></thead><tbody><tr><td><a href="/pages/be96d53f1ef94ddef604549b13b45305bd5f322b#post-oauth2-token">認証トークンを取得する</a></td><td>イシュア -> Thales D1</td><td>D1 バックエンドを呼び出すための OAuth 2.0 アクセストークンを取得します。</td></tr><tr><td><a href="/pages/8c2197148bcf3b662a4709ab17cd512ff7ed6a04#post-issuers-issuerid-physicalcards-cardid-operations-production">カード注文</a></td><td>イシュア -> Thales D1</td><td>物理カードを注文する</td></tr><tr><td><a href="/pages/a0da17fc2828bbeb3e08030f8edf54616fd09fb7#post-notifications-d1-v2-issuers-issuerid-cards">通知</a></td><td>イシュア &#x3C;- Thales D1</td><td>PRODUCE オペレーションのカード注文ステータスを含む通知を受信する</td></tr></tbody></table>

### API 入力

必須の D1 API 入力：

* `issuerId`: イシュアの一意の識別子
* `cardId`: カードの一意の識別子。
* `consumerId`: コンシューマーの一意の識別子。

条件付きの D1 API 入力：

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

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

* [カード注文サービスを選択する](/central-issuance/ja/wosuru/kdo/kdosbisuwosuru.md)
* [磁気ストライプのトラック](/central-issuance/ja/wosuru/kdo/sutoraipunotorakku.md)
* [グラフィカルパーソナライゼーション](/central-issuance/ja/wosuru/kdo/gurafikarupsonaraizu.md)
* [チップのパーソナライゼーション](/central-issuance/ja/wosuru/kdo/chippupsonaraizu.md)
* [カードキャリアのパーソナライゼーション](/central-issuance/ja/wosuru/kdo/bao-zhuang.md)
* [パッケージング](/central-issuance/ja/wosuru/kdo/bao-zhuang.md)
* [発送](/central-issuance/ja/wosuru/kdo/fa-song.md)

非推奨の D1 API 入力：

* `state`: カードの状態。指定されない場合、カードは ACTIVE と見なされます。
* `oldCardId`: 以前のカードの一意の識別子。カードが別のカードを置き換える場合に指定します。

### エラー処理と再試行

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

* **同期的な API エラー** （HTTP `4xx`/`5xx`）。ペイロードを検証します。一時的な障害には冪等性を使って安全に再試行します。
* **非同期の製造エラー** （たとえば、在庫切れやテンプレートの問題）。イシュアのバックエンドで最新のオペレーションステータスを追跡します。

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

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

* 機密フィールドをログに記録しないでください。
* エンドポイントで必要な場合は機密フィールドを暗号化します。参照： [機密データを暗号化する](/central-issuance/ja/d1-api-wosuru/d1-jie-xu/dtawosuru.md).


---

# 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/central-issuance/ja/wosuru/kdo.md?ask=<question>&goal=<endgoal>
```

`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.