Transfer Credit Card Tokens to Stripe
If you plan to transfer saved credit cards associated with your members, follow the steps below.
Initial Steps
Send a chat or email support@vinesos.com to confirm rates and initiate the process.
Hybrid Mode During Token Transfer
Ask for the token transfer with your old processor but do not ask to close your account. You will continue to process on the original processor before the tokens have been transferred. We will switch your account to hybrid mode so any new member signing up, or any card update will be sent to your new Stripe account instead of your current processor.
You will still be able to process both the old tokens on your current account, and the new ones on Stripe, but this way, you will not lose any new member signups while the token transfer process is happening.
Let us know as soon as you hear that tokens have been exported and ask us to proceed with your Stripe signup and to put your account in Hybrid mode.
Once that is completed, and we will switch your account to hybrid mode so any new member signing up, or any card update will be sent to your new Stripe account instead of your current processor.
HYBRID MODE - STEP 1: Tokens Exported by Old Processor
As soon as your tokens have been exported by your processor, and before they have been fully imported into Stripe, we will switch you into hybrid mode. This means that the following will start to process on Stripe:
new club signups will be tokenized on Stripe
online guest orders where there is no card on file will process to Stripe
Vines POS orders will process to Stripe
HYBRID MODE - STEP 2: Tokens Imported by Stripe
When your tokens have been imported, we can set your account to start processing the saved cards on file to the Stripe account. You may want to keep your former processing account open for up to 3 months or as long as you issue refunds so the refund can still go through. You will not be able to refund a customer on Stripe for an order that was processed on your old processor. The refund can only be done on the same processing platform, and so the account must remain open, unless you are able to refund by check to the customer, or issue a store credit. We can keep your account in Hybrid mode until you close the account so that refunds that were processed on the original processor can still be issued, but all new orders will be processed on Stripe. As soon as you have closed your old processor account, let us know and ask us to take you out of Stripe Hybrid mode.
FAQ's While in Hybrid Mode
How do I know if the order is going to Stripe or our old processor?
You can tell by the transaction ID. The Stripe Transaction ID starts with "pi_"
Here's an example of a non-Stripe transaction ID:
How soon does the transaction show up in Stripe?
The transaction shows up in Stripe immediately. There is no delay.
After we have transferred tokens, can we still do a refund?
After your tokens have been transferred from WorldPay or OpenEdge on VinesOS, if you try to refund an order that was processed on your old merchant account, it will fail UNLESS you keep your old merchant account open, and have the hybrid processing still enabled. This means that you can continue to refund older orders that were processed on the original merchant account, but all new charges and card entries will be done on Stripe. Refunds are normally allowed only for 45 days so we recommend leaving your old account open for 45 days if you have a lot of refunds to deal with normally. After you close your former merchant account, any refund for an older transaction that was processed on it will need to be managed separately, outside of Stripe. You could provide the customer with a credit using a one time coupon code, or you can issue a refund by check by mail (Note: this doesn't prevent the customer from disputing the charge with your former processor, and getting a double refund).
After we have transferred tokens, can we add a charge to an order that was processed on our former processor?
Surcharges for Orders on a former processor with tokens transferred over are not a problem. The surcharged amount WILL charge through Stripe. It is only refunds that can not be refunded on Stripe (since it is not where the funds were processed through).
We were told we had some expired cards, when will they be updated on Stripe?
If you authorized the update of cards that had expired, expired cards are not automatically updated upon completion of the migration, so these may show as expired currently in your account. They are updated in batches, so it's likely those expired cards will be selected for an update within the next handful of business days, though this is dependent on the card networks providing Stripe the updated information.
FAQs on Importing Tokens from OpenEdge & WorldPay
OpenEdge to Stripe
Member credit card transfer fees and process
OpenEdge charges a fee of approximately $500 for transferring tokens. One way to avoid that fee is to just set up your Stripe account (takes minutes and no approval process needed), and we can switch it to hybrid mode, where it will add any new member on Stripe and for any card that is updated it will update it to Stripe. If you are using the Vines POS for member pickups, it will alert you when the member is in that you need to swipe their card for Stripe. It would mean keeping OpenEdge open a month or so until all cards have been updated.
NOTE: You must signup from within VinesOS for your Stripe account. Do not signup from the Stripe page or your account will not be linked.
There are no documents to submit, the signup is directly from within VinesOS and is instantaneous, you simply complete a basic form with your business entity and bank account for deposits.
Review Stripe Terms. Send us a high-volume and low-volume recent merchant statement so we can do our best to match or beat your rate. After you receive your rate quote send an email to Support@vinesos.com with the Subject "REQUEST TO SWITCH TO STRIPE FOR VINESOS".
Make a request to OpenEdge to start the token transfer process. They will send you an estimate and then will ask for a file with your tokens. VinesOS will provide that for you. Let us know when you have made the token transfer request from OpenEdge we will start the process with Stripe. DO NOT close your OpenEdge account until we advise you to do so.
If you are moving to VinesOS from another processing platform: Ask your current vendor for a file containing just: stripe_customer_id and the unique customer ID that they use to recognize the member.
• old_customer_id — [the unique identifier used by your previous processor]
• stripe_customer_id — [that customer’s corresponding Stripe customer ID in cus_xxxx format]
Remove any other customer data from the spreadsheet and submit this to us at support@vinesos.com. It should be only those two columns of data.As soon as we have received the OpenEdge tokens we will switch your account over to start adding members with tokens created on Stripe, so we will then ask you to create your VinesOS Stripe account. DO NOT close your OpenEdge account until we advise you to do so.
If you are already processing on VinesOS, we will switch your account to function in a hybrid mode, where NEW member signups or NEW card updates will be sent to Stripe, and old cards can still be used and processed with OpenEdge so you don't lose new member data.
It can take several weeks for the token transfer process to complete. When we have completed the token import process on our end, we will switch the processing to Stripe from WorldPay. We will advise you when it is time to close your OpenEdge account.
WorldPay to Stripe
Member credit card transfer fees and process
WorldPay usually charges a $2,000 fee for transferring tokens. IF you have a large number of tokens and they give you a quote for more than this, and they tell you there are a lot more tokens than how many club members you have, ask us to help give you a set of tokens based on your export from your current provider, to bring the cost down. It is normally a minimum of $2,000.
One way to avoid that fee is to just set up your Stripe account (takes minutes and no approval process is needed), and we can switch it to hybrid mode, where it will add any new member on Stripe and for any card that is updated it will update it to Stripe. If you are using the Vines POS for member pickups, it will alert you when the member is in that you need to swipe their card for Stripe. It would mean keeping WorldPay open a month or so until all cards have been updated.
NOTE: You must signup from within VinesOS for your Stripe account. Do not signup from the Stripe page or your account will not be linked.
There are no documents to submit, the signup is directly from within VinesOS and is instantaneous, you simply complete a basic form with your business entity and bank account for deposits.
Review Stripe VinesOS Terms.
Send us recent high-volume and low-volume merchant statements so we can do our best to match or beat your rate. After you receive your rate quote, reply with "WE AGREE TO SWITCH TO STRIPE FOR VINESOS".
Contact WorldPay (call the number on your statement) and let them know you are switching vendors and need to export your tokens to Stripe. They will give you an estimate to get started. It can take several weeks or even more than a month or two for WorldPay to transfer the tokens to Stripe. Be very careful to instruct them clearly on the next step here, #6. IF this instruction is not provided, they may provide you with a download link for your members tokens, and there is nothing that we can do with that. We need them to follow the instructions below.
!!CRITICAL!!: Ask for the Data Transfer to go to Stripe. Tell them you do NOT want a download link with the tokens but to do the following:
The data from your WorldPay account must be encrypted with Stripe's PGP key and uploaded securely to the Stripe SFTP server. To securely share the SFTP account credentials, they will need to provide the PGP key. Please ask WorldPay to provide the PGP key for Stripe to use (They will know what this means). For the encryption of your data, Stripe's PGP key can be found here: https://stripe.com/docs/account/data-migrations/pan-import#migration-pgp-key
If you are a new client and importing to VinesOS from another processing platform: Ask your current vendor for a file containing just the customer_id and the unique customer ID that the former processor used to recognize the member.
• old_customer_id — [the unique identifier used by your previous processor]
• stripe_customer_id — [that customer’s corresponding Stripe customer ID in cus_xxxx format]
Remove any other customer data from the spreadsheet and submit this to us at support@vinesos.com. It should be only those two columns of data.As soon as we have received the tokens we will switch your account over to start adding members with tokens created on Stripe, so we will then ask you to create your VinesOS Stripe account. DO NOT close your WorldPay account until we advise you to do so.
If you are already processing on VinesOS, we will switch your account to function in a hybrid mode, where NEW member signups or NEW card updates will be sent to Stripe, and old cards can still be used and processed with WorldPay, so you don't lose new member data.
It can take several weeks for the token transfer process to complete. When we have completed the token import process on our end, we will switch the processing to Stripe from WorldPay. We will advise you when it is time to close your WorldPay account.