Home>Customer engagement

Export card on file data to third party payment processors

Who is this article for?
Only Square account owners can export cards on file to a third party payment processor.

About exporting card on file data

If you are moving from Square to another payment processor, Square can help migrate all of your customer card on file records from your primary account to your new provider.

Per PCI regulations, we can only directly transfer the data to another PCI DSS Level 1-compliant payment processor.

Before you begin

You can request to export card on file data by sending an email to our dedicated team noted below, then by confirming the ownership of your Square account over the phone. For a successful data migration, ensure you have your new payment processor's migration support email address.

You may also need to export your customer data to help your new payment processor map your card on file data to customer information. To export your customer data, log in to Square Dashboard, then click Marketing & loyalty > Customer directory > Import / Export > Export customers.

You can also work with your new payment processor to access your data via Square's public APIs.

This PCI-compliant process is for exporting card data only.

Export card on file data

To have your card on file data exported, follow these instructions:

  1. Send your export request with your Square merchant name and new payment processor's migration support via email to [email protected].

  2. A representative from Square will schedule a phone call with you to verify ownership of your account and confirm your request to export card data.

  3. Once we've verified ownership, Square will begin the process of exporting your customer card on file information. It may take up to two weeks to complete this process.

  4. Square will send an encrypted file to your new payment processor in the following CSV format (the “card_id” and “customer_id” refer to Square's ID for these entities):

card_id,pan,expiration,postal_code,customer_id
ccof:1,4111111111111111,2021-12,12345,square_customer_id_1
ccof:2,4111111111111111,2030-01,54321,square_customer_id_2

Related articles