Carte Cadeau Carrefour - Intégration

S’abonner

Comment configurer votre compte ?

Vous devez vous rapprocher de votre responsable de compte Carte Cadeau Carrefour pour obtenir les informations nécessaires permettant de configurer votre compte sur Payline (Contrat, type, montant max).
Ensuite veuillez adresser un email à notre équipe support@payline.com 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.

Le nom du moyen de paiement est Cadeau_Carrefour
Vous devez réaliser des transactions 'pilote' pour valider le bon fonctionnement en production.

Lors de la création du moyen de paiement, les champs à configurer sont l'identifiant du contrat, l'indicateur Alimentaire et le montant max par carte Cadeau. Ils doivent être fournis par le service Carte Cadeau Carrefour.

  • Numéro de contrat : fourni par le processeur Epay.
  • Type de contrat : fourni par Epay, Payline envoie cette information sans contrôle.
  • Montant max : du cumul des cartes cadeau pour un panier. Payline contrôle ce montant max.
  • Accepte les cartes remisées : information transmise à Epay sans contrôle et permet de savoir si le commerçant accepte les cartes avec une remise.


Comment proposer la Carte Cadeau à vos clients ?

Une fois le moyen de paiement activé, il est utilisable au travers des fonctions standard Payline.

Le mode d'intégration est disponible avec les pages de paiements API WebPayment v2 et le mode API Widget : services doWebPayment et getWebPaymentDetail.


Les web services de l'API Payline

Les services doWebPayment, doRefund, getTransactionDetails et getWebPaymentDetails sont disponibles.

L'object Payment sera transmis par le commerçant avec les valeurs Action = 101 et Mode = CPT.

Le service getWebPaymentDetails retourne :

  • La transaction de paiement Carte Cadeau Carrefour avec les données cartes cadeau (PAN, Montant initial, montant final, paiement) dans le nouveau champ partnerAdditionalData de l'objet transaction.
    Ces données sont fournies sous forme d’un tableau JSON respectant le format suivant :

[{ "PAN": "<pan masqué>", "initialBalance": "<solde initial>", "finalBalance": "<solde après achat>", "paymentAmount": "<montant du paiement>" }]

Le service getTransactionDetails retourne les données cartes cadeau (PAN, Montant initial, montant final, paiement) dans le nouveau champ partnerAdditionalData de l'object transaction (même format que pour getWebPaymentDetails).

Le service doRefund peut être effectuée en référençant soit la transaction carte cadeau soit la transaction du paiement complémentaire. Dans tous les cas seul, le paiement complémentaire peut être remboursé avec les contraintes propres au moyen de paiement complémentaire. La réponse référence toujours la transaction du paiement complémentaire.


Les champs obligatoires

Il n'y a pas de champs obligatoire.

Comment réaliser des tests ?

Il vous faut obtenir une carte de test auprès du service Carrefour.


Logo du moyen de paiement


Les codes de retour

Payline vous informe du résultat d'un paiement via le code retour des messages « getWebPaymentDetails » et « getTransactionDetails ».
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 : 04xxx pour une suspicion de fraude).

Les codes spécifiques au moyen de paiement sont :

Code Retour Short Message Message Remarque
02610 REFUSED The max amount is exceeded
02703 ERROR Action not allowed Payline refuse les demandes de remboursement des commandes sans paiement complémentaire avec ce code
02998 REFUSED Transaction refused


Cet article vous a-t-il été utile ?
Utilisateurs qui ont trouvé cela utile : 0 sur 0
Vous avez d’autres questions ? Envoyer une demande

Commentaires

Réalisé par Zendesk