---
title: "Update Digital Wallet Token's life cycle status"
method: PATCH
path: "/cards/digital_wallet_tokens/{digital_wallet_token_id}"
tags: ["Digital Wallet Tokens"]
---

# Update Digital Wallet Token's life cycle status

`PATCH /cards/digital_wallet_tokens/{digital_wallet_token_id}`

The status of a digital wallet token can be updated as, ACTIVE to SUSPENDED, SUSPENDED to ACTIVE, ACTIVE to TERMINATED or SUSPENDED to TERMINATED.

## Path parameters

- `digital_wallet_token_id` string, uuid, required — The unique identifier of a digital wallet token

## Headers

- `Idempotency-Key` string

## Request body

- DigitalWalletTokenEditRequest
  - `token_status` 'ACTIVE' | 'SUSPENDED' | 'TERMINATED', required — The status indicating the digital wallet token lifecycle state

## Response `200`

Digital wallet token Status updated

- DigitalWalletTokenResponse
  - `approved_time` string, date-time
  - `card_id` string, uuid — Card ID of the Digital wallet Token
  - `device_id` string — The user’s Android device ID; the device’s unique identifier.
  - `device_type` 'APPLIANCE' | 'GAMING_DEVICE' | 'LAPTOP' | 'MOBILE_PHONE' | 'MOBILE_PHONE_OR_TABLET' | 'TABLET' | 'UNKNOWN' | 'VEHICLE' | 'WATCH' — Type of the device where the Digital Wallet Token is used in
  - `id` string, uuid — Digital Wallet Token ID
  - `last_modified_time` string, date-time
  - `processor_data` object — Raw data from processor.
  - `removed_from_wallet_time` string, date-time — The time that the token was removed from a wallet. Tokens make remain active after being removed from a wallet.
  - `requested_time` string, date-time
  - `state` 'ACTIVE' | 'REQUESTED' | 'REQUEST_DECLINED' | 'SUSPENDED' | 'TERMINATED' — Current status of the Digital Wallet Token
  - `token_reference_id` string — Unique identifier of the digital wallet token within the card network.
  - `type` string — Type of the Digital Wallet. Can be one of APPLE_PAY, ANDROID_PAY, SAMSUNG_PAY or something else when cards are added on file to a merchant.

## Other responses

- `400` — BadRequest
- `401` — Unauthorized
- `403` — Forbidden error
- `422` — Unprocessable entity request response
- `500` — Internal server error

---

[API](https://skmtc.dev/synctera/apis/synctera-api.md) · [All operations](https://skmtc.dev/synctera/apis/synctera-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/synctera/synctera-api/revisions/a6363e3dbb7b/schema)