Card Migration
Card migration lets your organization move stored payment accounts from one payment processor to another. Use this workflow when switching processors to ensure guests' stored accounts are transferred without requiring them to re-enter their card details.
Audience: Organization administrators who manage payment processor configuration.
Who runs it: The Card migration console (Configuration > Payments > Process payments > Card migration) is available only in a Zenoti support session; it does not appear for a customer login. Zenoti Support runs the migration with you, so the steps below describe what to prepare and what Support works through.
Before you begin
- Both the source and target payment processors must be configured in Zenoti before the migration is initiated. For processor setup, see Set up a payment processor.
- Stored accounts must exist in the source processor before a migration batch can be created.
- Card migration is a one-time operation per processor transition. Plan the migration during a low-activity period to minimize disruption.
Important: Card migration re-tokenizes stored accounts with the new processor. Guests are not notified during this process. Verify that the target processor supports stored accounts before proceeding.
Steps
Request and initiate a card migration batch
- Contact Zenoti Support with the source processor, the target processor, and the centers in scope, and agree a low-activity window.
- In the support session, Support opens the Card migration console and selects New Card Migration.
- Support reviews the source and target processor details with you and starts the batch (Start Migration).
The system creates a migration batch and begins processing stored accounts from the source processor. Each stored account is re-tokenized with the target processor.
Monitor migration progress
Support opens Migration Reports on the console to view the status of active and completed batches and shares it with you.
Review the batch status summary. The following statuses may appear:
Status Description Pending The batch has been created and is queued for processing. In Progress The system is actively re-tokenizing stored accounts. Completed All accounts in the batch have been processed. Failed One or more accounts could not be migrated. Review the results for details. Support refreshes the status display until the batch completes.
Review migration results
- Ask Support for the completed batch's Migration Reports entry.
- Review the per-account results Support provides.
- Review any accounts that failed to migrate. Failed accounts retain their original stored account details in the source processor and will not be available in the target processor.
- For failed accounts, note the guest name and contact the guest to collect updated payment details if needed.
Note: Guests whose stored accounts failed to migrate will need to provide their card details the next time they make a payment. Front desk staff can add a new stored account at that time.
Tips
- Run card migration during off-peak hours to reduce the impact on active transactions.
- Before initiating migration, confirm with your target processor that stored account tokenization is supported for your region and card types.
- After migration completes, verify a sample of guest profiles to confirm stored accounts appear correctly under the new processor.
- Keep a record of the migration batch results in case you need to follow up on failed accounts.
Troubleshooting
| Problem | Resolution |
|---|---|
| You cannot find a Card migration page in your Zenoti login | The console is available only in a Zenoti support session. Contact Zenoti Support to schedule the migration. |
| Migration batch status remains Pending for an extended period | The batch may be queued behind other operations. Ask Support to refresh the status; if it does not change after several minutes, Support investigates the queue. |
| A large number of accounts show Failed status | Verify that the target processor is active and that stored account support is enabled. Check that the processor configuration is complete before retrying. |
| A guest's stored account is missing after migration | The account may have failed during migration. Review the migration results for that guest and ask the guest to provide their card details at their next visit. |