Upload supplementary data
Provide additional data to Stripe when migrating payment data.
Data encryption![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
For PCI data such as credit data, make sure you first encrypt the data with Stripe’s PGP key.
If you’re unfamiliar with the OpenPGP standard used in these encryption steps, download the GnuPG software.
Note
You can use Terminal or iTerm on Mac or Windows Terminal on PC instead for the command-line interface.
Save the non-encrypted data file on your desktop.
Zip the data file (we only support .zip or .tar.gz compression).
Download the Stripe public key from the Stripe website by copying and pasting the key into a .txt file. Save the .txt file with the filename Stripe_Import_Key.txt on your desktop.
Add the key to your list of known keys using your command-line interface:
- Navigate to your desktop:
cd ~/Desktop
. - Type the command:
gpg --import "Stripe Import Key"
. - Confirm the output matches:
cd ~/Desktop gpg --import Stripe_Import_Key.txt gpg: key 9C78B7620C1E99AD: public key "Stripe Import Key (PCI) <support-migrations@stripe.com>" imported gpg: Total number processed: 1 gpg: imported: 1
- Navigate to your desktop:
Verify the key with the command:
gpg --list-keys
.Encrypt the non-encrypted data file with that key:
gpg --recipient "Stripe Import Key (PCI)" --encrypt 20240418_
. The action returns an encrypted GPG file, such as 20240418_rocket_rides_cards.csv.gpg. The output looks like:rocket_ rides_ cards. csv gpg --recipient "Stripe Import Key (PCI)" --encrypt 20240418_rocket_rides_cards.csv gpg: 8A3B0AC7944266D9: There is no assurance this key belongs to the named user sub rsa4096/8A3B0AC7944266D9 2023-04-11 Stripe Import Key (PCI) <support-migrations@stripe.com> Primary key fingerprint: AEBF 7C48 38C4 4D2F DC99 A3F9 9C78 B762 0C1E 99AD Subkey fingerprint: 2100 F77A 7937 9D29 9C96 420B 8A3B 0AC7 9442 66D9 It is NOT certain that the key belongs to the person named in the user ID. If you *really* know what you are doing, you may answer the next question with yes. Use this key anyway? (y/N) y
Upload your encrypted file![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
The Stripe Data Migration team securely emails or texts your SFTP access credentials to you. You must log into you Stripe account and submit your migration request using the secure intake request form to obtain access credentials.
Save the file to upload on your desktop.
Navigate to the desktop in your command-line:
cd ~/Desktop
.Connect to Stripe’s SFTP server with the command:
sftp -P 22 <username>@sftp.
(wherestripe. com <username>
is the username provided by the Stripe Data Migrations Team).Provide your password when prompted, then press Enter.
Upload the file to the SFTP account with the command:
put <file name>
, where<file name>
is the name of the data file to upload, such as20240418_
.rocket_ rides_ cards. csv. gpg After you upload the file, you might not see the file in the folder, though it transferred successfully. You can view a successful status file under the upload-success directory.
sftp -P 22 username@sftp.stripe.com username@sftp.stripe.com's password: Connected to sftp.stripe.com. sftp> put 20240418_rocket_rides_cards.csv.gpg Uploading 20240418_rocket_rides_cards.csv.gpg to /20240418_rocket_rides_cards.csv.gpg 20240418_rocket_rides_cards.csv.gpg 100% 663 26.5KB/s 00:00