Sell memberships, subscriptions, or any service that bills on a schedule. The customer pays once through a normal checkout, Dintero tokenizes their card, and you use the token to charge them again without requiring another checkout. You manage the billing schedule on your server. Dintero handles the secure card storage and recurring charges.Documentation Index
Fetch the complete documentation index at: https://docs.dintero.com/llms.txt
Use this file to discover all available pages before exploring further.
Integration steps
Enable tokenization
Contact your Dintero account manager to enable card tokenization on your account. This is required before you can store card details for future use.
Collect payment and create a token
Create a checkout session with
generate_payment_token: true or generate_recurrence_token: true, depending on your payment provider and token type. The customer goes through the normal checkout flow, entering card details and completing the first payment.On success, Dintero returns a recurrence token or payment token alongside the transaction. The token type depends on your payment provider.See Create a token for the session configuration.Store the token
Save the token ID on your server, associated with the customer. This token represents the customer’s stored card and is used for all future charges.See Fetch and store tokens for how to retrieve tokens from the transaction.
Charge the customer on schedule
When a billing cycle is due, create a new checkout session with the stored token. The payment is processed server-to-server. The customer does not need to interact with a checkout page.If the charge fails (e.g., expired card, insufficient funds), you can notify the customer and prompt them to update their payment method through a new checkout session.See Use a stored token for the recurring charge payload.
Handle upgrades, downgrades, and cancellations
Subscription changes are managed on your server. To change the billing amount, adjust the
order.amount in the next recurring session. To cancel, stop creating new sessions.See the Subscription example for a complete walkthrough with tiered memberships.Token types
| Token type | Provider | Use case |
|---|---|---|
| recurrence_token | Swedbank Pay | Merchant-initiated recurring charges without customer interaction |
| payment_token | Swedbank Pay, Bambora, Dintero PSP | One-click payments and stored card charges |
What’s next
Tokenization overview
How card tokenization works, supported providers, and token types.
Create a token
Configure the first session to request a token.
Use a stored token
Charge a customer using their saved token.
Subscription example
End-to-end example with tiered memberships and upgrades.