• France
état des services
Back Office Marchand
assistance
FAQContacter le support
Video tutorials
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

Format V4

L'enregistrement « TITRE »

Pos. Description Valeurs
01 Code d'enregistrement TITRE
02 Libellé de la boutique tel que défini dans le Back Office Marchand. Ex : DEMO Store
03 Date et heure UTC de l'envoi (AAMMJJ_HH:MM:SS) 200113_02:05:00
04 Version TABLE_V4

Les enregistrements « ENTETE » et « DETAILS »

Pos. Description
01 ENTETE

Type : VARCHAR | Longueur : 9

Description : Code d'enregistrement.

Valeur : toujours valorisé à OPERATION

02 MERCHANT_COUNTRY

Type : VARCHAR | Longueur : 2

Description : Code pays de la société (norme ISO 3166-1 alpha-2).

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : FR pour la France.

03 MERCHANT_ID

Type : VARCHAR | Longueur : 255

Description : Identifiant légal de la société.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :

0+Identifiant légal

(Identifiant légal = SIRET (Système d'Identification du Répertoire des Etablissements))

Ex : 045251785700028

04 PAYMENT_DATE

Type : DATE | Longueur : 8

Description : Date du paiement dans le fuseau UTC.

Équivalent API Formulaire : vads_effective_creation_date

Équivalent API REST : creationDate

Ex : 20200110

05 TRANSACTION_ID

Type : VARCHAR | Longueur : 255

Description : Identifiant de la transaction.

Équivalent API Formulaire : vads_trans_id

Équivalent API REST : cardDetails.legacyTransId

Ex : xrT15p

06 OPERATION_SEQUENCE

Type : NUMERIC | Longueur : 1

Description : Numéro de l’opération. Ce champ est toujours valorisé à "1".

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeur: 1

07 OPERATION_NAME

Type : VARCHAR | Longueur : 255

Description : Typologie de l’action effectuée.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :
  • AUTHOR : Autorisation d’une transaction (dans le cas des paiements différés)
  • CANCEL : Annulation de la transaction
  • CREDIT_CAPTURE : Remise en banque d'une transaction de remboursement
  • DEBIT_CAPTURE : Remise en banque d'une transaction de débit
  • DUPLICATE : Duplication d'une transaction
  • CREDIT : Remboursement d'une transaction
  • EXPIRED : Expiration d'une transaction
  • MODIFICATION : Modification d'une transaction
  • TRANSACTION : Enregistrement d'un paiement manuel
  • TRANSACTION_WITH_MANUAL_VALIDATION : Enregistrement d'un paiement manuel avec validation manuelle.
  • VALIDATE : Validation d'une transaction
  • RAPPROCHEMENT : Rapprochement d'une transaction
  • VERIFICATION_REQUEST : Demande de vérification du moyen de paiement.

Ex : CREDIT

08 OPERATION_AMOUNT

Type : NUMERIC | Longueur : 13

Description : Montant de l’opération exprimé dans la plus petite unité de la devise.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 4525 pour 45,25 EUR

09 OPERATION_CURRENCY

Type : NUMERIC | Longueur : 3

Description : Devise de l’opération.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 978 (Voir chapitre Liste des devises supportées)

10 OPERATION_DATE

Type : DATE | Longueur : 6

Description : Date UTC de l’opération au format YYMMDD.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 200112

11 OPERATION_TIME

Type : TIME | Longueur : 6

Description : Heure UTC de l’opération.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Ex : 121327

12 OPERATION_ORIGIN

Type : VARCHAR | Longueur : 255

Description : Identifiant de l’utilisateur ayant réalisé l’action.

Valorisé à "BATCH" s’il s’agit d’une traitement automatisé.

Ex : BATCH

13 RESPONSE_CODE

Type : NUMERIC | Longueur : 2

Description : Code retour de l'opération demandée.

Pour plus de détails, consultez le paramètre BANK_RESPONSE_CODE

Valeurs :
  • 00 : Opération acceptée.
  • 05 : Opération refusée.
  • 17: Paiement annulé (uniquement pour un paiement sans autorisation ).
  • 34 : Opération refusée pour suspicion de fraude.
  • 75 : Opération refusée suite au nombre de tentatives de saisie du numéro de carte dépassé.
  • 96 : Opération refusée suite à une erreur technique.

Ex : 00

14 BANK_RESPONSE_CODE

Type : VARCHAR | Longueur : 255

Description : Code réponse à la demande d'autorisation envoyé par la banque émettrice.

Équivalent API Formulaire : vads_auth_result

Équivalent API REST : transactionDetails.cardDetails.authorizationResponse.authorizationResult

Valeurs : Liste des codes retour autorisation

Ex : 00

15 CVV_RESPONSE_CODE

Type : VARCHAR | Longueur : 255

Description : Code réponse du CVV2/CVC2.

Valeur : Toujours valorisé à vide.

16 NEW_STATUS

Type : VARCHAR | Longueur : 255

Description : Nouveau statut de la transaction. Ce champ peut être vide si le statut de la transaction ne correspond pas à un des statuts ci-dessous.

Équivalent API Formulaire : N/A

Équivalent API REST : N/A

Valeurs :
  • REFUSED : Transaction refusée
  • TO_VALIDATE : Transaction à valider
  • TO_CAPTURE : Transaction en attente de remise
  • TO_CREDIT : Transaction de crédit (remboursement) en attente de remise
  • CANCELLED : Transaction annulée
  • CAPTURED : Transaction remisée
  • EXPIRED : Transaction expirée
  • TO_VALIDATE_AND_AUTHORIZE : Transaction à valider et autoriser
  • TO_AUTHORIZE : Transaction en attente de demande d’autorisation
  • TO_PRENOTIFY : Transaction en attente de pré-notification
  • ACCEPTED
  • REFUSED_CAPTURED : La remise de la transaction a échoué

Ex : TO_CAPTURE

17 ORDER_ID

Type : VARCHAR | Longueur : 255

Description : Numéro de commande générée par le site marchand.

Équivalent API Formulaire : vads_order_id

Équivalent API REST : orderDetails.orderId

Ex : CX-1254

18 RETURN_CONTEXT

Type : VARCHAR | Longueur : 500

Description : Contexte de la commande d’un acheteur.

Concaténation des "informations complémentaires", séparées par le caractère "|".

Les informations complémentaires peuvent être transmises par le site marchand :

  • via les champs vads_order_info, vads_order_info2, vads_order_info3 du formulaire de paiement,
  • via les attributs orderInfo, orderInfo2, orderInfo3 de l'objet metadata de l'API REST.

Au-delà de 500 caractères, la chaîne est tronquée.

Champ vide si aucune information complémentaire n'est transmise.

Équivalent API Formulaire : vads_order_info | vads_order_info2 | vads_order_info3

|

Équivalent API REST : orderInfo | orderInfo2 | orderInfo3

Ex :
  • info1|info2|info3 si les 3 informations complémentaires sont transmises,
  • info1||info3: si seules les informations complémentaires 1 et 3 sont transmises.
19 CUSTOMER_ID

Type : VARCHAR | Longueur : 255

Description : Référence client générée par le site marchand.

Équivalent API Formulaire : vads_cust_id

Équivalent API REST : customer.reference

Ex : C2383333540

L'enregistrement « FIN »

Pos. Description Valeurs
01 Code d'enregistrement FIN

Exemple de fichier

Téléchargez le pack d'exemples : https://paiement.systempay.fr/doc/files/samples/sample-files.zip.

Vous trouverez un fichier d'exemple dans le dossier Reporting/JO.

© 2025 Tous droits réservés à SystempayMentions légales
25.18-1.11