Page tree
Skip to end of metadata
Go to start of metadata



Contenu


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 Payline.

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.


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

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 :
BalisesObligatoire (O/N)FormatCommentaire
buyer.customerIdOAN50Identifiant client auprès du marchand
buyer.titleNAN5Titre : Mr, Mrs, Ms 
buyer.lastNameOAN100Nom de famille
buyer.firstNameOAN100Prénom
buyer.emailOAN150L'adresse électronique de l'acheteur
buyer.mobilePhoneON15Le numéro de téléphone mobile de l'acheteur
buyer.billingAddress.street1OAN150L'adresse de la facture : rue
buyer.billingAddress.cityNameOAN40L'adresse de la facture : ville
buyer.billingAddress.zipCodeOAN20L'adresse de la facture : code postal
buyer.billingAddress.countryOAN2L'adresse de la facture : pays FR
buyer.shippingAdress.street1OAN100L'adresse de la livraison : rue
buyer.shippingAdress.cityNameOAN40L'adresse de la livraison : ville
buyer.shippingAdress.zipCodeOAN20L'adresse de la livraison : code postal
buyer.shippingAdress.countryOAN2L'adresse de la livraison : pays FR
order.refOAN50Référence de la commande.
(warning) Le montant doit être égale au montant de la transaction
order.amountON12Montant 1000 = 10,00 €
order.currencyON3EURO = 978
order.dateOAN16Date de la commande
 order.deliveryModeO
Mode de livraison
order.details.priceO
Prix de chaque article de la commande
order.details.quantityO
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

Payline vous informe du résultat de manière synchrone en réponse du doWebPayment
Lorsque le paiement est accepté, Payline renvoie le code retour à la valeur « 00000 ».
Pour un paiement refusé, le code varie en fonction du motif de refus (Par exemple : 02xxx pour une suspicion de fraude).


Les codes les plus utilisés sont :

Code Payline
ShortMessage
LongMessage
00000ACCEPTEDOperation Successfull
02000ONHOLD_PARTNERTransaction in progress, please wait for payment status
02008CANCELLEDTransaction canceled by user => redirection sur abort ou timeout url
02016ONHOLD_PARTNERTransaction hold on partner, please wait for payment method return
02008CANCELLEDTransaction canceled by user
02020REFUSEDTransaction refused by partner
02101ERRORSystem internal error (frontend)
02102ERRORAcquirer server communication error
02324REFUSEDThe session expired before the consumer has finished the transaction
02106ERRORPayment partner error
02012ERRORUnmatched partner return code
02305ERRORInvalid field format
02308ERRORInvalid value for
02310ERRORRequested function not available