Contenu
| Sommaire | ||||
|---|---|---|---|---|
|
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 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.
Inclusion d'extrait Contactez le support Payline Contactez le support Payline nopanel true
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>" }]
- La transaction de paiement complémentaire dans paymentAdditionalList.
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 |
| Extrait | ||
|---|---|---|
| ||
- Si le remboursement des cartes cadeau est OK, la transaction est refusée avec un code retour 02798 - Si le remboursement d’au moins une carte cadeau est refusé, la transaction est refusée avec un code retour 02003 (To be reversed) |
| Extrait | ||
|---|---|---|
| ||
<?xml version="1.0"?> <getWebPaymentDetailsResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:obj="http://obj.ws.payline.experian.com" xmlns="http://impl.ws.payline.experian.com"><result> |