Tokenizations
Tokenizations
Tokenizations
tokenizationsActivate a card tokenization
This endpoint is used to ask the card network to activate a tokenization. A successful response indicates that the request was successfully delivered to the card network. When the card network activates the tokenization, the state will be updated and a tokenization.updated event will be sent. The endpoint may only be used on digital wallet tokenizations with status INACTIVE, PENDING_ACTIVATION, or PENDING_2FA.
This will put the tokenization in an active state, and transactions will be allowed.
Reach out at lithic.com/contact for more information.
Deactivate a card tokenization
This endpoint is used to ask the card network to deactivate a tokenization. A successful response indicates that the request was successfully delivered to the card network. When the card network deactivates the tokenization, the state will be updated and a tokenization.updated event will be sent. Authorizations attempted with a deactivated tokenization will be blocked and will not be forwarded to Lithic from the network. Deactivating the token is a permanent operation. If the target is a digital wallet tokenization, it will be removed from its device. Reach out at lithic.com/contact for more information.
Pause a card tokenization
This endpoint is used to ask the card network to pause a tokenization. A successful response indicates that the request was successfully delivered to the card network. When the card network pauses the tokenization, the state will be updated and a tokenization.updated event will be sent. The endpoint may only be used on tokenizations with status ACTIVE.
A paused token will prevent merchants from sending authorizations, and is a temporary status that can be changed.
Reach out at lithic.com/contact for more information.
Resend activation code for a card tokenization
This endpoint is used to ask the card network to send another activation code to a cardholder that has already tried tokenizing a card. A successful response indicates that the request was successfully delivered to the card network.
The endpoint may only be used on Mastercard digital wallet tokenizations with status INACTIVE, PENDING_ACTIVATION, or PENDING_2FA. The network will send a new activation code to the one of the contact methods provided in the initial tokenization flow. If a user fails to enter the code correctly 3 times, the contact method will not be eligible for resending the activation code, and the cardholder must restart the provision process.
Reach out at lithic.com/contact for more information.
Simulate a card's tokenization
This endpoint is used to simulate a card's tokenization in the Digital Wallet and merchant tokenization ecosystem.
Unpause a card tokenization
This endpoint is used to ask the card network to unpause a tokenization. A successful response indicates that the request was successfully delivered to the card network. When the card network unpauses the tokenization, the state will be updated and a tokenization.updated event will be sent. The endpoint may only be used on tokenizations with status PAUSED.
This will put the tokenization in an active state, and transactions may resume.
Reach out at lithic.com/contact for more information.
Update digital card art for a card tokenization
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.