Data Migration
When you switch to BlueSnap, you can bring any existing shopper data along with you, including credit card details. There's no need to recollect payment details and recreate shopper records. We work with your current provider to securely migrate your data so you never have to handle it yourself. If you ever decide to leave, we will export your data to another PCI Level 1 provider.
Importing data
Data import process
-
You request a data export from your current provider to BlueSnap.
-
You contact your BlueSnap Implementation Specialist about importing data from your current provider.
-
We work with your current provider to ensure data is kept secure:
- Your current provider verifies BlueSnap's Attestation of PCI Compliance (AOC), proving BlueSnap's compliance with the highest level of PCI security.
- Your current provider generates an encrypted CSV file so no clear text data is present.
- We provide SFTP login details to your current provider.
- Your current provider securely transfers data to BlueSnap via SFTP.
-
We import your data into your BlueSnap account. After the data migration is complete, BlueSnap will run an Account Update on all imported cards. There is a fee for this service but this benefits you by ensuring all cards are updated prior to any transactions.
-
You receive the data import results from BlueSnap.
-
You remap your shopper records according to their new IDs in BlueSnap.
BlueSnap Attestation of PCI Compliance
If your current provider needs to verify BlueSnap's AOC, contact your BlueSnap Implementation Specialist. They will supply your current provider with this information.
CSV file requirements
The most efficient way to import your data is to have your current provider generate a CSV file (encrypted using our public key) that complies with our field requirements and format requirements.
Field requirements
We encourage you to provide us with as much information as possible about your shoppers. At minimum, the fields listed in the following table are required:
Requirement | Card Data | ACH |
---|---|---|
Unique ID | ||
First name | ||
Last name | ||
Card number | ||
Expiration month (MM) | ||
Expiration year (YYYY) | ||
Bank account number | ||
Bank routing number | ||
Account type CONSUMER_CHECKING CONSUMER_SAVINGS CORPORATE_CHECKING CORPORATE_SAVINGS | ||
Company name For corporate accounts |
Format requirements
- Each card should have its own row.
- Each card should be associated with a shopper by the ID (even if the shopper has multiple cards).
BlueSnap public key
Your current provider can encrypt the CSV file with our public key:
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v2.0.22 (GNU/Linux)
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
EG+sbWxZ4VHv
=RJ46
-----END PGP PUBLIC KEY BLOCK-----
SFTP login credentials
After your current provider has generated the encrypted CSV file, they need to notify us and provide the following information:
- IP address for the source of the data transfer so we can whitelist this information in our firewall.
- Contact information for another communication form that we can use to share the SFTP login password. For example, a video conference tool or phone number.
After these details are received, we provide the SFTP login credentials.
Data import results
After the data is imported into your BlueSnap account, you will receive two files containing the results. No sensitive card data is contained in either file. One file includes the IDs for each shopper that was successfully created in your BlueSnap account, as well as the last four digits for each of their cards. You will need to remap your shopper records using this file.
The other file contains the shopper records that failed to import and failure reasons. You can use this file to investigate the errors and decide if you want to retry importing these records.
Remapping shopper records
Using the results file from the data import, you need to remap your shopper records according to their new IDs in BlueSnap. For example, your shopper John Doe has an ID of 12 on your side, which corresponds to an ID of 5332 from your previous provider. Now, John Doe has an ID of 9033 in your BlueSnap account. You need to update your database to associate John Doe's record with his new ID of 9033 in BlueSnap.
Working with subscriptions?
Set up plans and subscriptions with our Subscription Engine.
Exporting data
If you decide to leave, we securely export your data to another PCI Level 1 provider, ensuring that you don't have to handle the sensitive data yourself.
Data export process
-
You inform your BlueSnap Account Manager or Merchant Support that you want to export your data to your new provider.
-
We verify your new provider's Attestation of PCI Compliance (AOC), proving their compliance with the highest level of PCI security.
-
We obtain your new provider's public encryption key.
-
We generate an encrypted CSV file, using your new provider’s public encryption key so no clear text data is present.
-
We transfer the encrypted file to your new provider via SFTP.
-
You work with your new provider on next steps.
Export file format
The export of your shopper records is an encrypted CSV file. Each card has its own row and is associated with a shopper by the shopper's ID in your BlueSnap account.
Subscription data
Exporting existing subscriptions and importing them to your new provider is not supported. You can use the Reporting API or send a Retrieve all Subscriptions request to get a list of all your active subscriptions in BlueSnap. You can then work with your new provider to set up subscriptions using their capabilities.
Updated 12 days ago