---
title: "Transition a Digital Wallet Token"
method: POST
path: "/digital_wallet_tokens/{digital_wallet_token_id}/transition"
---

# Transition a Digital Wallet Token

`POST /digital_wallet_tokens/{digital_wallet_token_id}/transition`

Submit a Digital Wallet Token status transition to the card network. The Digital Wallet Token will move to `pending_transitioning` until the card network confirms the transition, and a `digital_wallet_token.updated` webhook will be sent once the transition has been confirmed.

## Path parameters

- `digital_wallet_token_id` string, required — The identifier of the Digital Wallet Token.

## Request body

- TransitionADigitalWalletTokenParameters
  - `status` 'active' | 'suspended' | 'deactivated', required — The status to transition the Digital Wallet Token to.

## Response `200`

Digital Wallet Token

- DigitalWalletToken — A Digital Wallet Token is created when a user adds a Card to their Apple Pay or Google Pay app. The Digital Wallet Token can be used for purchases just like a Card.
  - `account_id` string, required — The identifier for the Account this Digital Wallet Token belongs to.
  - `card_id` string, required — The identifier for the Card this Digital Wallet Token belongs to.
  - `cardholder` object, required — The cardholder information given when the Digital Wallet Token was created.
    - `name` string, nullable, required — Name of the cardholder, for example "John Smith".
  - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the Digital Wallet Token was created.
  - `decline` object, nullable, required — If the Digital Wallet Token was declined during provisioning, details about the decline.
    - `reason` 'card_not_active' | 'no_verification_method' | 'webhook_timed_out' | 'webhook_declined' | 'incorrect_card_verification_code' | 'declined_by_token_requestor' | 'group_locked' | 'account_closed' | 'entity_not_active', required — The reason the token provisioning was declined.
  - `device` object, required — The device that was used to create the Digital Wallet Token.
    - `device_type` 'unknown' | 'mobile_phone' | 'tablet' | 'watch' | 'mobilephone_or_tablet' | 'pc' | 'household_device' | 'wearable_device' | 'automobile_device', nullable, required — Device type.
    - `identifier` string, nullable, required — ID assigned to the device by the digital wallet provider.
    - `ip_address` string, nullable, required — IP address of the device.
    - `name` string, nullable, required — Name of the device, for example "My Work Phone".
  - `dynamic_primary_account_number` object, nullable, required — The redacted Dynamic Primary Account Number.
    - `first6` string, required — The first 6 digits of the token's Dynamic Primary Account Number.
    - `last4` string, required — The last 4 digits of the token's Dynamic Primary Account Number.
  - `id` string, required — The Digital Wallet Token identifier.
  - `primary_account_number_reference_identifier` string, required — The reference identifier assigned by the card network to the underlying Card.
  - `status` 'active' | 'inactive' | 'suspended' | 'deactivated' | 'declined' | 'pending_transitioning', required — This indicates if payments can be made with the Digital Wallet Token.
  - `token_reference_identifier` string, required — The reference identifier assigned by the card network to the token.
  - `token_requestor` 'apple_pay' | 'google_pay' | 'samsung_pay' | 'garmin_pay' | 'unknown', required — The digital wallet app being used.
  - `type` 'digital_wallet_token', required — A constant representing the object's type. For this resource it will always be `digital_wallet_token`.
  - `updates` object[], required — Updates to the Digital Wallet Token.
    - `status` 'active' | 'inactive' | 'suspended' | 'deactivated' | 'declined' | 'pending_transitioning', required — The status the update changed this Digital Wallet Token to.
    - `timestamp` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the update happened.

## Other responses

- `4XX` — Error
- `5XX` — Error

## Changes

- **2026-09-26** `484949ba369c` — 1 warning
  - added the new `garmin_pay` enum value to the `token_requestor` response property for the response status `200`
- **2026-09-25** `ff98a6043c63` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/increase/apis/increase-api-2/changes/digital_wallet_tokens/:digital_wallet_token_id/transition/post.md)

---

[API](https://skmtc.dev/increase/apis/increase-api-2.md) · [All operations](https://skmtc.dev/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/increase/apis/increase-api-2/revisions/484949ba369c?raw)