---
title: "digital_wallet.tokenization_updated"
method: POST
path: "digital_wallet.tokenization_updated"
tags: ["Event Types"]
---

# digital_wallet.tokenization_updated

`POST digital_wallet.tokenization_updated` (webhook)

Occurs when a tokenization's status has changed.

This event will be deprecated in the future. We recommend using `tokenization.updated` instead.

## Payload

- object
  - `event_type` 'digital_wallet.tokenization_updated', required — The type of event that occurred.
  - `account_token` string, required — Account token
  - `card_token` string, required — Card token
  - `created` string, date-time, required — Created date
  - `tokenization` Tokenization, required
    - `account_token` string, uuid, required — The account token associated with the card being tokenized.
    - `card_token` string, uuid, required — The card token associated with the card being tokenized.
    - `created_at` string, date-time, required — Date and time when the tokenization first occurred. UTC time zone.
    - `device_id` string, nullable — The device identifier associated with the tokenization.
    - `digital_card_art_token` string, uuid, nullable — Specifies the digital card art displayed in the user's digital wallet after tokenization. This will be null if the tokenization was created without an associated digital card art. See [Flexible Card Art Guide](https://docs.lithic.com/docs/about-digital-wallets#flexible-card-art).
    - `events` TokenizationEvent[] — A list of events related to the tokenization.
      - `created_at` string, date-time — Date and time when the tokenization event first occurred. UTC time zone.
      - `result` 'APPROVED' | 'DECLINED' | 'NOTIFICATION_DELIVERED' | 'REQUIRE_ADDITIONAL_AUTHENTICATION' | 'TOKEN_ACTIVATED' | 'TOKEN_CREATED' | 'TOKEN_DEACTIVATED' | 'TOKEN_DELETED_FROM_CONSUMER_APP' | 'TOKEN_INACTIVE' | 'TOKEN_STATE_UNKNOWN' | 'TOKEN_SUSPENDED' | 'TOKEN_UPDATED' — Enum representing the result of the tokenization event
      - `token` string, uuid — Globally unique identifier for a Tokenization Event
      - `type` 'TOKENIZATION_2FA' | 'TOKENIZATION_AUTHORIZATION' | 'TOKENIZATION_DECISIONING' | 'TOKENIZATION_ELIGIBILITY_CHECK' | 'TOKENIZATION_UPDATED' — Enum representing the type of tokenization event that occurred
      - `tokenization_decline_reasons` TokenizationDeclineReason[] — List of reasons why the tokenization was declined
      - `tokenization_tfa_reasons` TokenizationTfaReason[] — List of reasons why two-factor authentication was required
      - `rule_results` TokenizationRuleResult[] — Results from rules that were evaluated for this tokenization
        - `auth_rule_token` string, uuid, nullable, required — The Auth Rule Token associated with the rule. If this is set to null, then the result was not associated with a customer-configured rule. This may happen in cases where a tokenization is declined or requires TFA due to a Lithic-configured security or compliance rule, for example.
        - `result` 'APPROVED' | 'DECLINED' | 'REQUIRE_TFA' | 'ERROR', required — The result associated with this rule
        - `name` string, nullable, required — The name for the rule, if any was configured
        - `explanation` string, nullable, required — A human-readable explanation outlining the motivation for the rule's result
    - `status` 'ACTIVE' | 'DEACTIVATED' | 'INACTIVE' | 'PAUSED' | 'PENDING_2FA' | 'PENDING_ACTIVATION' | 'UNKNOWN', required — The status of the tokenization request
    - `token` string, uuid, required — Globally unique identifier for a Tokenization
    - `token_requestor_name` union, required — The entity that requested the tokenization. For digital wallets, this will be one of the defined wallet types. For merchant tokenizations, this will be a free-form merchant name string.
      - 'AMAZON_ONE' | 'ANDROID_PAY' | 'APPLE_PAY' | 'FACEBOOK' | 'FITBIT_PAY' | 'GARMIN_PAY' | 'GOOGLE_PAY' | 'MICROSOFT_PAY' | 'NETFLIX' | 'SAMSUNG_PAY' | 'UNKNOWN' | 'VISA_CHECKOUT' — Digital wallet type
      - string — Merchant name for merchant tokenizations
    - `token_unique_reference` string, required — The network's unique reference for the tokenization.
    - `dpan` string, nullable, required — The dynamic pan assigned to the token by the network.
    - `payment_account_reference_id` string, nullable — The network's unique reference for the card that is tokenized.
    - `tokenization_channel` 'DIGITAL_WALLET' | 'MERCHANT', required — The channel through which the tokenization was made.
    - `updated_at` string, date-time, required — Latest date and time when the tokenization was updated. UTC time zone.

## Acknowledgement `200`

Return a 200 status to indicate that the data was received successfully

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/revisions/53ab5d4e2adb/schema)