Modalités d’échange

Nommage

Les fichiers sont traités dès réception sur le serveur, au rythme d’une vacation tous les ¼ d’heure.

La convention de nommage d’un fichier de demande de paiement est la suivante :
<SSAAMMJJ>.<siteID>.FPS.REQ.<z>.<xx>.crypted.<keyAlias>
Le fichier de réponse associé (en clair) sera nommé de la manière suivante :
<SSAAMMJJ>.<siteID>.FPS.ANS.<z>.<xx>
Où :
  • <SSAAMMJJ> représente la date de génération du fichier.
  • <siteID> représente le numéro de boutique qui vous a été attribué.
  • <z> prend soit la valeur « T » pour un fichier en mode TEST, soit la valeur « P » pour un fichier en mode PRODUCTION.
  • <xx> correspond au numéro séquentiel du fichier dans la journée, sur 2 caractères numériques.
  • <keyAlias> représente le nom du certificat courant : pftNN avec NN la version courante du certificat. (PFT= PAN File Transfer)

Cryptage

  • Le logiciel de cryptage sera OpenSSL version 1.0.1c ou supérieure.
  • Le format de cryptage sera SMIME. La commande de cryptage sera la suivante :
    Openssl smime -encrypt -aes256 -in YYYYMMDD.{siteId}.FPS.REQ.{z}.XX -out 
YYYYMMDD.{siteId}.FPS.REQ.{z}.XX.crypted.pftNN pftNN.pem

    Avec pftNN.pem le certificat, NN la version utilisée du certificat.

  • Un certificat est valide 12 mois. Au-delà de ces 12 mois, il ne pourra plus être utilisé pour la fonction.
  • Au début du 11ième mois, une nouvelle clé sera disponible à l’url de récupération du certificat et pourra être utilisée dès sa publication.

    Le lien vers la dernière clé est : https://paiement.systempay.fr/doc/certificates/pft.html

  • Clic droit « Save as » pftNN.pem, peut être renommé pftNN.crt pour être visualisé sous Windows par double-clics. La version NN est donnée par l’URL sur laquelle le lien précédent redirige.
  • Pendant un mois environ, l’utilisation de l’ancienne et la nouvelle clé est supportée.