プル＆チェンジ

API 経由で D1 が受信したものの、まだ出荷されていない物理カード注文の更新をリクエストするには、pull and change を使用します。

この機能は、API で注文されたカードでのみ利用できます。

フロー

物理カード注文の pull and change フロー。

シーケンス図

仕組み

1. イシュアのバックエンドが pull and change リクエストを送信します。一般的な変更タイプ:

   • CANCEL：カード注文をキャンセルし、カードを破棄します。
   • ACCELERATE：カードをできるだけ早く作成し、速達配送業者で発送します。
   • REDIRECT：発送先住所を変更します。
   • ACCELERATE_AND_REDIRECT：生産を前倒しし、発送先住所を変更します。
2. D1 はリクエストをカードを製造するパーソナライズセンターに転送します。
3. パーソナライズセンターは、生産段階に基づいてリクエストを承認または拒否します。
4. D1 は結果を通知経由で非同期に返します。

必要な API

API	受信/送信	説明
Pull & Change	イシュア -> Thales D1	カードを取り出し、変更の適用をリクエストします
通知	イシュア <- Thales D1	UPDATE_ORDER 操作の通知を受信します

API 入力

必要な D1 API 入力:

• issuerId：イシュアの一意識別子
• cardId：カードの一意識別子。
• type：カード注文に適用する変更の種類。

条件付きの D1 API 入力、次の場合 type is REDIRECTor ACCELERATE_AND_REDIRECT.

• newDeliveryAddress フィールド:

  • title：敬称（例： Mr).
  • firstName：名。
  • lastName：姓。
  • companyName：会社名。
  • line1：住所1行目。
  • line2：住所2行目。
  • line3：住所3行目。
  • city：市区町村。
  • state：州または地域。
  • zipCode：郵便番号。
  • countryCode：国コード（ISO 3166-1 alpha-2、例： US).
  • mobilePhoneNumber：発送連絡に使用する国際電話番号。

例

例 - CANCEL

{
  "type": "CANCEL"
}

例 - ACCELERATE

{
  "type": "ACCELERATE",
  "newDueDate": "2025-01-15"
}

例 - REDIRECT

{
  "type": "REDIRECT",
  "newDeliveryAddress": {
    "title": "Ms",
    "firstName": "Alex",
    "lastName": "Chen",
    "companyName": "Example Co",
    "line1": "10 Main St",
    "line2": "Apt 3B",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "countryCode": "US",
    "mobilePhoneNumber": "[phone]"
  }
}

例 - ACCELERATE_AND_REDIRECT

{
  "type": "ACCELERATE_AND_REDIRECT",
  "newDueDate": "2025-01-15",
  "newDeliveryAddress": {
    "title": "Ms",
    "firstName": "Alex",
    "lastName": "Chen",
    "companyName": "Example Co",
    "line1": "10 Main St",
    "line2": "Apt 3B",
    "city": "New York",
    "state": "NY",
    "zipCode": "10001",
    "countryCode": "US",
    "mobilePhoneNumber": "[phone]"
  }
}

結果を追跡する

• 通知を処理して、承認または拒否の結果を取得します。