Comment configurer votre compte ?

Pour mettre en place Carrefour 3x4x sur Payline, il vous faut créer un compte avec MarketPayTech et récupérer l'ID Marchand MarketPayTech nécessaire à configurer votre contrat Payline.
Ensuite veuillez adresser un email à notre équipe support avec les informations, afin qu'ils puissent procéder au paramétrage dans votre compte marchand Payline en indiquant l’ID Marchand et le nom de l’alias du contrat partenaire à créer.

Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.Pour mettre en place Carrefour 3x4x sur Payline, il vous faut créer un compte avec MarketPayTech et récupérer l'ID Marchand MarketPayTech nécessaire à configurer votre contrat Payline.

Le code (card_code) du moyen de paiement est : CARREFOUR_BANQUE_NX

Pour créer un moyen de paiement dans le centre d'administration PAYLINE

Vous devez vous rapprocher de votre responsable de compte partenaire pour obtenir les informations nécessaires permettant de configurer votre compte de production sur Payline.

Documentation Monext Online > Carrefour 3xCB / 4xCB - Intégration - Version 2 > CAV5-CarrefourBanqueNX.PNG

Ensuite veuillez faire une demande à notre équipe support avec les informations ci dessous, afin qu'ils puissent procéder au paramétrage dans votre compte marchand Payline en indiquant l’ID Marchand et le nom de l’alias du contrat partenaire à créer. Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.

Ce numéro de contrat (alias) vous permettra d'effectuer les paiements.

Le nom du moyen de paiement (card_code) est CARREFOUR_BANQUE_NX.

Validez votre intégration

Cette étape obligatoire vous permet de contrôler que votre intégration est correcte.

Obtenez une transaction de paiement accordée avec le numéro de contrat.
Consultez le centre d'administration commerçant et validez le bon enregistrement de vos transactions de paiement.

Comment proposer le paiement Carrefour 3xCB / 4xCB à vos clients ?

Les principes d’utilisation

Une fois le moyen de paiement activé, il est utilisable au travers des fonctions standard Payline en indiquant le contrat du moyen de paiement Contrat_Number.
Le mode d'intégration est disponible avec l'API WebPayment : services doWebPayment et getWebPaymentDetails.

Les paiements CB3x/CB4x sont éligibles au traitement par le module anti-fraude Payline, au même titre que les autres transactions. Si une authentification 3DSecure est nécessaire, Payline gère l’affichage de la page d'authentification (ACS). Seul un refus banque peut conduire à un refus du paiement.

La carte doit avoir une date de validité de 6 mois avant la date d'échéance.

Les web services en mode Web

Paiement à la commande : en utilisant le service doWebPayment avec payment.mode à CPT et code Action à 101.
Paiement à l'expédition : en utilisant le service doWebPayment avec payment.mode à CPT et code Action à 100.
Mode de paiement : sélectionner votre mode de paiement : comptant avec le code Mode = CPT.
Demande de remboursement d'une transaction remisée : utilisez la fonction doRefund pour rembourser la commande.
Demande d'annulation d'une transaction non remisée : utilisez la fonction doReset pour rembourser la commande

Données marchand

Vous pouvez transmettre des données privées avec la balise MiscData du service doWebPayment.

Les champs obligatoires

Les informations ci dessous doivent être fournies par le commerçant, si les valeurs sont absentes ou non valorisées, le service doWebPayment retournera le code d'erreur 02305 :

Balises	Obligatoire (O/N)	Format	Commentaire
buyer.customerId	O	`AN50`	Identifiant client auprès du marchand
buyer.title	N	`AN5`	Titre : Mr, Mrs, Ms
buyer.lastName	O	`AN100`	Nom de famille
buyer.firstName	O	`AN100`	Prénom
buyer.email	O	`AN150`	L'adresse électronique de l'acheteur
buyer.mobilePhone	O	`N15`	Le numéro de téléphone mobile de l'acheteur
buyer.billingAddress.street1	O	`AN150`	L'adresse de la facture : rue
buyer.billingAddress.cityName	O	`AN40`	L'adresse de la facture : ville
buyer.billingAddress.zipCode	O	`AN20`	L'adresse de la facture : code postal
buyer.billingAddress.country	O	`AN2`	L'adresse de la facture : pays FR
buyer.shippingAdress.street1	O	`AN100`	L'adresse de la livraison : rue
buyer.shippingAdress.cityName	O	`AN40`	L'adresse de la livraison : ville
buyer.shippingAdress.zipCode	O	`AN20`	L'adresse de la livraison : code postal
buyer.shippingAdress.country	O	`AN2`	L'adresse de la livraison : pays FR
order.ref	O	`AN50`	Référence de la commande. Le montant doit être égale au montant de la transaction
order.amount	O	`N12`	Montant 1000 = 10,00 €
order.currency	O	`N3`	EURO = 978
order.date	O	`AN16`	Date de la commande
order.deliveryMode	O		Mode de livraison
order.details.price	O		Prix de chaque article de la commande
order.details.quantity	O		Quantité de chaque article de la commande

Comment réaliser des tests ?

Note : Il est indispensable de réaliser des tests transactionnels sur l'environnement de production avec des cartes après la validation de la mise en œuvre sur l'environnement de test.

Les codes de retour

Les codes les plus utilisés sont :