Your data belongs to you. That's why Braintree supports Credit Card Data Portability – we'll import your sensitive customer data into your new Braintree gateway, as well as export it if you ever need to leave.

Fees

None.

Time frame

10-15 business days.

Importing data

important

Braintree requires that all files be encrypted with our public key before being transmitted to us.

The easiest way for us to import your data from another gateway is for you to work with your current processor to provide us with an encrypted CSV file that includes at least the following fields:

  • Credit card number
  • Expiration date
  • ID value

That said, we know this doesn't cover every type of import. If you need to deviate from this standard approach, please contact our Migrations team to discuss options.

Once the import is complete, we will provide you with a logfile containing the customer IDs and payment method tokens that we created in your Braintree gateway. Each customer will be on its own row, and each card will be on its own row below the corresponding customer.

We ask that no more than 2 imports be required: one initial load of customer information, and another load of the delta while your processing was switched over. We import data Monday through Friday, 10am to 4pm CT (US) excluding holidays.

Braintree public key

When you send us your sensitive customer data, you'll need to use our public key below to encrypt all files.

  • Name: Braintree Data Migrations
  • Email: migrations@braintreepayments.com
  • Type: Public key
  • Key ID: 301DA1F7
  • Length: 4,096
  • Algorithm: RSA
  • Fingerprint: 868B 96E7 8458 E7A6 52E9 90A8 F6ED CCFE 301D A1F7
-----BEGIN PGP PUBLIC KEY BLOCK-----
Version: GnuPG v1.4.12 (GNU/Linux)

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
l3VRIN1tGVxUeYz2XEbNNn90LUsuuMFztWXf
=LVPD
-----END PGP PUBLIC KEY BLOCK-----

Exporting data

If you need to move your data to another payment gateway, you'll first need to provide Braintree with an attestation of their PCI compliance from a qualified provider. Once we have that, we'll request a public encryption key from the receiving service provider.

We'll then use the public key to encrypt the sensitive data and transmit it via SFTP, SCP, or FTP over SSL.

note

It is the responsibility of the receiving service provider to protect their private key file in accordance with the PCI DSS. Braintree will verify the authenticity of the public key before using it for encryption.

We ask that no more than 2 exports be required: one to export the bulk of your customers, and another to export any new customers created while your processing was switched over. We will not run any periodic exports for backup or failover — you will need to handle this on your side.

Export format

note

No modifications to this format can be made.

The export of your Vault records will be a GPG-­encrypted CSV file with a filename format like this:

MERCHANT_ID_export_DATE.csv.gpg

We'll include the following headers in the export. Each card will be on its own row, along with the corresponding customer and address. If a customer does not have any cards, the row will only contain customer information and empty fields for the card and address.

Click here to download a CSV with the headers you'll see in the export.

Header name Description Example
id The Braintree identifier for the customer. "123"
first_name The first name of the customer. "Jane"
last_name The last name of the customer. "Doe"
company The company specified on the customer. "Jane's Dough"
email The email address of the customer. "jane@example.com"
phone The phone number of the customer. May contain dashes and/or an extension. "312-555-1234"
fax The fax number of the customer. May contain dashes and/or an extension. "312­-555-­9876"
website The website of the customer. "https://www.janesdough.com"
credit_card.token The Braintree identifier for the credit card. "ab12d4"
credit_card.cardholder_name The cardholder name for the credit card. "Jane Doe"
credit_card.number The number for the credit card. "4111111111111111"
credit_card.expiration_month The expiration month, formatted as "MM", for the credit card. "01"
credit_card.expiration_year The expiration year, formatted as "YYYY", for the credit card. "2020"
credit_card.billing_address.first_name The first name associated with the credit card's address. "Jane"
credit_card.billing_address.last_name The last name associated with the credit card's address. "Doe"
credit_card.billing_address.company The company for the credit card. "Jane's Dough"
credit_card.billing_address.street_address The street address for the credit card. "123 Fake St"
credit_card.billing_address.extended_address The extended address for the credit card. This is also known as address 2. "Unit A"
credit_card.billing_address.locality The locality for the credit card. This is also known as the city. "Chicago"
credit_card.billing_address.region The region for the credit card. This is also known as the state. "IL"
credit_card.billing_address.postal_code The postal code for the credit card. This is also known as the zip code. "60601"
credit_card.billing_address.country_name The country name for the credit card. "United States of America"
credit_card.billing_address.country_code_numeric The ISO 3166­-1 numeric country code for the credit card. "840"
credit_card.billing_address.country_code_alpha2 The 2-­letter ISO 3166-­1 alpha­-2 country code for the credit card. "US"
credit_card.billing_address.country_code_alpha3 The 3-­letter ISO 3166­-1 alpha-­3 country code for the credit card. "USA"
credit_card.options.make_default The indication as to whether this credit card is the default for the customer. If a customer only has one credit card, this field will be "yes". "yes"
custom_fields.API_NAME The custom field value for the customer. There will be as many custom fields as there are in your Braintree Vault. "custom value"

Still have questions?

If you can’t find an answer, contact our Support team.


← Back to Previous Page