My Profile_


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:

Processing Country Canada US Description
Processing Environment Test environment Production environment Test environment Production environment Distinguishes between the Moneris QA environment available for testing vs the live production environment which will connect to the live processing host.
Host URL esqa.moneris.com www3.moneris.com esplusqa.moneris.com esplus.moneris.com Indicates the host URL to connect to.
Port 22 Indicates the connection protocol.
Server Type SFTP using SSH2 Indicates the connection protocol.
Username If using a personal QA account, please click here to request your credentials. You can also use one of the existing stores with the following username

store3
Provided by Moneris. May be either the Moneris Store ID or Merchant ID. If using a personal QA account, please click here to request your credentials. You can also use one of the existing stores with the following username

monusqa002
Provided by Moneris. May be either the Moneris Store ID or Merchant ID. Indicates the connection username.
Password If using a personal QA account, please click here to request your credentials. You can also use one of the existing stores with the following password

store3
Provided by Moneris. If using a personal QA account, please click here to request your credentials. You can also use one of the existing stores with the following password

monusqa002
Provided by Moneris. Indicates the connection username.

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.
File Type File Type Description Request File Extension Request Sample Response File Extension Response Sample
CSV - Standard Request file is a CSV format standard transaction processing file. .csv Testing.csv .csv.out Testing.csv.out
XML - Standard Request file is a XML format standard transaction processing file. .xml Testing.xml .xml.out Testing.xml.out
CSV - VAU Request file is a CSV format Visa Account Updater (VAU) file. .csv.vau Testing.csv.vau .csv.vau.out Testing.csv.vau.out
CSV - ABU Request file is a CSV format Visa Account Updater (ABU) file. .csv.abu Testing.csv.abu .csv.abu.out Testing.csv.abu.out