Tokenization

Update digital card art for a card tokenization

Changed on

This endpoint is used update the digital card art for a digital wallet tokenization. A successful response indicates that the card network has updated the tokenization's art, and the tokenization's digital_cart_art_token field was updated. The endpoint may not be used on tokenizations with status DEACTIVATED. Note that this updates the art for one specific tokenization, not all tokenizations for a card. New tokenizations for a card will be created with the art referenced in the card object's digital_card_art_token field. Reach out at lithic.com/contact for more information.

post/v1/tokenizations/{tokenization_token}/update_digital_card_art

Request

  • Base URL
    https://sandbox.lithic.com
  • URL
    https://sandbox.lithic.com/v1/tokenizations/{tokenization_token}/update_digital_card_art
  • Auth
    API key in header Authorization

Path parameters

tokenization_tokenstring uuid required

Tokenization token

Request body

digital_card_art_tokenstring uuid

Specifies the digital card art to be displayed in the user’s digital wallet for a tokenization. This artwork must be approved by the network and configured by Lithic to use. See Flexible Card Art Guide.

Example request

{
  "digital_card_art_token": "5e9483eb-8103-4e16-9794-2106111b2eca"
}

Response

Card art successfully updated at the network and Lithic levels.

account_tokenstring uuid required

The account token associated with the card being tokenized.

card_tokenstring uuid required

The card token associated with the card being tokenized.

created_atstring date-time required

Date and time when the tokenization first occurred. UTC time zone.

device_idstring nullable

The device identifier associated with the tokenization.

digital_card_art_tokenstring 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.

status'ACTIVE' | 'DEACTIVATED' | 'INACTIVE' | 'PAUSED' | 'PENDING_2FA' | 'PENDING_ACTIVATION' | 'UNKNOWN' required

The status of the tokenization request

tokenstring uuid required

Globally unique identifier for a Tokenization

token_unique_referencestring required

The network's unique reference for the tokenization.

dpanstring nullable required

The dynamic pan assigned to the token by the network.

payment_account_reference_idstring 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_atstring date-time required

Latest date and time when the tokenization was updated. UTC time zone.

Changes

  • cfbca12dc3e6Revision changes
    • warning

      added the new INVALID_PAN enum value to the /// response property for the response status