What is the process to vault a payment method?
When a payment method is entered into Tilled.js, the raw data passes directly into our vault, and Tilled.js returns a payment token to be passed in a call to our API. Tilled’s documentation may use the terms “vault” and “tokenize” interchangeably. A vaulted payment method will not persist in our system unless it has been attached to a customer.
When a payment method is created, a created_at
and expires_at
value will be provided in the response. A card
has a 5-minute validity period, while an ach_debit
has a 15-minute validity period. However, payment methods will not expire once they have been attached to a customer, allowing them to be reused in multiple payment intents.
Card-present
Card-present payment methods can also be attached to a customer for future use. It is important to understand these two differences when vaulting card-present payment methods:
- Vaulted
card_present
payment methods are not eligible for Card Account Updater, because the raw card details are stored at Valor. - When a vaulted
card_present
payment method is used, it will always look like acard_present
transaction in the consoles, since thepayment_method_type
on the Payment Intent will becard_present
.