> 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/classic-tokenization/ja/ysuksu/deng-lu-hou/tkunraifusaikuru/ishuabakkuendokaratkunwosuru.md).

# イシュアバックエンドからトークン状態を更新する

使用する `updateCardState` イシュア主導のトークンを実行するために **LCM** operation。

一般的なユースケース：

* トークンを一時停止または再開する。
* トークンを削除する。
* カードのすべてのトークンに同じ操作を適用する。

### スコープを選択する

次の対象を指定できます：

* 単一のトークン（を使用して） `virtualCardId`.
* APIで定義されたカード識別子を使用して、そのカードに属するすべてのトークン。

参照： [`updateCardState`](https://thales-dis-dbp.stoplight.io/docs/digital-payment/b3A6MjU4Nzg1MTQ-update-state-of-funding-virtual-card) 完全なリクエストスキーマについては、を参照してください。

### 特定のトークンを更新する

<figure><img src="/files/b928844d9f63c75092d27cf8bd4307cecaadf8f1" alt="Issuer-initiated token state update flow."><figcaption><p>イシュアのバックエンドによって開始されたトークン状態の更新。</p></figcaption></figure>

{% stepper %}
{% step %}

### 1. updateCardState を呼び出す

を呼び出す `updateCardState` イシュアのバックエンドから。

少なくとも次を含める：

| パラメータ              | 説明                                           |
| ------------------ | -------------------------------------------- |
| `x-correlation-id` | このLCM操作を後続のコールバックと相関させます。操作ごとに新しい値を生成してください。 |
| `virtualCardId`    | 更新するトークンを識別します。                              |
| `action`           | 適用する状態変更を指定します。                              |
| {% endstep %}      |                                              |

{% step %}

### 2. トークン更新が完了するまで待つ

決済ネットワークとウォレットプロバイダが状態変更を適用します。

それらはデジタルウォレットアプリケーションおよびでトークンを更新します。 **TSP**.
{% endstep %}

{% step %}

### 3. notifyVirtualCardChange を処理する

操作が完了した（または失敗した）とき、あなたは受け取ります `notifyVirtualCardChange`.

参照： [`notifyVirtualCardChange`](https://thales-dis-dbp.stoplight.io/docs/digital-payment/b3A6MjU4Nzg1MjE-notify-issuer-about-any-virtual-card-token-change).

| パラメータ              | 説明                                              |
| ------------------ | ----------------------------------------------- |
| `x-correlation-id` | の値と一致します `updateCardState`.                     |
| `virtualCardId`    | 更新されたトークンを識別します。                                |
| `action`           | 実行されたアクションを指定します。                               |
| `errorCode`        | 失敗を示します。例えば、 `221` は再試行後もデバイスに到達できなかったことを意味します。 |
| {% endstep %}      |                                                 |
| {% endstepper %}   |                                                 |

{% hint style="info" %}
冪等に `notifyVirtualCardChange` 処理してください。コールバックは重複したり遅延したりする可能性があります。
{% endhint %}

### カードのすべてのトークンを更新する

<figure><img src="/files/29e4b392ea3681104a93eff5467b6492d7065d65" alt="Issuer-initiated state update for all tokens of a card."><figcaption><p>カードに属するすべてのトークンのトークン状態更新。</p></figcaption></figure>

を呼び出す `updateCardState` APIで定義されたカード識別子を使用して。

1つ受け取ります `notifyVirtualCardChange` 更新された各トークンごとにコールバック。

### 関連ドキュメント

* [ウォレットプロバイダーからトークン状態を更新する](/classic-tokenization/ja/ysuksu/deng-lu-hou/tkunraifusaikuru/worettopurobaidkaratkunwosuru.md)
* [登録の失敗を処理する](/classic-tokenization/ja/ysuksu/kdo/no.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/classic-tokenization/ja/ysuksu/deng-lu-hou/tkunraifusaikuru/ishuabakkuendokaratkunwosuru.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.