Recurring Token
Understand how recurring tokens work in Bamboo: reusable CommerceTokens linked to customers for one-click, recurring, and PCI-based payment flows.
A Recurring Token, also known as a Commerce Token (CT), is a reusable token that securely stores a customer's card information for future transactions. It is ideal for registered users, subscriptions, and one-click checkouts.
Unlike One-Time Tokens, CTs do not expire and can be used multiple times for authorized customers.
How to Generate a Recurring Token
Recurring Tokens are created when a customer adds a card using one of the supported tokenization flows.
A customer must be created first using:
- Create Customer
- Then retrieve the
UniqueIDusing Get Customer
There are two ways to tokenize a card for a customer:
Tokenization Form
Hosted form for capturing card data securely.
Include the customer.uniqueId to associate the token.
Direct Tokenization
Send the CustomerId in the API request to generate a reusable token.
Recurring Tokens require a valid customer record. Make sure the customer is created before invoking the tokenization.
How to Use the Recurring Token
Once generated, the recurring token must be sent in the Token field when creating a purchase.
Refer to Create a Purchase for full request structure and options.
If the issuer supports it, purchases can be made without CVV for stored cards, enabling one-click checkout experiences.
Best Practices
- Always retrieve the
CommerceTokenfrom the customer profile using the Get Customer API.- Never expose CTs in the frontend.
- Only use CTs with trusted customers and ensure data privacy.
- Validate expiration date before attempting a charge.
- Use the CVV Form if CVV is required for verification.
Next Steps
Create Customer
Create a customer profile to store reusable card tokens.
Get Customer
Retrieve customer details and associated payment profiles.
Delete Customer
Remove a stored card token from a customer profile.
Hosted Tokenization Form
Capture card data securely and associate it with a customer.
Direct Tokenization
Process card data directly from your backend and generate a CommerceToken (CT).
Create a Purchase
Process a purchase using a stored CommerceToken (CT).
Updated 4 days ago
