• France
Search
Categories
Tags
English
French
English
Implementation
Embedded form (cards)
REST payment API
Hosted payment
Push mail
File exchange
Mobile payment
Logos
Plugins
Back office
Guides
Helpers
FAQ
Support

Operating principle

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.

Persistent data

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 daily at the following times in the Europe/Paris time zone.
  • at 4:00 am, 5:00 am and 1:00 pm for the TEST files
  • at 4:00 am for all PRODUCTION files submitted before 4:00 am
  • at 5:00 am for all PRODUCTION files submitted between 4:00 and 5:00 am

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 request_ips folder until they are deleted by the Merchant or automatically purged.

Processing phase

When a valid file is processed, the request file (REQ) is moved to the result_ips directory.

A response file (ANS) is created in the result_ips 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.
© 2023 | All rights reserved to Systempay | legal
2.16.0-doc-1.8