Operating principle

The used file transfer protocol is SFTP.

In SFTP transactions, the payment gateway acts as the server, and the merchant website as the client.

The access to the directory where the files will be stored is protected by the username/password combination that was sent to you when the service was first used.

Persistent data

The files uploaded by the merchant to the FTP server or generated by the payment gateway are compressed after 7 days.

The .gz extension is added to the filename.

The files are definitively deleted as soon as their creation date exceeds 15 days.

This removal will always be initiated by the payment gateway.

The service is broken down into three phases:

Phase of scanning of the uploaded files

An automatic task allows to retrieve all the files uploaded to the FTP server in order to transmit them to the payment gateway for validation.

Validation phase

Several checkups are made before processing the files.

  • The naming rules specific to each file type must be applied. If there is a file that does not respect these naming rules, the validation process ends and the _ERROR suffix is added to the filename.
  • The file size is analyzed.

    If there is a file whose size is 0 bytes, the validation process ends and the _ERROR suffix is added to the filename.

  • The payment gateway records the processed valid filenames.

    If there is a file that has already been processed, the validation process ends and the _DUPLICATE suffix is added to the filename.

  • The files with a name that contains a _DUPLICATE, _ERROR suffix or the “.gz” extension are ignored.

Invalid files are stored in the depot folder until they are deleted by the merchant or automatically.

Processing phase

When a valid file is processed, the input file (REQ) is moved to the id directory.

A response file (ANS) is created in the id directory.

If an anomaly is detected while the files are processed, a warning e-mail is sent to the merchant.

Note

All the times indicated in this document are based on Paris local time.