Transferring through SFTP

Connecting and transferring a file as a Worldline merchant or Partner

There are many popular graphical SFTP clients including WinSCP https://winscp.net/eng/index.php and FileZilla https://filezilla-project.org/, as well as the command-line sftp command included with operating systems like MacOS, Windows, and Linux distributions.

Alternatively, SFTP uploads can be automated using most programming languages and a SSH/SFTP library (eg. Python's Paramiko library).

Worldline's SFTP service requires authentication using an SSH key, not a password.

Step 1:

Generate an SSH key using one of the following algorithms:

  1. ED25519: ssh-ed25519
  2. RSA: rsa-sha2-256, rsa-sha2-512
  3. ECDSA: ecdsa-sha2-nistp256, ecdsa-sha2-nistp384, ecdsa-sha2-nistp521

You can find information about SSH keys, including how to generate them using the link below:
https://docs.aws.amazon.com/transfer/latest/userguide/key-management.html

Step 2:

Let Worldline know you'd like to use SFTP to transfer beneficiary address information, and provide Worldline with the public portion of the key pair generated in step 1 (note: the key must be in PEM format)

Send an email to dl-integrations.na.isv@worldline.com requesting SFTP access.

This email must have the following information:

  • First Name, Last name
  • Merchant ID
  • Email Address – this needs to be the primary email on the account
  • Public SSH key

Note: If the email address provided is not the same as the primary email on file, consent to use the new one must also be given by email. 

Step 3:

Worldline will create an account specifically for you, and will provide to you the username and SFTP hostname

Step 4:

To upload files, connect to the SFTP server using your SFTP client, the username provided to you, and the private portion of the key pair generated in step 1

How to establish a connection using the command-line SFTP client in Windows, MacOS, or Linux:

Connect to the SFTP service using the hostname of the SFTP service, the username provided to the partner by Worldline, and the SSH private key that corresponds to the public key provided by the partner to Worldline. In this example, the private key file is located at ~/.ssh/id_rsa, the username is 123456789, and the SFTP hostname is bicfintrac.na.bambora.com.

$ sftp -i ~/.ssh/id_rsa 123456789@bicfintrac.na.bambora.com

If your private key was created with a passphrase, you'll be prompted by the SFTP client to supply it:

Enter passphrase for key '/Users/user/.ssh/id_rsa': <type passphrase if the private key has one>

Once connected, your current working directory will be your home directory:

Connected to bicfintrac.na.bambora.com.
 
sftp> pwd
Remote working directory: /

Use the SFTP put command to upload a file:

sftp> put 2023-11-01_123456789_TheMerchant_10000001.csv
Uploading 2023-11-01_123456789_TheMerchant_10000001.csv to 2023-11-01_123456789_TheMerchant_10000001.csv   100% 8KB   3.0MB/s   00:00

Connection closed error

$ sftp -i ~/.ssh/id_rsa 123456789@bicfintrac.na.bambora.com
 
kex_exchange_identification: Connection closed by remote host
Connection closed by 100.64.1.92 port 22
Connection closed


Solution:
 This error can be caused by a VPN such as Zscaler. Disconnect from your VPN to successfully establish an SFTP connection.

Was this article helpful?
0 out of 4 found this helpful