Cofidis |
Version 6.9 |
Date 19/11/2020 |
Table des matières
Historique des versions
Date | Nom | Modification |
---|---|---|
19/11/2020 | Peter Posse | Version originale |
Cofidis
Informations générales sur Cofidis
La carte 4étoiles a été lancée par Cofidis dès la création de cette dernière en 1982 et était initialement réservée exclusivement aux clients de l’enseigne 3 Suisses. Il s’agit d’une carte privée qui combine facilités de paiement et avantages de la fidélité. La conception de produits et services sur mesure, adaptés aux attentes et aux besoins des clients, a permis à Cofidis d’étendre au fil des ans la carte 4étoiles à d’autres enseignes (en magasin et en ligne) comme par ex. Feu Vert, Maty, Blancheporte, Helline, Bon prix, etc.
On parle dorénavant du réseau 4étoiles. Payez vos achats en plusieurs mensualités.
La carte 4étoiles est une carte de crédit renouvelable qui vous offre la possibilité de payer - selon le montant de vos achats et l’enseigne - en plusieurs mensualités.
La carte 4étoiles est une carte privée qui combine facilités de paiement et avantages de la fidélité. La conception de produits et services sur mesure a été adaptée aux attentes et aux besoins des clients. Payez vos achats en plusieurs mensualités. La carte 4étoiles est une carte de crédit renouvelable qui vous offre la possibilité de payer - selon le montant de vos achats et l’enseigne - en plusieurs mensualités. |
Schéma de déroulement du processus
Interface plateforme de paiement
Formats des données : a alphabétique as alphabétique avec caractères spéciaux n numérique an alphanumérique ans alphanumérique avec caractères spéciaux ns numérique avec caractères spéciaux bool expression booléenne (true ou false) 3 longueur fixe avec 3 chiffres/caractères ..3 longueur variable avec maximum 3 chiffres/caractères enum énumération de valeurs admissibles dttm Date et heure ISO (AAAA-MM-JJThh:mm:ss) Abréviations : CND condition M obligatoire (mandatory en anglais) O optionnel C conditionnel Remarque : Veuillez noter que les noms des paramètres peuvent être en majuscules ou en minuscules.
Caractères spéciaux
Cofidis n'accepte qu'une gamme limitée de caractères spéciaux selon le tableau ci-dessous :
Signe | Nom |
---|---|
: | Côlon |
. | Arrêt complet / période |
Espace | |
@ | Arobase |
+ | Signe plus |
% | Signe de pourcentage |
* | Astérisque |
/ | Barre oblique |
_ | Souligner |
- | Tiret (trait d'union / signe moins) |
Marques de cartes de crédit
Marque de carte de crédit, orthographe correcte pour CCBrand |
Carte 4Etoiles (Carte Helline4etoiles – de marque) |
Paiement par carte de crédit avec Cofidis, via interface de formulaire Cofidis
Pour procéder à un paiement par carte de crédit TLS via le formulaire Cofidis, appelez l'adresse URL ci-dessous :
Remarque : Pour des raisons de sécurité, plateforme de paiement rejette toutes les demandes de paiement contenant des erreurs de formatage. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre | Format | CND | Description |
---|---|---|---|
MerchantID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas. Ce paramètre doit également être transféré non chiffré. |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
RefNr | an12 | M | Numéro de référence univoque du commerçant |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a3 | M | Devise, trois caractères DIN / ISO 4217, par ex. EUR |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
URLSuccess | ans..256 | M | Adresse URL complète qui appelle plateforme de paiement en cas de réussite du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData. |
URLFailure | ans..256 | M | Adresse URL complète qui appelle plateforme de paiement en cas d'échec du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData. |
Response | a7 | O | État de la réponse envoyée par plateforme de paiement à URLSuccess et URLFailure, doit être chiffré. À cette fin, transmettez le paramètre Response=encrypt. |
URLNotify | ans..256 | M | Adresse URL complète appelée par plateforme de paiement pour notifier le résultat de paiement à la boutique. L'URL ne peut être appelée que par le port 443. Elle ne peut contenir aucun paramètre : utilisez le paramètre UserData pour ce faire. |
UserData | ans..1024 | O | Si indiqué sur la demande, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement |
OrderDesc | ans..768 | M | Description des marchandises achetées, des prix unitaires etc. |
Capture | an..6 | O | Détermine le type et l'heure de la capture. AUTO : capture immédiatement après l'autorisation (valeur par défaut). MANUAL : capture effectuée par le commerçant. <Number> : temporisation en heures jusqu'à la capture (nombre entier ; 1 à 696). |
ReqID | ans..32 | O | Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers. |
CCBrand | an14 | M | « Carte 4Etoiles » |
Plain | ans..50 | O | Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID |
Custom | ans..1024 | O | Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &. Custom=session=123|id=456 devient dans la réponse Session=123&id=456 |
Le tableau suivant décrit les paramètres de résultat que la plate-forme de paiement transmet à votre URLSuccess, URLFailure ou URLNotify. Si vous avez spécifié le paramètre Response=encrypt, les paramètres suivants sont transmis à votre système avec chiffrement Blowfish :
Paramètre | Format | CND | Description |
---|---|---|---|
MID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas |
PayID | an32 | M | ID attribuée au paiement par la plateforme de paiement, par ex. pour le référencement au sein des fichiers batch |
XID | an32 | M | ID pour toutes les transactions uniques (autorisation, capture, remboursement) pour un paiement attribué par la plateforme de paiement |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
Status | a..30 | M | OK ou AUTHORIZED (URLSuccess) ou encore FAILED (URLFailure) |
Description | ans..1024 | M | Détails supplémentaires dans le cas où le paiement est rejeté. N’utilisez pas la Description, mais le paramètre Code pour l’analyse du statut de transaction ! |
Code | n8 | M | Code erreur de réponses de la plateforme de paiement (voir fichier Excel des codes erreur) |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
RefNr | an12 | M | Numéro de référence univoque du commerçant |
UserData | ans..1024 | O | Si indiqué sur la demande, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement |
addata1 | n..3 | M | Selon les modalités choisies par le client :
|
EID | an8 | C | ID attribuée par la plate-forme de paiement |
PCNr | n..16 | O | Pseudo-numéro de carte : numéro aléatoire créé par la plate-forme de paiement et qui représente un vrai numéro de carte de crédit. Le pseudo-numéro de carte (PCN) commence avec 0 et les 3 derniers chiffres correspondent à ceux du vrai numéro de carte. Vous pouvez utiliser le PCN comme un véritable numéro de carte pour les autorisations, les saisies et les notes de crédit. |
Plain | ans..50 | O | Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID |
Custom | ans..1024 | O | Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &. Custom=session=123|id=456 devient dans la réponse Session=123&id=456 |
Paiement par carte de crédit avec Cofidis via interface de formulaire de plate-forme de paiement standard
Pour procéder à un paiement par carte de crédit TLS avec Cofidis via le formulaire de plate-forme de paiement standard, appelez l'adresse URL ci-dessous :
Remarque : Pour des raisons de sécurité, plateforme de paiement rejette toutes les demandes de paiement contenant des erreurs de formatage. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre | Format | CND | Description |
---|---|---|---|
MerchantID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas. Ce paramètre doit également être transféré non chiffré. |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a3 | M | Devise, trois caractères DIN / ISO 4217, par ex. EUR |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
URLSuccess | ans..256 | M | Adresse URL complète qui appelle plateforme de paiement en cas de réussite du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData. |
URLFailure | ans..256 | M | Adresse URL complète qui appelle plateforme de paiement en cas d'échec du paiement. L'URL ne peut être appelée que par le port 443. Cette URL ne peut contenir aucun paramètre : pour échanger des valeurs de paramètre entre plateforme de paiement et la boutique, veuillez utiliser le paramètre UserData. |
Response | a7 | O | État de la réponse envoyée par plateforme de paiement à URLSuccess et URLFailure, doit être chiffré. À cette fin, transmettez le paramètre Response=encrypt. |
URLNotify | ans..256 | M | Adresse URL complète appelée par plateforme de paiement pour notifier le résultat de paiement à la boutique. L'URL ne peut être appelée que par le port 443. Elle ne peut contenir aucun paramètre : utilisez le paramètre UserData pour ce faire. |
UserData | ans..1024 | O | Si indiqué sur la demande, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement |
Capture | ans..6 | O | Détermine le type et l'heure de la capture. AUTO : capture immédiatement après l'autorisation (valeur par défaut). MANUAL : capture effectuée par le commerçant. <Number> : temporisation en heures jusqu'à la capture (nombre entier ; 1 à 696). |
ReqID | ans..32 | O | Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers. |
Plain | ans..50 | O | Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID |
Custom | ans..1024 | O | Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &. Custom=session=123|id=456 devient dans la réponse Session=123&id=456 |
expirationTime | ans..19 | O | Horodatage pour la fin du traitement de la transaction, indiqué en UTC. Format : AAAA-MM-jjTHH:mm:ss |
DateOfBirth | n8 | M | Date de naissance au format « jjmmaaaa » |
RefNr | an12 | M | Le numéro de référence univoque du commerçant, qui sert de référence de remboursement dans le fichier EPA de l'acquéreur. Veuillez noter que sans la livraison de référence propre à la boutique, vous ne pouvez pas lire la transaction EPA ; quant au fichier de règlement supplémentaire Axepta (CTSF), nous ne pouvons pas ajouter les données de paiement supplémentaires. |
OrderDesc | ans..768 | M | Description des marchandises achetées, des prix unitaires etc. |
CreditCardHolder | ans..60 | O | Nom du titulaire de la carte |
RTF | a1 | O | Pour paiements réguliers (abonnements) : I = paiement initial pour un nouvel abonnement R = paiement de routine (récurrent) |
addata1 | ans..28 | O | Code de la transaction [AN3]/Nombre de mensualités [AN2]/Numéro de facture [AN15]/Date de facture[N8] À transférer sans séparateurs. Il est possible que le numéro et la date de facture ne soient pas encore disponibles pour la réservation initiale. Dans ce cas, entrer des espaces dans ces champs. Le code de transaction a été implémenté conformément à la spécification Cofidis ; consulter le tableau suivant pour les codes de transaction. Veuillez observer la remarque séparée au sujet de ce paramètre. |
Textfeld1 | ans..30 | O | Autre numéro de référence de la transaction |
Remarque concernant le paramètre Cofidis Addata1 : Cofidis exige que toutes les réservations soient effectuées avec le code de transaction 590 puis remplacées par le bon code de transaction lors de la saisie. Comme il est possible que le numéro et la date de facture soient encore inconnus au moment de la réservation, il faut transférer des espaces à leur place lors de la réservation. Si le code de transaction n’est plus disponible lors de la facturation, la réservation peut être déjà effectuée avec le bon code. Axepta remplace ensuite le code de transaction de saisie 590 puis, lors de la facturation, le remplace à nouveau par celui transmis lors de la réservation. Le numéro et la date de facture sont adoptés en même temps et transférés à Cofidis
Type d’achat à tempérament | Requête PGI | Code de transaction | Nombre de mensualités |
---|---|---|---|
Petite mensualité | Capture (saisie), autorisation tél. | 460 | 0 (non pertinent) |
Petite mensualité | Credit (note de crédit) | 470 | 0 (non pertinent) |
Acompte | Capture (saisie) | 423 | 1 |
Acompte | Credit (note de crédit) | 523 | 1 |
Mensualité | Capture (saisie) | 423 | x |
Mensualité | Credit (note de crédit) | 523 | x |
Suspension de paiement | Capture (saisie) | 974 | 0 (non pertinent) |
Suspension de paiement | Credit (note de crédit) | 975 | 0 (non pertinent) |
Paramètre | Format | CND | Description |
---|---|---|---|
Template | ans..20 | M | Nom du fichier XSLT contenant votre propre disposition pour le formulaire de paiement. Si vous souhaitez utiliser le template Axepta remanié et compatible vers le bas, veuillez transférer le nom de template « bnp_compatible ». Si vous souhaitez utiliser le template Axepta réactif pour des périphériques mobiles, veuillez transférer le nom de template « bnp_responsive ». |
Background | ans..256 | M | Ambiance d'arrière-plan du formulaire : URL pour une image d'arrière-plan - Valeur de couleur HTML pour la couleur d'arrière-plan sous forme de valeur HEX ou - Nom de couleur HTML |
BGColor | ans..7 | M | Couleur d'arrière-plan du formulaire : - Valeur de couleur HTML pour la couleur d'arrière-plan sous forme de valeur HEX ou - Nom de couleur HTML |
BGImage | ans..256 | M | Image d'arrière-plan du formulaire : URL pour une image d'arrière-plan Veuillez noter que cette valeur remplace « BGColor ». |
FColor | ans..6 | M | Couleur du texte : - Valeur de couleur HTML sous forme de valeur HEX ou - Nom de couleur HTML |
FFace | a..10 | M | Nom HTML pour la police |
FSize | n2 | M | Numéro pour la taille de police |
Language | a2 (enum) | M | Code pour la langue : <de> allemand, <al> albanais, <at> allemand autrichien, <cz/cs> tchèque, <dk> danois, <en> anglais, <fi> finnois, <fr> français, <gr> grec, <hu> hongrois, <it> italien, <jp> japonais, <nl> néerlandais, <no> norvégien, <pl> polonais, <pt> portugais, <ro> roumain, <ru> russe, <sp> espagnol, <se> suédois, <sk> slovaque, <sl> slovène, <tr> turc, <zh> chinois simplifié. En l'absence d'indication, la langue est l'allemand. |
CCSelect | a..10 | M | Détermine le type de carte présélectionné sous la forme: VISA, MasterCard, AMEX, DINERS, JCB, CBN, Hipercard, Elo, Aura, Dankort, Airplus, ComfortCard, CUP |
URLBack | ans..256 | M | URL pour le bouton « Cancel » (annulation) |
Center | n1 | M | Par défaut, le formulaire est centré verticalement et horizontalement. La valeur <1> centre le formulaire en haut. |
tWidth | ans..4 | M | Largeur du tableau pour l'entrée des données de prélèvement en pour cent (50%) ou en pixels (320). |
tHeight | ans..4 | M | Hauteur du tableau pour l'entrée des données de prélèvement en pour cent (70%) ou en pixels (480). |
Le tableau suivant décrit les paramètres de résultat que la plate-forme de paiement transmet à votre URLNotify, URLSuccess ou URLFailure. Si vous avez spécifié le paramètre Response=encrypt, les paramètres suivants sont envoyés à votre système avec chiffrement Blowfish :
Paramètre | Format | CND | Description | |
---|---|---|---|---|
MID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas | |
PayID | an32 | M | ID attribuée au paiement par la plateforme de paiement, par ex. pour le référencement au sein des fichiers batch | |
XID | an32 | M | ID pour toutes les transactions uniques (autorisation, capture, remboursement) pour un paiement attribué par la plateforme de paiement | |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement | |
Status | a..50 | M | OK ou AUTHORIZED (URLSuccess) ou encore FAILED (URLFailure) | |
Description | ans..1024 | M | Détails supplémentaires dans le cas où le paiement est rejeté. N’utilisez pas la Description, mais le paramètre Code pour l’analyse du statut de transaction ! | |
Code | n8 | M | Code erreur de réponses de la plateforme de paiement (voir fichier Excel des codes erreur) | |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 | |
UserData | ans..1024 | O | Si indiqué sur la demande, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement | |
RefNr | an12 | M | Le numéro de référence univoque du commerçant, qui sert de référence de remboursement dans le fichier EPA de l'acquéreur. Veuillez noter que sans la livraison de référence propre à la boutique, vous ne pouvez pas lire la transaction EPA ; quant au fichier de règlement supplémentaire Axepta (CTSF), nous ne pouvons pas ajouter les données de paiement supplémentaires. | |
TID | n..15 | M | La valeur est retournée en tant que fournisseur TransactionID | |
addata1 | ans..28 | O | Retour comme avec l’appel | |
PCNr | n16 | O | Pseudo-numéro de carte : numéro aléatoire créé par la plate-forme de paiement et qui représente un vrai numéro de carte de crédit. Le pseudo-numéro de carte (PCN) commence avec 0 et les 3 derniers chiffres correspondent à ceux du vrai numéro de carte. Vous pouvez utiliser le PCN comme un véritable numéro de carte pour les autorisations, les saisies et les notes de crédit. | |
CCBrand | a..22 | OC | Combiné au PCNr : désignation de la marque de carte de crédit Veuillez respecter l'orthographe ! Voir le tableau des marques des cartes de crédit ! | |
CCExpiry | n6 | OC | Combiné au PCNr : date d'expiration de la carte de crédit au format AAAAMM (201706). | |
MaskedPan | an..19 | OC | Numéro de carte masqué 6X4. Si vous souhaitez recevoir le paramètre MaskedPan, veuillez contacter notre équipe de support à l’adresse Helpdesk@Computop.com, laquelle active le retour. | |
Plain | ans..50 | O | Valeur à définir par le commerçant pour retourner des informations non chiffrées, par ex. la MID | |
Custom | ans..1024 | O | Le commerçant peut introduire plusieurs valeurs séparées par un | qui sont ensuite retournées non chiffrées et séparées par un &. Custom=session=123|id=456 devient dans la réponse Session=123&id=456 | |
CustomField[n] | ans..50 | O | Champ pouvant être utilisé au gré par le commerçant. 14 champs sont actuellement pris en charge de CustomField1 à CustomField14. |
Paiement par carte de crédit via connexion de serveur à serveur
Pour procéder à un paiement par carte de crédit TLS avec Cofidis via une connexion de serveur à serveur, appelez l'adresse URL ci-dessous :
Remarque : Pour des raisons de sécurité, la plateforme de paiement rejette toutes les requêtes de paiement contenant des erreurs de format. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Le tableau ci-dessous présente les paramètres de requête de paiement cryptée :
Paramètre | Format | CND | Description |
---|---|---|---|
MerchantID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas. Ce paramètre doit également être transféré non chiffré. |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a3 | M | Devise, trois caractères DIN / ISO 4217, par ex. EUR |
CCNr | n..19 | M | Numéro de carte de crédit, minimum 12 chiffres sans espaces. En option, vous pouvez également transmettre un pseudo-numéro de carte (PCN). |
CCCVC | n..4 | O | Code de vérification de la carte : les 3 derniers chiffres sur le champ de signature de la carte de crédit. 4 chiffres s'il s'agit d'American Express. |
CCExpiry | n6 | M | Date d'expiration de la carte de crédit au format AAAAMM, par ex. 201707. |
CCBrand | a..22 | M | Marque de la carte de crédit. Veuillez noter l'orthographe conformément au tableau des marques de cartes de crédit ! |
Capture | ans..6 | O | Détermine le type et l'heure de la capture. AUTO : capture immédiatement après l'autorisation (valeur par défaut). MANUAL : capture effectuée par le commerçant. <Number> : temporisation en heures jusqu'à la capture (nombre entier ; 1 à 696). |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
ReqID | ans..32 | O | Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers. |
DateOfBirth | n8 | M | Date de naissance au format « jjmmaaaa » |
RefNr | an12 | M | Le numéro de référence univoque du commerçant, qui sert de référence de remboursement dans le fichier EPA de l'acquéreur. Veuillez noter que sans la livraison de référence propre à la boutique, vous ne pouvez pas lire la transaction EPA ; quant au fichier de règlement supplémentaire Axepta (CTSF), nous ne pouvons pas ajouter les données de paiement supplémentaires. |
OrderDesc | ans..768 | M | Description des marchandises achetées, des prix unitaires etc. |
CreditCardHolder | ans..60 | O | Nom du titulaire de la carte |
RTF | a1 | O | Pour paiements réguliers (abonnements) : I = paiement initial pour un nouvel abonnement R = paiement de routine (récurrent) |
addata1 | ans..28 | M | Code de la transaction [AN3]/Nombre de mensualités [AN2]/Numéro de facture [AN15]/Date de facture[N8] À transférer sans séparateurs. Il est possible que le numéro et la date de facture ne soient pas encore disponibles pour la réservation initiale. Dans ce cas, entrer des espaces dans ces champs. |
Textfeld1 | ans..30 | O | Autre numéro de référence de la transaction |
Le tableau ci-dessous contient les paramètres utilisés par la plate-forme de paiement dans la réponse :
Paramètre | Format | CND | Description |
---|---|---|---|
MID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas |
PayID | an32 | M | ID attribuée au paiement par la plateforme de paiement, par ex. pour le référencement au sein des fichiers batch |
XID | an32 | M | ID pour toutes les transactions uniques (autorisation, capture, remboursement) pour un paiement attribué par la plateforme de paiement |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
Status | a..50 | M | OK ou AUTHORIZED ou encored FAILED |
Description | ans..1024 | M | Détails supplémentaires dans le cas où le paiement est rejeté. N’utilisez pas la Description, mais le paramètre Code pour l’analyse du statut de transaction ! |
Code | n8 | M | Code erreur de réponses de la plateforme de paiement (voir fichier Excel des codes erreur) |
PCNr | n16 | O | TOKEN (Pseudo-numéro de carte) : numéro aléatoire créé par la plate-forme de paiement et qui représente un vrai numéro de carte de crédit. Le TOKEN (PCN) commence avec 0 et les 3 derniers chiffres correspondent à ceux du vrai numéro de carte. Vous pouvez utiliser le PCN comme un véritable numéro de carte pour les autorisations, les saisies et les notes de crédit. |
CCExpiry | n6 | OC | Optionnel combiné au PCNr : date d'expiration de la carte de crédit au format AAAAMM (201706). |
CCBrand | a..22 | OC | Optionnel combiné au PCNr : désignation de la marque de carte de crédit Veuillez respecter l'orthographe ! Voir le tableau des marques des cartes de crédit ! |
MaskedPan | an..19 | OC | Numéro de carte masqué 6X4. Si vous souhaitez recevoir le paramètre MaskedPan, veuillez contacter notre équipe de support, laquelle active le retour. |
RefNr | an12 | M | Le numéro de référence univoque du commerçant, qui sert de référence de remboursement dans le fichier EPA de l'acquéreur. Veuillez noter que sans la livraison de référence propre à la boutique, vous ne pouvez pas lire la transaction EPA ; quant au fichier de règlement supplémentaire Axepta (CTSF), nous ne pouvons pas ajouter les données de paiement supplémentaires. |
addata1 | ans..28 | O | Retour comme avec l’appel |
Saisie d’un paiement par carte de crédit avec Cofidis
Les saisies sont possibles via une connexion de serveur à serveur. Pour procéder à une saisie via une connexion de serveur à serveur, veuillez utiliser l'URL suivante :
Remarque : Pour des raisons de sécurité, plateforme de paiement rejette toutes les demandes de paiement contenant des erreurs de formatage. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre | Format | CND | Description |
---|---|---|---|
MerchantID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas. Ce paramètre doit également être transféré non chiffré. |
PayID | an32 | M | ID attribuée par le commerçant (Merchant) pour le processus de paiement à saisir |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a3 | M | Devise, trois caractères DIN / ISO 4217, par ex. EUR |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
RefNr | an12 | M | Numéro de référence univoque du commerçant |
ReqID | ans..32 | O | Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers. |
Le tableau ci-dessous contient les paramètres utilisés par la plate-forme de paiement dans la réponse :
Paramètre | Format | CND | Description |
---|---|---|---|
MID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas |
PayID | an32 | M | Identifiant attribué par la plateforme de paiement pour le paiement ; p. ex. pour référencement dans les fichiers batch |
XID | an32 | M | ID pour toutes les transactions uniques (autorisation, capture, remboursement) pour un paiement attribué par la plateforme de paiement |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
Status | a..30 | M | OK ou FAILED |
Description | ans..1024 | M | Détails supplémentaires dans le cas où le paiement est rejeté. N’utilisez pas la Description, mais le paramètre Code pour l’analyse du statut de transaction ! |
Code | n8 | M | Code erreur de réponses de la plateforme de paiement (voir fichier Excel des codes erreur) |
RefNr | an12 | M | Numéro de référence univoque du commerçant |
Crédit avec référence
Les notes de crédit (remboursements) sont possibles via une connexion de serveur à serveur. Pour un crédit avec référence à une saisie, le montant du crédit est limité au montant de la saisie précédente.
Pour exécuter une note de crédit avec une transaction de référence, veuillez utiliser l'adresse URL suivante :
Remarque : Pour des raisons de sécurité, plateforme de paiement rejette toutes les demandes de paiement contenant des erreurs de formatage. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre | Format | CND | Description |
---|---|---|---|
MerchantID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas. Ce paramètre doit également être transféré non chiffré. |
PayID | an32 | M | ID attribuée par le commerçant (Merchant) pour le processus de paiement à créditer |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a3 | M | Devise, trois caractères DIN / ISO 4217, par ex. EUR |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
RefNr | an12 | M | Numéro de référence univoque du commerçant |
ReqID | ans..32 | O | Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers. |
Le tableau ci-dessous contient les paramètres utilisés par la plate-forme de paiement dans la réponse :
Paramètre | Format | CND | Description |
---|---|---|---|
MID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas |
PayID | an32 | M | Identifiant attribué par la plateforme de paiement pour le paiement ; p. ex. pour référencement dans les fichiers batch |
XID | an32 | M | ID pour toutes les transactions uniques (autorisation, capture, remboursement) pour un paiement attribué par la plateforme de paiement |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
Status | a..30 | M | OK ou FAILED |
Description | ans..1024 | M | Détails supplémentaires dans le cas où le paiement est rejeté. N’utilisez pas la Description, mais le paramètre Code pour l’analyse du statut de transaction ! |
Code | n8 | M | Code erreur de réponses de la plateforme de paiement (voir fichier Excel des codes erreur) |
RefNr | an12 | M | Numéro de référence univoque du commerçant |
Annulation
Les annulations sont possibles via une connexion de serveur à serveur. Une autorisation de carte de crédit abaisse la limite de crédit du client. La plate-forme de paiement est en mesure d'annuler une autorisation de manière à ne plus bloquer la limite de crédit.
Pour exécuter une annulation avec une transaction de référence, veuillez utiliser l'adresse URL suivante :
Remarque : Pour des raisons de sécurité, plateforme de paiement rejette toutes les demandes de paiement contenant des erreurs de formatage. Veuillez par conséquent utiliser le type de données correct pour chaque paramètre.
Remarque : Reverse.aspx annule non seulement les autorisations, mais également LA DERNIÈRE ÉTAPE DE TRANSACTION ! Si cette dernière transaction était une saisie, Reverse.aspx lance l'annulation, par ex. une note de crédit. Il faut par conséquent faire preuve de prudence. L'utilisation de la fonction est à vos propres risques. Nous recommandons de vérifier le statut de transaction avec Inquire.aspx avant d'utiliser Reverse.aspx
Le tableau ci-dessous décrit les paramètres de demande de paiement chiffrés :
Paramètre | Format | CND | Description |
---|---|---|---|
MerchantID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas. Ce paramètre doit également être transféré non chiffré. |
PayID | an32 | M | ID attribuée par le commerçant (Merchant) pour le processus de paiement à annuler |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a3 | M | Devise, trois caractères DIN / ISO 4217, par ex. EUR |
MAC | an64 | M | Code d'authentification de message haché (HMAC) avec algorithme SHA-256 |
RefNr | an12 | M | Numéro de référence univoque du commerçant |
ReqID | ans..32 | O | Pour éviter les paiements en double, saisissez une valeur alphanumérique qui identifie votre transaction et ne peut être attribuée qu’une seule fois. Si la transaction est à nouveau soumise avec le paramètre ReqID identique, la plateforme de paiement n’exécute pas le paiement et se contente de retourner le statut de la transaction d’origine. Attention : Plateforme de paiement doit afficher un statut de transaction finalisée pour la première action initiale. Les introductions avec un ReqID identique pour un statut ouvert sont traitées à intervalles réguliers. |
Le tableau ci-dessous contient les paramètres utilisés par la plate-forme de paiement dans la réponse :
Paramètre | Format | CND | Description |
---|---|---|---|
MID | ans..30 | M | Identifiant du commerçant (MerchantID) attribué par BNP Paribas |
PayID | an32 | M | Identifiant attribué par la plateforme de paiement pour le paiement ; p. ex. pour référencement dans les fichiers batch |
XID | an32 | M | ID pour toutes les transactions uniques (autorisation, capture, remboursement) pour un paiement attribué par la plateforme de paiement |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
Status | a..30 | M | OK ou FAILED |
Description | ans..1024 | M | Détails supplémentaires dans le cas où le paiement est rejeté. N’utilisez pas la Description, mais le paramètre Code pour l’analyse du statut de transaction ! |
Code | n8 | M | Code erreur de réponses de la plateforme de paiement (voir fichier Excel des codes erreur) |
RefNr | an12 | M | Numéro de référence univoque du commerçant |
Traitement batch via l'interface
Le manuel Batch Manager donne des informations sur l'utilisation des fichiers batch et sur leur structure. Au sein du traitement batch, toutes les fonctions généralement proposées pour l'interface en ligne ne sont pas disponibles.
Cette section décrit les paramètres qui doivent être transmis au sein de l'enregistrement (Record) pour l'exécution de paiements / notes de crédit avec Cofidis, ainsi que les informations pouvant être contenues dans le fichier de réponse sur l'état du paiement.
Pour les appels Batch, il convient de distinguer les versions batch utilisées qui définissent les paramètres optionnels. Toutes les désignations de version commençant par « 2. » se rapportent aux appels pour un groupe d'entreprises. Ceci signifie qu'au sein d'un fichier batch avec une MerchantID spécifique, il est également possible de transférer des transactions d'autres commerçants avec sous-MID séparée.
Le tableau ci-dessous donne une vue d'ensemble de toutes les versions batch possibles pour une action spécifique et de leurs particularités :
Action | Version | Description |
---|---|---|
Capture (saisie) | 1.x / 2.x | Version standard |
Credit (note de crédit) | 1.x / 2.x | Version standard |
Reverse | 1.x / 2.x | Version standard |
La structure devant être introduite pour un paiement Cofidis au sein d'un fichier Batch est comme suit :
HEAD,<MerchantID>,<Date>,<Version> CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID> CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID> CC,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID> FOOT,<CountRecords>,<SumAmount> |
Exemple pour la fonction Master MID :
HEAD, [Master] MerchantID,Date,2.x [Slave] MID,Amount,Currency,TransID,Data (depends on Action) |
Le tableau ci-dessous décrit les différents champs et valeurs utilisés dans l'enregistrement (record) au sein du fichier batch :
Paramètre | Format | CND | Description |
---|---|---|---|
Type | a..11 | M | HEAD pour en-tête (header), FOOT pour pied de page (footer) et CC pour Cofidis |
Action | a..20 | M | Le paramètre Action définit le type de transaction : Capture (saisie) Credit (note de crédit) Reverse (annulation) |
Amount | n..10 | M | Montant indiqué dans la plus petite unité de la devise (par ex. les centimes pour l'euro) Veuillez contacter notre service d'assistance si vous souhaitez capturer des montants < 100 (plus petite unité de la devise). |
Currency | a3 | M | Devise, trois caractères DIN / ISO 4217, par ex. EUR |
TransID | ans..15 | M | ID de la transaction qui doit être univoque pour chaque paiement |
RefNr | an12 | M | Numéro de référence univoque |
PayID | an32 | M | ID pour cette transaction attribuée par la plate-forme de paiement |
La zone Record dans le fichier de réponse pour les transactions batch se présente comme suit :
HEAD,<MerchantID>,<Date>,<Version> CC,Capture,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code> CC,Credit,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code> CC,Reverse,<Amount>,<Currency>,<TransID>,(<RefNr>,)<PayID>,<Status>,<Code> FOOT,<CountRecords>,<SumAmount> |
Le tableau ci-dessous décrit les paramètres de réponse que le Batch Manager sauvegarde dans la zone Record pour chaque transaction (les paramètres par défaut non détaillés ici tels que <TransID> ou <RefNR>, ainsi que les paramètres de demande sont retournés inchangés et correspondent à l'appel tel que spécifié avant) :
Paramètre | Format | CND | Description |
---|---|---|---|
Action | a..20 | M | Le paramètre Action définit le type de transaction : Capture (saisie) Credit (note de crédit) Reverse (annulation) |
PayID | an32 | M | ID pour cette transaction attribuée par la plate-forme de paiement |
Status | a..50 | M | OK ou FAILED |
Code | n8 | M | Code erreur de réponses de la plateforme de paiement (voir fichier Excel des codes erreur) |