Guides
Start typing to search…

SFTP for migrating payment methods

Migrate payment methods to Rainforest via the Rainforest SFTP server

Rainforest can migrate payment methods from other processors by allowing the processor to upload migration files to Rainforest's SFTP server.


Access

Please reach out to support or your Platform Success Manager to gain access to Rainforest's SFTP server. Rainforest will create a user and provide a username once configured on our server.

SFTP Server Address: sftp.rainforestpay.com

Directory structure

The migration files should be placed at the home directory for the user, this appears at the root directory /.

File information

The file name should include the platform's name, for example: example-{{platform_name}}.csv.gpg

Once a file has been uploaded, the user cannot delete the file or other files within the directory. The files will remain in the directory until removed by Rainforest.

There are no file size limits or restrictions when uploading the file.


Authentication

Rainforest currently supports authentication via SSH key only. The user connecting to the SFTP server will need to provide an SSH public key to Rainforest that will need to be installed before the user can connect with their private key.

Example sftp command

sftp -i <path_to_private_key> <username>@sftp.rainforestpay.com

SSH public key requirements

Only SSH public key format is accepted. SSH2 keys should be converted to SSH.

Public keys can be sent to Rainforest via support as an attachment or inline in the email body.

Example public key

ecdsa-sha2-nistp521 AAAAE2VjZHNhLXNoYTItbmlzdHA1MjEAAAAIbmlzdHA1MjEAAACFBAHSTvZt1renWu7f+ExF5yvYpVpyOOdFy0EvCVMikmUnxxWbkyphZQjvnmEGxHItfdTS2Oizmo1Y72aUUioypSzrLgFQd+DUHcdaDV36FLeYYSrjUpNy6t0VHZZldYqOAKqqmeRTbVyZTwxyf7my83m8ZgBqxEhkX4CNna7Bm5PNKSh/wg== [email protected]

Creating SSH keys on macOS, Linux or Unix

Creating SSH keys on Microsoft Windows

Recent versions of Windows include OpenSSH by default, so keys can be generated using the Windows PowerShell or Command Prompt

  • ssh-keygen -t rsa -b 4096 -f key_name
  • ssh-keygen -t ecdsa -b 521 -f key_name
  • ssh-keygen -t ed25519 -f key_name

If using an SSH client such as PuTTY or WinSCP, please use a tool such as PuTTYgen to generate an SSH key pair. There is an example via ssh.com here.

Converting SSH2 keys to SSH public key

  • ssh-keygen -i -f ssh2-key.pub > ssh-key.pub

SFTP client requirements

Popular SFTP clients for Windows and macOS operating systems:

Windows

  • WinSCP
  • FileZilla
  • Cyberduck

macOS

  • Cyberduck
  • FileZilla
  • Commander One

To connect to the Rainforest SFTP Server, please make sure the client you are using supports the following:

  • SSH Ciphers
  • SSH Kexs
    • ecdh-sha2-nistp256
    • ecdh-sha2-nistp384
    • ecdh-sha2-nistp521
    • curve25519-sha256
    • [email protected]
    • diffie-hellman-group18-sha512
    • diffie-hellman-group16-sha512
    • diffie-hellman-group-exchange-sha256
  • SSH Macs
  • Content Encryption Ciphers
    • aes256-cbc
    • aes192-cbc
    • aes128-cbc
    • 3des-cbc
  • Hash Algorithms
    • sha256
    • sha384
    • sha512
    • sha1
  • TLS Ciphers
    • TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256
    • TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256
    • TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256
    • TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256
    • TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384
    • TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384
    • TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384
    • TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384

Updated 3 days ago