カードのライフサイクルを管理する

カードのライフサイクルと操作

下の図は、カードのさまざまなライフサイクル状態を示しています。

カードのライフサイクル状態図。

状態に加えて、各カードには ongoingOperation プロパティがあります。

このプロパティは、更新が開始されており、再発行されたカードの有効化が期待されているかどうかを示します。

ongoingOperation は、D1 API と D1 SDK の両方で利用できます。

カードのライフサイクル操作

カードのライフサイクル操作は次の方法で実行できます。

• D1 API

• D1 SDK

• D1 ポータル

API の詳細については、以下の D1 API リファレンスページを参照してください。 D1 API を統合する.

ライフサイクル操作の理由

カードのライフサイクル操作を実行するたびに、理由を指定してください。

以下の表は、利用可能な理由とその影響を要約したものです。

停止理由

理由	説明
CARD_LOST	カードは紛失したと報告されています。次のことができます。 - 理由 CARD_FOUNDを使用してカードを再開する。 - 再発行を依頼する。
CARD_STOLEN	カードは盗難にあったと報告されています。明示的に再発行を依頼するまで、カードは停止されたままになります。
CARD_BROKEN	カードが破損しており、もう使用できません。明示的に再発行を依頼するまで、カードは停止されたままになります。
FRAUD	カードが不正利用されています。明示的に再発行を依頼するまで、カードは停止されたままになります。
USER_DECISION	エンドユーザーが一時的にカードを停止することを決定しました。カードは USER_DECISION または ISSUER_DECISION.
ISSUER_DECISION	イシュアが一時的にカードを停止することを決定しました。カードは ISSUER_DECISION.

再開理由

理由	説明
CARD_FOUND	カードが見つかり、以前 CARD_LOST.
ISSUER_DECISION	という理由で停止されていました。イシュアがカードを再開することを決定しました。
USER_DECISION	エンドユーザーがカードを再開することを決定し、カードは以前 USER_DECISION.

削除理由

理由	説明
CLOSED_ACCOUNT	エンドユーザーがアカウントを閉鎖したため、カードを削除/キャンセルする必要があります。
CLOSED_CARD	カードを削除/キャンセルする必要があります。
CARD_LOST	カードは紛失したと報告されており、削除/キャンセルする必要があります。
CARD_STOLEN	カードは盗難にあったと報告されており、削除/キャンセルする必要があります。
CARD_BROKEN	カードが破損しているため、削除/キャンセルする必要があります。
FRAUD	カードが不正利用されているため、削除/キャンセルする必要があります。
USER_DECISION	エンドユーザーがカードを削除することを決定しました。
ISSUER_DECISION	イシュアがカードを削除することを決定しました。

再発行理由

理由	説明
CARD_LOST	カードは紛失したと報告されています。
CARD_STOLEN	カードは盗難にあったと報告されています。
CARD_BROKEN	カードが破損しており、もう使用できません。
FRAUD	カードが不正利用されています。
ISSUER_DECISION	イシュアがカードを再発行することを決定しました。

更新理由

理由	説明
USER_DECISION	エンドユーザーがカードを更新することを決定しました。
ISSUER_DECISION	イシュアがカードを更新することを決定しました。
CARD_EXPIRED	カードの有効期限が切れた、または切れかかっているため、カードが更新されました。

D1 API の操作

ライフサイクル操作には、次の D1 API エンドポイントを使用してください。

• カードを停止する

• カードを再開する

• カードを削除する

• カードを再発行する

• カードを更新する

カード一覧は次を使用して取得できます。 カード一覧を取得.

カード詳細が必要な場合は、次を使用してください。 カード詳細を取得.

更新と再発行のフロー

自動更新

自動更新は、D1 で作成されたカードでのみ利用できます。

D1 はカードの有効期限を監視し、有効期限の数週間前に更新をトリガーできます。

手動更新

手動更新は、D1 で作成されたカードと登録済みカードで利用できます。

次を使用して手動更新をトリガーします。 カードを更新する エンドポイント。

カードが登録済み（D1 で作成されていない）場合は、D1 を最新の状態に保つために新しい PAN および/または有効期限を指定してください。

手動再発行フロー

手動再発行は、D1 で作成されたカードと登録済みカードで利用できます。

次を使用して手動再発行をトリガーします。 カードを再発行する エンドポイント。

カードが登録済み（D1 で作成されていない）場合は、D1 を最新の状態に保つために新しい PAN および/または有効期限を指定してください。

新しいカードの有効化

カード商品設定によっては、更新または再発行後に新しいカードが INACTIVE 状態で作成される場合があります。

カードを有効化する方法は 3 つあります。

• 有効な PIN を使用した、カード提示ありの最初の取引時に有効化する（D1 で作成されたカードのみ）。

• D1 API を使用した手動有効化（まだ利用できません）。

• D1 SDK を使用してイシュアアプリケーションから手動有効化する（まだ利用できません）。