Connection

System Requirements

• You will require an SFTP client software which must use SSH2.
• If processing VAU or ABU:
  • Create and use GPG public and private key (encryption).

SFTP Batch Upload Setup Steps

1. Request credentials for your QA and/or production account. Click here to request your QA or production SFTP Batch Upload credentials.
   • Ensure you specify in the request if this is a standard SFTP account or for VAU/ABU.
   • VAU & ABU processing requires the merchant number for the username login as opposed to standard transaction processing files which use the Moneris Store ID as the username.
2. If processing VAU or ABU request files, ensure the VAU & ABU Steps have also been completed.

VAU and ABU Setup Steps

If processing VAU or ABU request files, ensure the following steps have been completed prior to uploading a request file for processing.

1. Create a GPG public and private key pair.
   1. Use the Moneris Merchant ID (Number) as the comment field.
   2. The comment field is a prompt when creating the key.
   3. For the test environment, please use your production merchant ID.
   4. Note for PGP users: The merchant ID will have to be added in the Full name field.
2. Export the public key in ASCII key file format and rename the file name extension .gpg (e.g merchant1.gpg)
3. Log into the Moneris SFTP account using your batch account username and password.
4. SFTP the public key into SFTP home directory on the Moneris server
   1. Moneris will use the public key to encrypt the response file
   2. Any new gpg public key uploaded to the Moneris server will replace the previous public key and will be used accordingly
   3. Please note that only the response file will be encrypted. The request file should not be encrypted.

File Upload Steps

There are some common steps for every Batch File upload process.

1. Establish an SFTP session with Moneris’ SFTP server host using your SFTP client software.
2. Log in using your Batch account username and password. Click here to request your QA or production SFTP Batch Upload credentials.
3. Upload the Batch File. When uploading a file it must be put in your default root directory.
   1. Do not put it in the processing directory – it will not get processed.
4. Wait approximately 2 seconds per transaction + 30 minutes or longer for processing.
5. Retrieve your response file from the /out directory.
   1. When a file is complete the response file will be put in the /out folder. The filename will be identical to what was uploaded but will have an extension “.out”.
6. For VAU / ABU files, decrypt the response file.

Connection Details

To connect to the Moneris Gateway SFTP server you will require the following:

Filename Conventions

When you are uploading a file the filename must conform to certain standards. Filenames that do not meet these requirements will not be processed.

1. The file name must be alphanumeric.
2. It cannot contain any spaces.
3. All file extensions must be lower case.
4. The applicable file extensions are listed below.
5. The below applies to both Canada and US.