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

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

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

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

状態に加えて、各カードは次のものを公開します 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 または イシュア_DECISION.
イシュア_DECISION	イシュアはカードを一時停止することを決定しました。カードは次のいずれかで再開できます イシュア_DECISION.

再開の理由

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

削除の理由

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

再発行の理由

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

更新の理由

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

D1 API の操作

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

• カードを一時停止する
• カードを再開する
• カードを削除する
• カードを再発行する
• カードを更新する

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

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

更新と再発行のフロー

自動更新

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

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

手動更新

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

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

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

手動再発行フロー

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

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

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

新しいカードの有効化

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

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

• 有効な PIN を使用したカード提示時の最初の取引での有効化（D1 で作成されたカードのみ）。
• D1 API を使用した手動有効化（まだ利用できません）。
• D1 SDK を使用してイシュアアプリケーションから手動で有効化（まだ利用できません）。