• France
état des services
Back Office Marchand
assistance
FAQContacter le support
Tutoriels vidéo
Rechercher
Catégories
Tags
Français
Français
Anglais
Accueil
Cas d'usage
Créer un paiement
Créer un paiement en plusieurs fois
Proposer un paiement complémentaire
Créer un paiement par alias (token)
Créer un lien de paiement
Créer un abonnement
Gérer vos abonnements
Gérer vos transactions (rembourser,...)
Analyser vos journaux
Docs API
Formulaire embarqué
API REST
Formulaire en redirection
Intégration mobile
Échange de fichiers
Exemples de code
Logos
Push mail
Moyens de paiement
Modules de paiement
Guides
Back Office Marchand
Guides fonctionnels

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.
© 2025 Tous droits réservés à SystempayMentions légales
25.25.0-1.11