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.

Contactez le support Monext Online.

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.

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

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

Monext Online vous informe du résultat d’un paiement via le ShortMessage, selon le mode d'intégration proposé par le moyen de paiement. 

• pour l'API WebPayment avec le service getWebPaymentDetails,
• pour l'API DirectPayment en réponse du service doAuthorization de manière synchrone ou getTransactionDetails en réponse asynchrone.

Les états retournés :

• Le paiement est accepté avec l'état ACCEPTED et le code retour 00000.
• Le paiement est refusé avec l'état REFUSED. Le code varie en fonction du motif de refus (Par exemple : 01xxx pour une raison bancaire ou 04xxx pour une suspicion de fraude).

La gestion des états et des codes retour sont listés ici.

Les codes les plus utilisés sont :

Pages associées

• Page:
  Intégration 3D Secure 2 en mode API WebPayment
• Page:
  Intégration API WebPayment
• Page:
  PW - Intégration Widget
• Page:
  PW - L'API JavaScript
• Page:
  PW - Personnalisation du widget : Balises CSS
• Page:
  PW - Personnalisation du widget : Feuille de style
• Page:
  PW - Personnalisation du widget : Fonction CallBack