When moving to a new Stripe account, please follow this article to ensure a smooth transition.
Kolleno uses the Stripe customer ID mapping file to correctly reconcile customers once your new Stripe account is connected.
Key Behaviors During Migration
Customer IDs
Customer IDs remain identical when using Stripe’s native migration tool.
A CSV is not required unless you’ve completed a non-standard migration.
Migrating to a New Stripe Account Using an Existing Kolleno Account
This process keeps the Kolleno account unchanged while replacing the Stripe account.
Disconnect the Existing Stripe Account
Completed by the user.Disconnecting removes all saved payment methods and customer links.
Payments will be unavailable until the new Stripe account is connected.
Send a customer-to-Stripe mapping CSV to Kolleno (completed by the user)
Done by User and Kolleno Support.
After disconnecting Stripe, send us a CSV file in the following format.
Example CSV content:
customer_identifier,stripe_customer_id
REF-001,cus_123456789
REF-002,cus_987654321
REF-003,cus_555666777Note: Within Kolleno the Stripe account ID and customer ID will be concatenated.
What Kolleno will do with the provided file?
Kolleno will update the
stripe_customer_idfield for matched customers.Existing Stripe payment methods (cards and direct debits) will be marked as deleted.
A background task will be queued to refresh payment methods from Stripe.
Connect the New Stripe Account
Completed by the user
From Kolleno Settings.
This allows Kolleno to access the new Stripe customers and payment methods.
For more information on managing your Stripe settings, refer to the rest of the articles in the Stripe collection.