> 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/3d-secure/ja/meru/kdowosuru/kdonoraifusaikuruwosuru.md).

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

## Card life cycle and operations

The diagram below shows the different life cycle states of a card.

<figure><img src="/spaces/62lLFDcmLCeqqwmy4Fee/files/L9kY7F0TAewuShMgZ4YR" alt=""><figcaption><p>Card life cycle state diagram.</p></figcaption></figure>

In addition to the state, each card exposes an **ongoingOperation** property. This property indicates whether a card renewal has been initiated and activation of the reissued card is expected. The **ongoingOperation** property is available both in the D1 API and in the D1 SDK.

### Card life cycle operations <a href="#card-life-cycle-operation" id="card-life-cycle-operation"></a>

Card life cycle operations can be performed through the following channels:

* D1 REST API
* D1 SDK

### Life cycle operation reasons <a href="#life-cycle-operation-reason" id="life-cycle-operation-reason"></a>

A reason must be provided every time you perform a card life cycle operation. The tables below summarize, for each operation type, the available reasons, their meaning, and the impact on the card.

#### Suspend reasons <a href="#suspend-reason" id="suspend-reason"></a>

| Reason           | Description                                                                                                                                     |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| CARD\_LOST       | <p>The card has been reported as lost. You can:<br>- resume the card using the reason <code>CARD\_FOUND</code>.<br>- request a replacement.</p> |
| CARD\_STOLEN     | The card has been reported as stolen. The card remains suspended until you explicitly request a replacement.                                    |
| CARD\_BROKEN     | The card is damaged and no longer works. The card remains suspended until you explicitly request a replacement.                                 |
| FRAUD            | The card is compromised. The card remains suspended until you explicitly request a replacement.                                                 |
| USER\_DECISION   | The end user has decided to temporarily suspend the card. The card can be resumed with the reason `USER_DECISION` or `ISSUER_DECISION`.         |
| ISSUER\_DECISION | The issuer has decided to temporarily suspend the card. The card can be resumed with the reason `ISSUER_DECISION`.                              |

#### Resume reasons <a href="#resume-reason" id="resume-reason"></a>

| Reason           | Description                                                                                             |
| ---------------- | ------------------------------------------------------------------------------------------------------- |
| CARD\_FOUND      | The card has been found and was previously suspended with the reason `CARD_LOST`.                       |
| ISSUER\_DECISION | The issuer has decided to resume the card.                                                              |
| USER\_DECISION   | The end user has decided to resume the card and the card was previously suspended with `USER_DECISION`. |

#### Delete reasons <a href="#delete-reason" id="delete-reason"></a>

| Reason           | Description                                                                |
| ---------------- | -------------------------------------------------------------------------- |
| CLOSED\_ACCOUNT  | The end user has closed the account and the card must be deleted/canceled. |
| CLOSED\_CARD     | The card must be deleted/canceled.                                         |
| CARD\_LOST       | The card has been reported as lost and must be deleted/canceled.           |
| CARD\_STOLEN     | The card has been reported as stolen and must be deleted/canceled.         |
| CARD\_BROKEN     | The card is damaged and must be deleted/canceled.                          |
| FRAUD            | The card is compromised and must be deleted/canceled.                      |
| USER\_DECISION   | The end user has decided to delete the card.                               |
| ISSUER\_DECISION | The issuer has decided to delete the card.                                 |

#### Replacement reasons <a href="#replacement-reason" id="replacement-reason"></a>

| Reason           | Description                                 |
| ---------------- | ------------------------------------------- |
| CARD\_LOST       | The card has been reported as lost.         |
| CARD\_STOLEN     | The card has been reported as stolen.       |
| CARD\_BROKEN     | The card is damaged and no longer works.    |
| FRAUD            | The card is compromised.                    |
| ISSUER\_DECISION | The issuer has decided to replace the card. |

#### Renewal reasons <a href="#renewal-reason" id="renewal-reason"></a>

| Reason           | Description                                                             |
| ---------------- | ----------------------------------------------------------------------- |
| USER\_DECISION   | The end user has decided to renew the card.                             |
| ISSUER\_DECISION | The issuer has decided to renew the card.                               |
| CARD\_EXPIRED    | The card has been renewed because it has expired or is about to expire. |

## D1 REST API <a href="#d1-rest-api" id="d1-rest-api"></a>

### Renewal and replacement flows <a href="#renewal--replacement-flow" id="renewal--replacement-flow"></a>

#### Automatic renewal <a href="#automatic-renewal" id="automatic-renewal"></a>

Automatic renewal is available only for cards created with D1. D1 monitors the expiry date of each card created with D1 and can automatically trigger renewal a few weeks before expiration.

#### Manual renewal <a href="#and-manual-renewal" id="and-manual-renewal"></a>

Manual renewal is available for cards created with D1 and for registered cards. Manual renewal is triggered using the renew API.

If the card is registered (not created with D1), the new PAN and/or expiry date must be provided so that D1 stays up to date with the new card credentials.

#### Manual replacement flow <a href="#manual-replacement-flow" id="manual-replacement-flow"></a>

Manual replacement is available for cards created with D1 and for registered cards. Manual replacement is triggered using the replace API.

If the card is registered (not created with D1), the new PAN and/or expiry date must be provided so that D1 stays up to date with the new card credentials.

#### New card activation <a href="#new-card-activation" id="new-card-activation"></a>

Depending on the card product configuration, after renewal or replacement the new card may be created in the **INACTIVE** state. There are three ways to activate the card:

* **Activation at first card-present transaction with a valid PIN.** This is available only if the card was created via D1.
* **Manual activation using the D1 REST API (Not yet available).**
* **Manual activation from the issuer application using the D1 SDK (Not yet available)**.


---

# 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:

```
GET https://docs.payments.thalescloud.io/3d-secure/ja/meru/kdowosuru/kdonoraifusaikuruwosuru.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.