​
Getting the Files

Before Primer can perform any token migration, we need access to the token files from your payment processor. There are two standard ways to transfer these files to us:
  1. The processor hosts the files on their own SFTP server, and Primer fetches them.
  2. The processor uploads the files to Primer’s SFTP server.
Our preferred approach is Option 1, where the processor hosts the files and Primer fetches them. This is faster and easier for us to manage, requiring minimal setup on our side. However, we understand this isn’t always possible, and we support both options.
The sections below describe how each approach works.

​
Option 1 (Preferred) - Processor hosts files on their own SFTP server, and Primer fetches them

If the processor hosts their own SFTP server, there are two supported authentication methods Primer can use to fetch the files:
  1. Processor shares SFTP login credentials using GPG encryption.
  2. Processor creates an SFTP account with the public SSH key that is shared by Primer.

​
Processor shares SFTP login credentials using GPG encryption.

In this approach, your processor will share SFTP login credentials using GPG encryption. The following are the steps:
  1. Processor encrypts credentials using Primer’s Public PGP key.
  2. Processor send the encrypted credentials to us via email or a secure channel
  3. Primer fetches the files

​
Primer PGP Key

If you’re unfamiliar with PGP keys, we recommend checking out GnuPG (GPG) and following these import instructions.
  • Key type: RSA
  • Key size: 4096 bits
  • Key ID: 3BFC42E548A5A06657452A42BA0C6B013C259DC9
-----BEGIN PGP PUBLIC KEY BLOCK-----

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

​
Encrypt and send your files

After importing the public key, run this command: 
gpg --encrypt --recipient 3BFC42E548A5A06657452A42BA0C6B013C259DC9 YOUR-FILENAME
This creates a file named YOUR-FILENAME.gpg which you can safely send us.

​
Processor creates an SFTP account with the public SSH key that is shared by Primer.

In this approach, Primer will share our public SSH key with your processor and they will share the SFTP login credentials with us. The following are the steps:
  1. Primer shares its public SSH key with the processor
  2. Processor creates an SFTP account with our public key and share the connection details with Primer
  3. Primer fetches the files

​
Primer Public SSH Key

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQD4qz8hS6Kku7RwHgcIybf4Xld9C7RWuw5x3q0Db7t3sWS70D0lB4ZhA+Uyy0nqMqHmXUXkuPiayxwUJ1IbVYJsupKUiPie+KwhZIRkODyC4R0F6bVsWP9V6gQ6Jo5A2GPR/pCVVWGU9MijyczBr3WTi+oITKFlgcC3Apw6hgoGKNK6nDC8JO45vg2vgnSvFkhfQYoyspg3V03C6o1YVy0Y9WGnT/74KwMJitxosffdZwxYGFIiT1c6X+Dx5mPtWPhweg2MJK5GaASZP53Ynnn9Axcgd+jg2iKfCATXpFHt1hvnZA3sbRj87eDFzLY0nRVoh8NYMnWau5ln7GCpC3U/PYBhqprpKpVlxNBgEGDyjqP0RUkwNYwxp1NIjarwwyvMUiR5hrX1RMvw2lulIvOthq9EyWxLpG+/3PgUHowCf/IuNoAdfqAztbyWz+Dp+IMBQI4mrXnIc4XgJoDiurjRtsQs+0drfv8BSA3+L9qNPDi77+/Pau2+cwYOxsI9TNs= token-import@primer.io

​
Option 2 - Processor uploads the files to Primer’s SFTP server.

If the processor is unable to host their own SFTP server, Primer can provide a SFTP server for them to upload the files. The following are the steps:
  1. Processor shares their public SSH key of their user uploading the file with Primer
  2. Primer will provision the SFTP account using the public SSH key provided
  3. Primer shares the SFTP credentials to the processor
  4. Processor upload the files to Primer SFTP server

​
After the Files Are Received

Once the token files are uploaded or fetched, Primer will begin the migration process. Once the migration is done, Primer will inform you of the results via Support Portal.

​
Questions

If you need help or have any questions, please contact our Support team.