Table des matières


 


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.

UserDataans..1024OSi indiqué sur la demande, plateforme de paiement transmet le paramètre à la boutique avec le résultat du paiement
OrderDescans..768MDescription 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.

CCBrandan14M« 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

addata1n..3M

Selon les modalités choisies par le client :

  • 000 : petites mensualités
  • 993 : différer de 3 mois
  • Autre valeur : nombre de mensualités comprises dans une liste de valeurs
    • 001 (paiement comptant),
    • 003 montant minimum : 70€
    • 010 montant minimum : 200€
EIDan8CID 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

DateOfBirthn8MDate 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)

Pour adapter la disposition de la page SSL à votre boutique, vous pouvez utiliser les paramètres ci-dessous non chiffrés afin de configurer les couleurs, les polices et les images :

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

RefNran12MLe 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.
TIDn..15MLa valeur est retournée en tant que fournisseur TransactionID
addata1ans..28ORetour 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.

DateOfBirthn8MDate 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

RefNran12MNuméro de référence univoque du commerçant
ReqIDans..32OPour é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)

RefNran12MNumé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

RefNran12MNuméro de référence univoque du commerçant
ReqIDans..32OPour é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)

RefNran12MNumé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

RefNran12MNuméro de référence univoque du commerçant
ReqIDans..32OPour é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)

RefNran12MNumé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
Type,Action,

[Slave]

MID,Amount,Currency,TransID,Data (depends on Action)
FOOT,CountRecords,SumAmount


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)

  • No labels