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.