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.
Generate an SSH key using one of the following algorithms:
- ED25519: ssh-ed25519
- RSA: rsa-sha2-256, rsa-sha2-512
- 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:
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 email@example.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.
Worldline will create an account specifically for you, and will provide to you the username and SFTP hostname
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.
If your private key was created with a passphrase, you'll be prompted by the SFTP client to supply it:
Once connected, your current working directory will be your home directory:
Connected to bicfintrac.na.bambora.com.
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 firstname.lastname@example.org
kex_exchange_identification: Connection closed by remote host
Connection closed by 100.64.1.92 port 22
Solution: This error can be caused by a VPN such as Zscaler. Disconnect from your VPN to successfully establish an SFTP connection.