Skip to main content

Tokenization System

The Purse Vault System allows customers to securely save their payment details and reuse them for future transactions.
This eliminates the need to re-enter payment information, creating a faster, more convenient checkout experience.

This process, known as Tokenization, ensures security and compliance while enhancing user experience.

How It Works

Configure the Wallet System

Before enabling the Tokenization System, ensure that your desired Entity is properly configured.

To do this, contact the Purse Integration Team, who will assist in setting up your wallet system.

Enabling Payment Data Storage

To allow customers to save and reuse their payment details, you need to activate tokenization in the Purse Dashboard:

  1. Navigate to Experiences - Solutions.
  2. Select the payment solution of your choice.
  3. Enable the relevant checkboxes:
    • save token → Allows customers to save their payment details.
    • payment with token → Enables customers to pay using previously saved tokens.

Once enabled, Purse will generate a payment token stored securely in the wallet.
The next time a customer checks out, the widget will display their saved payment methods.

Checking if the tokenization worked

Once tokenization is activated, Purse will automatically store payment details in the system.

To verify that tokenization works correctly:

  1. Complete a payment while saving the token.
  2. Create a new session

If successful, you should see a saved token similar to the following example:

Token Scope

Each payment token has a token scope, defining where it can be used:

  • solution → Usable only for the same partner and method.
  • partner → Usable across all payment methods from the same partner.
  • method → Usable for all payments made with the same method (e.g., credit card).

If you need custom configurations, contact the Purse Integration Team.

Additional Features

Deleting a Token

Customers can delete their saved payment methods directly in the checkout widget by clicking the delete icon displayed next to the token.

Renaming a Token

To personalize their saved payment methods, customers can rename their tokens:

  • Clicking the edit icon next to a token will open a name input field.
  • This feature can be disabled using the useTokenName option in the Widget Layout Configuration.