Skip to main content

​
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

​
Encrypt and send your files

After importing the public key, run this command:
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

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