Welcome to our new developer portal! Use the "Ask" button to chat with our AI Agent.
For the complete documentation index, see llms.txt. This page is also available as Markdown.

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

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

一般的なユースケース:

  • トークンを一時停止または再開する。

  • トークンを削除する。

  • カードのすべてのトークンに同じ操作を適用する。

スコープを選択する

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

  • 単一のトークン(を使用して) virtualCardId.

  • APIで定義されたカード識別子を使用して、そのカードに属するすべてのトークン。

参照: updateCardState 完全なリクエストスキーマについては、を参照してください。

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

Issuer-initiated token state update flow.
イシュアのバックエンドによって開始されたトークン状態の更新。
1

1. updateCardState を呼び出す

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

少なくとも次を含める:

パラメータ
説明

x-correlation-id

このLCM操作を後続のコールバックと相関させます。操作ごとに新しい値を生成してください。

virtualCardId

更新するトークンを識別します。

action

適用する状態変更を指定します。

2

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

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

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

3

3. notifyVirtualCardChange を処理する

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

参照: notifyVirtualCardChange.

パラメータ
説明

x-correlation-id

の値と一致します updateCardState.

virtualCardId

更新されたトークンを識別します。

action

実行されたアクションを指定します。

errorCode

失敗を示します。例えば、 221 は再試行後もデバイスに到達できなかったことを意味します。

冪等に notifyVirtualCardChange 処理してください。コールバックは重複したり遅延したりする可能性があります。

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

Issuer-initiated state update for all tokens of a card.
カードに属するすべてのトークンのトークン状態更新。

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

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

関連ドキュメント

最終更新

役に立ちましたか?