The used file transfer protocol is SFTP.
In SFTP transactions, the payment gateway plays the role of the server, and the merchant website acts 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.
The files uploaded by the Merchant to the SFTP server or generated by the payment gateway are automatically compressed 7 days after their upload date.
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 the uploaded files
An automatic task allows to retrieve all the files uploaded to the SFTP server in order to transmit them to the payment gateway for validation.
The payment gateway processes the payment files transferred by the merchant website twice daily: once at 7 a.m. and once at 1 p.m., Europe/Paris time zone.
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 purged.
When a valid file is processed, the request 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.
All the times indicated in this document are based on Paris local time.