Data Migration

When you switch to BlueSnap, you can bring any existing shopper data, including their credit card details, along with you. 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

  1. You request a data export from your current provider to BlueSnap.

  2. You contact your BlueSnap Implementation Specialist about importing data from your current provider.

  3. We work with your current provider to ensure data is kept secure:

    3.1. Your current provider verifies BlueSnap's Attestation of PCI Compliance (AOC), proving BlueSnap's compliance with the highest level of PCI security.

    3.2. Your current provider generates an encrypted CSV file so no clear text data is present.

    3.3. We provide SFTP login details to your current provider.

    3.4. Your current provider securely transfers data to BlueSnap via SFTP.

  4. We import your data into your BlueSnap account.

    Once 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.

  5. You receive the data import results from BlueSnap.

  6. 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. However, at a minimum, the following fields are required.

RequirementCard DataACH

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 use our public key below to encrypt the CSV file.

-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v2.0.22 (GNU/Linux)

mQINBGPr1wYBEADFiVnVY8AurPUDTMi+g69/iIx+Pft+pgioAT+FapmdHQMwltRd
dNHjyMqrjeRRMiaAcnMXFCpdLrUKsDHChwBNAxCcLbjMbHfBJlJhbYgN0VDlteO3
vQTejawowqpsJUZSGMxR7E/EGBR5GJLV+9MmRqyJWnXU6H8bbV1ARBuL1WAR6d9c
GKw3ybTQXu73X42FDBJP84EbniWIoI/TKsnCoSWzK/J+4jJhZFIlfUFI6HIeX8qh
q0Tt9mNqKBVf8v4g6imZQYcKF6QUqyFysmYjk4wn2wWb65/iU+bhuzfC1a6nSMnP
LPbqZhtFtkwwLP43DylHt+OQGbodzPrAFQD2YSTRWVkc3YvkII9RXBt86DVTzimg
yIkNu80s2XU3IXJPv/fyp56xmE1NxuZYRIy08/4+1JBBTg06t+T4A16lY1wI9+5j
dbuPrUdsblCwd21nKRyW0aStW74iUaAO6oe7XXNZmmQrDhQkiLLMhphZcWBmZcHc
nqr32HWIm1MqYD1QnLJl/7ce5eB8zQCcvLdvX1tf9DHX4JZg6jrqYjdieCYnQALg
5Q59jxfJbE/kN42IP3+D1JRjm5RYdRYn6xru9S1DOK7OrwnwsOY5OsljrIjZCNw+
EKlmUXPJTPcLhg5nA2kInYYzZ4YBU+R7GYq2+5NV7CgXC26kepDnJsgyPQARAQAB
tB1CbHVlU25hcC1JVCA8SVRAQmx1ZXNuYXAuY29tPokCPwQTAQIAKQUCY+vXBgIb
AwUJA8JnAAcLCQgHAwIBBhUIAgkKCwQWAgMBAh4BAheAAAoJEGKu64u+4weeQTIQ
AIJiHPfZ7/PzvMgpyIwdz7/AQ77F+ZhFHOKkrC1sVEQgN1bA+r3QwbBM7FePdX/f
EKyYO9iHKmYf6cQigjkWYumSnDXWFSyuphMld/flAjubVK+aDAMZurdXPDd0RG3q
xBhZLkevU3WWNN85ZBudv336XxhWlVbfBow19JroMGYrQwZIh1xaTubj5UUZnYIa
JKVo9HuZg2YA5mrCsH2myjJqjq4Kdc9IMkXKKjpT49CWdedd9yrE7v45SHNyWlFb
DGmFQIRP+TsXvA0Yt6oAYfSNBu74pEtdB2fWUK5q2sqt7fj+uBnGR8FbKrubwVYy
SI2pV/VQ4QMjGDe7W2n/0h2oJbpsB97ZyOHjeTpDlp/WuE/54FaU8Knbjtxg+z8B
L0WXalZkaWyYOWKfTd/5sGp57cjF4BdCRD7daBXMpBVbceSgsv2U02KdVvsywXY3
/toUwu/8Se2UkNxj0LVAbTlxk7O9QgIVBQwSuYUBeaQXjKMrHGmgfEqqux9/adZl
gFuDwiILzur+R/3IHGLxUB5X1o9Zyt7QN7NIQ7D768ePpNCCN7GC6rI9r+kXRO2B
Tcab8BM3XlOXt27rBQZ527qmiFSCy18Lgh4g2qX4GXBWfmLh2D9+p1k0ZdumOjci
E5YDQRKE58OYi70U/eCIfaO4KAwpVWMYg2WjZtotFecHuQINBGPr1wYBEACzdAJM
quI70eQJ/qQnzbpcWP/+mRCmN5v62tzhkycbdChkMPJdgI6y9/mSY/9Y7KRZ9IZi
DLT1QEHBwAgsqcZkXCXO9LCLwrtul1LSkMZ6GswZOuhnwHCNP87ShhiWre7Zf9df
yJq4/oo/Y7JnhX9WI+b306g4TfELN2dBQoljT2D7j7SfKJvDMAGjYSD4BFYd4k0G
48sq0p35TzDOzKvBzZai7oKEhf6KALRGRgF7Pswc2LGWQKd/ESneA8QGfFFoWbuY
TWB3QmJPZ/je9SMMpGzeoIE2jCv/ABWQd2hp35/XORalyMidOEHC0Z18nwIf3PJI
1MMxUKLOAojE+rwLB4j3YlddLURFvvHz3AIxss7pFspwqQ5F2wQ9zmgKJ49AdTva
XF0XHGnY6jEc5SMiJWFUnxClvN0W4MT3lfPRPtGrxk5MIFGmETHLvDBaGbZ7qdh1
1H+QZ7hy3U8cNmsofLgzuLLX2R0RHK0qO1C+NNZbcNEe9hjwOyvwadndCQyuWnZA
fN+eZfEr9byCjAxOVdhjfd3CgyBXpM0kbLGrnDPH6n4R2FC9ojOEoTmDiOVahjMU
/6oJ7A+abLSxIw3L0xMSDewzNRM9wHHy5+A9/45H2TZ7zQ9uNGljlmHXHa2LSizZ
zh2DY22yJ0WrhzIVB70wiW+VlhbdBv/8IIKrHQARAQABiQIlBBgBAgAPBQJj69cG
AhsMBQkDwmcAAAoJEGKu64u+4weeB5oQAIHAPm1vgzkYCd8c+9vq5yzaKU9PdGNj
tPqDdkLZRly5VKYcE4TjAsXRhWfDpqxzGuwSa8t/Um6nl7uI0zZUwtFyxY2iUH1P
xL9x5eNbKJshT753w3aax3RJYD3l7otOeoy+ztbomkEEG8wM4wm8dii4Z9AfD52H
oeIjJreN1OmCSY+NJbTZL+KOVpADOyqCUMZpsLIC33Rq+BN+sClfn2ZGeN1EANIo
AK+mel2Oj+/4WTYs0QsiYNkGfj1syuWJoRG6E7nae1rFFWaw1dFMK5QRjp+XREYi
A9rS0/efyUDqq2DhVVTzAkJkvEW+8tW+xQ4Z05R4D1WGvtTdKbg6ymdzBMu1kXGR
vOGZXTt4aO32QUNq5Smhb371ofybMIl/sQpmVznNOI3+L1jIOQ0SFFeGVPqe0KLO
QYV9NvaCIuQXmDcfStm20CqYhKYWLuCuDVAj6cc5zarUOVIgrfzBTq4Bhzo8KXF4
iS4Dm1WL2zSBfR0N5kGTlHTzGPBug21Uoco0p1jwCqSs49wABeqm47LzS81Gzta3
hn2uaGFJQ80+VeUaLrmEFf9Hntuy7RqETY0PskXJK7Pk+tCLZSua+Vx2WHi/C0r6
GubdaIHRQMcHlI9EEckEVnssOYofMbjT9kzNyjUjDPBcTmkjOg2vWqNzHhm8DF6U
EoHQrP7Kd/rX
=REvN
-----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, such as Skype or phone, through which we can share the SFTP login password.

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 second 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 would like 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?

Use our Subscription Engine to set up plans and subscriptions.


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

  1. You inform your BlueSnap Account Manager or Merchant Support that you want to export your data to your new provider.

  2. We verify your new provider's Attestation of PCI Compliance (AOC), proving their compliance with the highest level of PCI security.

  3. We obtain your new provider's public encryption key.

  4. We generate an encrypted CSV file, using your new provider’s public encryption key so no clear text data is present.

  5. We transfer the encrypted file to your new provider via SFTP.

  6. 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.