PayPal
Contents
- 1 Introduction
- 2 Comment ça marche ?
- 3 Fonctionnalités
- 4 Cycle de vie de la transaction
- 5 Intégration dans MERCANET ESSENTIEL
- 6 Integration avec Mercanet Gestion Plus
- 7 Detail du panier d’achat
- 8 Règles spécifiques
- 9 Vérification de paiement (Payment review)
- 10 Compte PayPal du commerçant
- 11 Annexes
Introduction
L’objectif du présent document est d’aider les Commerçants à mettre en œuvre et gérer la solution des paiements PayPal.
A noter
Tous les termes, acronymes, expressions spécifiques à la Mercanet Solution et son contexte sont définies dans le document : GLOSSAIRE N’hésitez pas à vous y référer chaque fois que nécessaire |
Comment ça marche ?
Principes généraux
PayPal offre son propre moyen de paiement qui permet de payer les achats effectués en ligne. PayPal propose un compte virtuel avec des moyens de paiement associés. Par conséquent, l’Internaute doit disposer d’un compte PayPal pour payer ses achats. Néanmoins, si l’Internaute clique le logo PayPal sans disposer d’un compte, il pourra en créer un lors du processus de paiement. Suite à quoi, il peut effectuer ses achats. Les moyens de paiement associés autorisés sont :
- compte bancaire
- carte de crédit ou debit
- compte virtuel PayPal
Disponibilité des interfaces
La solution de paiement PayPal est disponible sur les interfaces suivantes :
Interface (mode) Moyen de paiement |
Mercanet Essentiel |
Mercanet Gestion Plus |
Mercanet Batch |
|||
---|---|---|---|---|---|---|
POST |
JSON |
SOAP |
SOAP |
JSON |
BATCH |
|
Paypal |
✔ |
✔ |
✔ |
- |
- |
- |
PayPal est disponible sur le wallet porteur de Mercanet : Mercanet walletpage |
Processus de paiement
Vue de l’utilisateur
Les étapes du parcours client lors de l’exécution d’un paiement PayPal sont décrites ci-dessous :
Séquence des écrans de paiement avec Mercanet Essentiel
MERCANET ESSENTIEL
Le processus de paiement dans Mercanet Essentiel est décrit ci-dessous :
Diagramme des flux avec Mercanet Essentiel
Étape |
Description |
---|---|
1 |
Validation du panier et du paiement |
2 |
Redirection vers Mercanet et sélection du moyen de paiement PayPal |
3 |
L’Internaute est redirigé vers les pages d’authentification et de validation de PayPal |
4 |
Une demande d’autorisation est envoyée à PayPal, qui informe Mercanet du résultat du paiement. |
5 |
La confirmation du paiement est envoyée à l’Internaute et au Commerçant. |
6 |
Remise en paiement |
MERCANET Gestion plus
Le processus de paiement via Mercanet Gestion Plus est décrit ci-dessous :
Diagramme des flux Mercanet Gestion Plus
Étape |
Description |
---|---|
1 |
Validation du panier et paiement |
2 |
Le commerçant envoie une requête d’initialisation de paiement PayPal vers Mercanet |
3 |
Mercanet initialise une session avec PayPal |
4 |
Mercanet retourne les informations de redirection vers le commerçant |
5 |
Le client est redirigé vers les pages de paiement PayPal pour réaliser son identification et la validation du paiement |
6 |
Le commerçant appel Mercanet pour finaliser la transaction |
7 |
Demande d’autorisation envoyée vers PayPal. PayPal informe Mercanet du statut de la demande. |
8 |
Confirmation de paiement envoyée au commerçant. |
9 |
Le commerçant informe le client du statut du processus de paiement |
10 |
Processus de remise (optionnel pour les paiements immédiats) |
Pages de paiement
Choix du moyen de paiement
Page d’authentification de PayPal
Page de vérification et de confirmation des paiements PayPal
Présentation du ticket d’information des paiements PayPal
Fonctionnalités
Type de fonctionnalité |
Disponibilité |
Remarque |
---|---|---|
Canal de paiement |
||
Internet |
✔ |
|
MOTO (commande par courrier ou commande par téléphone) |
Non applicable |
|
Moyens de paiement |
||
Paiement immédiat |
✔ |
|
Paiement en fin de journée |
✔ |
|
Paiement différé |
✔ |
Limité à 29 jours |
Paiement à l’expédition |
✔ |
|
Paiement échelonné |
- |
|
Paiement par abonnement (Wallet électronique au mode récurrent) |
- |
|
Paiement par lots (batch) |
✔ |
|
Paiements un clic |
- |
|
Règlement en devises différentes |
||
Paiement multi-devises |
✔ |
Selon le contrat PayPal du Commerçant |
Encaissement multi-devises |
✔ |
Selon le contrat PayPal du Commerçant |
Gestion des fraudes |
||
Veuillez-vous référer au guide des contrôles anti-fraude |
||
Reportings Commerçant |
||
Journal des transactions (JDT) |
✔ |
|
Journal des opérations (JDO) |
✔ |
|
Journaux rapprochement bancaire (JRB) |
✔ |
|
Journaux rapprochement des impayés (JRI) |
- |
|
Back office |
✔ |
|
Opérations de caisse |
||
Annulation |
✔ |
Annulation totale ou partielle |
Validation |
✔ |
Validation totale ou partielle |
Remboursement |
✔ |
Egalement disponible pour un montant partiel. Les demandes de remboursement PayPal sont prises en compte immédiatement. Le remboursement peut être effectué jusqu’à 60 jours après l'achat. Toute demande de remboursement après ce délai a pour conséquence l'envoi du code réponse acquéreur « 12 ». |
Duplication |
✔ |
Pendant la transaction initiale, le commerçant doit indiquer que cette transaction peut être dupliquée. Durant la duplication de la transaction, des détails sur le panier d'achats peuvent être transmis à PayPal. Consultez le chapitre Erreur ! Source du renvoi introuvable. pour de plus amples informations. |
Les opérations de caisse sur une transaction PayPal doivent être impérativement effectuées par les interfaces Mercanet. L'initiation d'opération de gestion de caisse depuis le compte PayPal du commerçant (cf. Chapitre Erreur ! Source du renvoi introuvable. - Erreur ! Source du renvoi introuvable.) provoquera des incohérences entre les états des transactions dans Mercanet |
||
Mode de capture |
||
Mode envoi automatique (annulation) |
✔ |
Mode par défaut. |
Mode validation |
✔ |
|
Mode immédiat |
✔ |
Ce mode est spécifique à la solution PayPal : l'autorisation et la remise sont exécutées en ligne simultanément. |
✔: Disponible - : Non disponible
Cycle de vie de la transaction
Figure 7 : Cycle de vie d’une transaction PayPal
Demande d’autorisation
Dans le cas de PayPal, l’autorisation est valide pendant 29 jours. Passé ce délai, la transaction est expirée. L'état TO_CONFIRM_AUTHOR est un état d'attente spécifié par PayPal en réponse à la demande de transaction. Dans certains cas, PayPal exécute des contrôles supplémentaires sur la transaction, par exemple des contrôles antifraudes.
Remise en paiement
Le Commerçant peut définir les modalités de remise en paiement directement à l’aide de son compte PayPal. L’état « TO_CONFIRM_CAPTURE » est affiché en attente de la remise du paiement par PayPal. Dans certains cas, PayPal soumet la transaction à des contrôles supplémentaires, portant par exemple sur la fraude.
Intégration dans MERCANET ESSENTIEL
Requete de paiement
Les champs spécifiques suivants sont définis dans le cas d'un paiement par PayPal :
Nom du champ |
Remarque/Règles |
Exemple |
---|---|---|
captureMode |
Peut avoir la valeur IMMEDIATE dans le cas d'une transaction PayPal |
IMMEDIATE |
captureDay |
Entre 0 et 29 |
0 |
amount |
Exprimé en centime |
10000 |
customerLanguage |
Affiche les textes sur le site web de PayPal en anglais (par défaut) |
Champs spécifiques à PayPal ; consultez le chapitre Erreur ! Source du renvoi introuvable. Erreur ! Source du renvoi introuvable. pour de plus amples informations :
Nom du champ |
Remarques/règles |
Exemple |
---|---|---|
paymentMeanData.paypal.invoiceId |
Numéro de commande PayPal. Le contrôle d'unicité est effectué par PayPal. |
|
paymentMeanData.paypal.addrOverride |
Permet d'effacer l'adresse de l'internaute enregistrée par PayPal ou de cacher cette adresse sur les pages PayPal. |
|
paymentMeanData.paypal.landingPageFlag |
Permet de ne pas afficher le formulaire d'inscription à PayPal. |
« true » ou « false » |
paymentMeanData.paypal.mobile |
Indique si le terminal utilisé est un mobile. |
« true » ou « false » |
paymentMeanData.paypal.dupFlag |
Permet de dupliquer la transaction. La valeur par défaut est « false » (ne peut être dupliqué). |
« true » ou « false » |
paymentMeanData.paypal.dupDesc |
Permet d’indiquer le motif d’une duplication potentielle lorsque la valeur de paymentMeanData.paypal.dupFlag est « true ». Affiche à l'internaute les détails de la transaction sur son compte PayPal. |
Motif d'une duplication |
paymentMeanData.paypal.dupCustom |
Champ libre à la disposition du commerçant. Il est pris en compte lorsque la valeur de paymentMeanData.paypal.dupFlag est « true ». |
Champ libre pour la duplication |
paymentMeanData.paypal.dupType |
Définit le type de duplication. La valeur par défaut est « InstantOnly ». Pris en compte lorsque la valeur de paymentMeanData.paypal.dupFlag est « true ». |
InstantOnly |
Si l’une des règles concernant captureDay ou amount n'est pas respectée, une page d'erreur est affichée (transaction invalide). |
Réponses manuelles et automatiques
Les champs suivants de la réponse caractérisent la transaction Paypal :
Nom du champ |
Remarques/règles |
Exemple du réglage |
---|
paymentMeanType |
La valeur de ce champ est toujours « WALLET ». |
---|---|
paymentMeanBrand |
La valeur de ce champ est toujours « PAYPAL ». |
Test d’intégration
Le mode de simulation n’est pas disponible pour le moyen de paiement PayPal.
Rattrapage automatique des refus de paiement
Lors d’un refus de transaction PayPal, il est possible d’obtenir un code d’erreur particulier (10486 - ‘This transaction couldn't be completed. Please redirect your customer to PayPal’) indiquant que le client possède d’autres moyens de paiement dans le wallet Paypal et qu’une nouvelle tentative de paiement est possible. Plusieurs causes sont possibles :
- L’adresse de facturation du compte PayPal ne peut pas être validée ;
- La montant de la transaction excède les limites du plafond de la carte bancaire utilisée pour le paiement ;
- La transaction a été refusée par l’émetteur de la carte bancaire.
- Dans ces cas, le processus de paiement est modifié pour permettre de nouveaux essais (et donc de nouvelles redirections vers PayPal).
Processus de gestion des nouvelles tentatives de paiement
- Le commerçant redirige son acheteur vers Mercanet ;
- L’acheteur sélectionne le paiement par PayPal, Mercanet et le redirige vers les pages de paiement PayPal ;
- L’acheteur sélectionne son moyen de paiement et valide la transaction. PayPal redirige alors l’acheteur vers Mercanet ;
- Mercanet envoie une demande de finalisation de paiement à PayPal. Le code d’erreur 10486 est retourné. L’acheteur est redirigé vers PayPal pour une nouvelle tentative de paiement ;
- L’acheteur choisi un autre moyen de paiement et valide la transaction ;
- Mercanet envoi une nouvelle demande de finalisation de paiement à PayPal. Si PayPal retourne un code d’erreur 10486, une nouvelle tentative est proposée. Sinon Mercanet affiche le ticket ;
- Mercanet redirige l’internaute vers le site internet du commerçant.
Le nombre maximum de redirection vers PayPal est un paramètre défini à la création du compte commerçant dans la plateforme Mercanet. La configuration utilisé est la même que celle utilisée pour définir le nombre maximum de tentatives sur une cinématique de paiement par carte bancaire. |
Integration avec Mercanet Gestion Plus
Initialisation d’un paiement (PaymentProviderInitialize)
requête d’initialisation de paiement
Les champs génériques suivants sont définis dans le cas d’un paiement PayPal :
Nom du champ |
Remarques / règles |
Exemple |
---|---|---|
captureMode |
Peut prendre la valeur IMMEDIATE dans le cas d’une transaction PayPal |
IMMEDIATE |
captureDay |
Entre 0 et 29 |
0 |
amount |
Montant en centime |
10000 |
customerLanguage |
Affiche les textes sur le site web de PayPal en anglais (par défaut) |
|
paymentMeanBrand |
Doit être valorisé avec la valeur PAYPAL |
PAYPAL |
Champs spécifiques PayPal. Pour plus d’information se référer à la section Erreur ! Source du renvoi introuvable..
Nom du champ |
Remarques / règles |
Exemple |
---|---|---|
paymentMeanData.paypal.invoiceId |
Numéro de commande PayPal. Le contrôle d'unicité est effectué par PayPal. |
|
paymentMeanData.paypal.addrOverride |
Permet d'effacer l'adresse de l'internaute enregistrée par PayPal ou de cacher cette adresse sur les pages PayPal. |
|
paymentMeanData.paypal.landingPageFlag |
Permet de ne pas afficher le formulaire d'inscription à PayPal. |
« true » ou « false » |
paymentMeanData.paypal.mobile |
Indique si le terminal utilisé est un mobile. |
« true »ou « false » |
paymentMeanData.paypal.dupFlag |
Permet de dupliquer la transaction. La valeur par défaut est « false » (ne peut être dupliqué). |
« true »ou « false » |
paymentMeanData.paypal.dupDesc |
Permet d’indiquer le motif d’une duplication potentielle lorsque la valeur de paymentMeanData.paypal.dupFlag est « true ». Affiche à l'internaute les détails de la transaction sur son compte PayPal. |
Motif d'une duplication |
paymentMeanData.paypal.dupCustom |
Champ libre à la disposition du commerçant. Il est pris en compte lorsque la valeur de paymentMeanData.paypal.dupFlag est « true ». |
Champ libre pour la duplication |
paymentMeanData.paypal.dupType |
Définit le type de duplication. La valeur par défaut est « InstantOnly ». Pris en compte lorsque la valeur de paymentMeanData.paypal.dupFlag est « true ». |
InstantOnly |
reponse d’initialisation de paiement
Les champs suivants sont retournés dans le cas d’un paiement PayPal:
Nom du champ |
Remarques / règles |
Exemple |
---|---|---|
responseCode |
Code réponse |
00 |
redirectionData |
Données de redirection |
RSs7cZyL[…]LyNK5ACo |
redirectionUrl |
URL de redirection |
|
messageVersion |
Version du message |
0.1 |
Redirection de l’acheteur
Le client doit être redirigé vers l’URL fournie en réponse de la méthode « paymentProviderInitialize ». A la fin de la cinématique de paiement, le client est redirigé sur l’URL fournie dans la requête d’initialisation. Les champs suivants peuvent être récupérés de la redirection finale :
Nom du champ |
Remarques / règles |
Exemple |
---|---|---|
responseCode |
Code réponse du processus |
00 |
redirectionData |
Données de redirection |
RSs7cZyL[…]LyNK5ACo |
messageVersion |
Version du message utilisé |
0.1 |
amount |
Montant de la transaction en centimes |
1000 |
merchantId |
Identifiant de la boutique |
002474849505153 |
transactionReference |
Référence de la transaction |
TEST0231268482123 |
transactionId |
Identifiant de la transaction |
123456 |
transactionDate |
Date de la transaction |
20150707 |
Finalisation d’un paiement (PaymentProviderFinalize)
requête de finalisation du paiement
Les champs spécifiques suivants doivent être fournis par le commerçant dans la requête de finalisation pour un paiement PayPal.
Nom du champ |
Remarques / règles |
Exemple |
---|---|---|
redirectionData |
Données de redirection (Récupéré de la redirection de l’internaute : Erreur ! Source du renvoi introuvable. Erreur ! Source du renvoi introuvable.) |
RSs7cZyL[…]LyNK5ACo |
messageVersion |
Version de message |
0.1 |
Reponse de finalisation du paiement
Les champs suivants sont retournés pour un paiement PayPal
Nom du champ |
Remarques / règles |
Exemple |
---|---|---|
paymentMeanBrand |
La valeur de ce champ est toujours « PAYPAL ». |
Récupération des informations de l’acheteur (PaymentProviderFinalize)
La méthode PaymentProviderGetContext est optionnelle et permet de récupérer des informations concernant l’acheteur. La requête est directement soumise à PayPal et permet notemment d’obtenir des informations sur l’adresse de livraison, l’email de l’acheteur ou encore le statut du paiement chez PayPal. Cette méthode doit être appelée après la redirection de l’acheteur de la page Paypal vers le site du marchand et avant la finalisation d’un paiement. Si elle est appelée après la finalisation, PayPal peut refuser la restitution d’information.
Requete de récupération des informationsde l’acheteur
Vous trouverez ci-dessous la liste des champs devant être remplis pour cette méthode :
Nom du champ |
Remarques / règles |
Exemple |
---|---|---|
redirectionData |
Données de redirection (Récupéré en sortie de l’initialisation du paiement) |
RSs7cZyL[…]LyNK5ACo |
messageVersion |
Version de message (Récupéré en sortie de l’initialisation du paiement) |
0.1 |
réponse de récupération des informations de l’acheteur
Nom du champ |
Remarques / règles |
---|---|
paymentMeanData.paypal.token |
Le token PayPal permettant la realization du paiement. |
paymentMeanData.paypal.payerId |
Identifiant unique de l’acheteur (donnée PayPal). |
paymentMeanData.paypal.payerStatus |
Statut de l’acheteur (donnée PayPal). - verified - unverified |
paymentMeanData.paypal.payerBusiness |
Nom d’enseigne de l’acheteur. |
paymentMeanData.paypal.paymentStatus |
Statut du paiement (donnée PayPal. - PaymentActionNotInitiated - PaymentActionFailed - PaymentActionInProgress - PaymentActionCompleted |
paymentMeanData.paypal.payerSuffix |
Suffixe de l’acheteur. |
paymentMeanData.paypal.deliveryAddressStatus |
Statut de l’adresse de livraison de l’acheteur. - none - Confirmed - Unconfirmed |
customerAddress.street |
Rue de l’adresse de l’acheteur. |
customerAddress.addressAdditional1 |
Complément de rue de l’adresse de l’acheteur. |
customerAddress.city |
Ville de l’acheteur. |
customerAddress.state |
Etat de l’acheteur. |
customerAddress.zipCode |
Code postal de l’acheteur. |
customerAddress.country |
Code pays de l’acheteur (Norme ISO 3166 – deux caractères). |
customerContact.phone |
Numéro de téléphone de l’acheteur. |
customerContact.firstName* |
Prénom de l’acheteur. |
customerContact.lastName |
Nom de famille de l’acheteur. |
deliveryAddress.street |
Rue de l’adresse de livraison. |
deliveryAddress.addressAdditional1 |
Complément de l’adresse de livraison. |
deliveryAddress.city |
Ville de livraison. |
deliveryAddress.state |
Etat de livraison |
deliveryAddress.zipCode |
Code pastal de livraison. |
deliveryAddress.country |
Code pays de livraison (Norme ISO 3166 – deux caractères). |
deliveryContact.phone |
Numéro de téléphone lié à l’adresse de livraison. |
deliveryContact.email |
Email lié à l’adresse de livraison. |
deliveryContact.firstName* |
Prénom lié à l’adresse de livraison. |
deliveryContact.lastName |
Nom de famille lié à l’adresse de livraison. |
Detail du panier d’achat
L'intégration de PayPal dans Mercanet permet au commerçant d'envoyer à PayPal des informations sur le panier d'achats. Cette fonctionnalité est disponible dans Mercanet Essentiel et Mercanet Gestion Plus.
Règles
Montants
PayPal valide les montants en appliquant les règles suivantes :
- 14Amount=ShoppingCart.TotalAmount+ShoppingCart.TotalTaxAmount+Delivery.ChargeAmount'>
- 14ShoppingCartDetail.TotalAmount=itemsitem.UnitAmount*item.Quantity'>
- 14ShoppingCartDetail.TotalTaxAmount=itemsitem.UnitTaxAmount*item.Quantity'>
- Si la validation échoue, le paiement est abandonné par PayPal. Le code réponse Mercanet et le code réponse acquéreur auront comme valeur « 12 » (Invalid Request).
Correspondance des champs
Structure des Données de livraison
Nom du champ |
Remarque/Règles |
---|---|
deliveryData.deliveryChargeAmount |
Montant des frais d’expédition |
Structure des Détails du panier d'achat
Champs de l'élément shoppingCartDetail :
Nom du champ |
Remarque/Règles |
---|---|
shoppingCartDetail.shoppingCartTotalAmount |
14=itemsitem.UnitAmount*item.Quantity'> |
shoppingCartDetail.shoppingCartTotalTaxAmount |
14=itemsitem.UnitTaxAmount*item.Quantity'> |
shoppingCartDetail.shoppingCartItemList |
Liste de shoppingCartItem |
Structure de l'élément Panier d'achat
Champs de l’objet shoppingCartItem :
Nom du champ |
Remarque/Règles |
---|---|
shoppingCartItem.productName |
Nom du produit |
shoppingCartItem.productDescription |
Description du produit |
shoppingCartItem.productCode |
Code produit |
shoppingCartItem.productUnitAmount |
Montant du produit |
shoppingCartItem.productQuantity |
Quantité du produit |
shoppingCartItem.productUnitTaxAmount |
Taxe sur le produit |
shoppingCartItem.productCategory |
Champ facultatif qui indique si un article est numérique ou physique. S'il est utilisé, ce champ doit contenir l'une des valeurs suivantes : - « Digital » - « Physical » |
Exemple
Description du panier d'achats sur les pages PayPal
Description
- Nom du produit
- Description du produit
- Code produit
- Prix unitaire du produit
- Quantité du produit
- Calculé automatiquement par PayPal
- Montant total des taxes sur le panier d'achats
- Montant des frais d’expédition
- Indisponible dans Mercanet
- Indisponible dans Mercanet
- Montant total du panier d'achats
Règles spécifiques
Page d’entrée PayPal
Lorsque le client est redirigé vers les pages de paiement PayPal pour la première fois (pas de cookie stocké dans le navigateur), PayPal affiche deux formulaires :
- un formulaire d'indentification
- un formulaire de création de comptePar défaut, le focus du navigateur est donné au formulaire de création de compte.
A noter
Si le champ indiquant la page d’entrée n'est pas fourni, Sips lui donne par défaut la valeur « false ». Le formulaire de création de compte sera donc affiché
- Le formulaire de création de compte peut être caché donnant au champ paymentMeanData.paypal.landingPageFlag la valeur « true »
identifiant de facture
Un numéro de facture ou de suivi peut être communiqué à PayPal dans le champ suivant :
- paymentMeanData.paypal.invoiceId
A noter
La longueur d'un identifiant de facture est limitée à 127 caractères (ANS).
- L'identifiant de facture est équivalent à l'identifiant de commande Mercanet, sauf qu'il est transmis à PayPal. Ce champ est affiché au client sur la page de résumé des paiements.
Gestion de l’affichage sur mobile
L'intégration de PayPal dans Mercanet fournit un champ d'entrée qui permet de changer l'URL de redirection de PayPal vers une page de paiement dédiée au mobile.
Pour activer la page de paiement mobile, la valeur du champ paymentMeanData.paypal.mobile doit « true »
A noter
Si le champ mobile n'est pas fourni, Mercanet lui donne par défaut la valeur « false ». La page de paiement classique de PayPal sera donc affichée. |
Gestion de l’adresse de livraison
PayPal affiche l'adresse de livraison sur ses pages de paiement. L'adresse de livraison peut être récupérée à partir de deux sources différentes :
- depuis le compte PayPal
- depuis les requêtes de paiementLa sélection est effectuée par le biais du champ paymentMeanData.paypal.addrOverride :
- la valeur « NO_OVERRIDE » sélectionne l'adresse de livraison spécifiée dans le compte PayPal.
- la valeur « OVERRIDE » sélectionne l'adresse de livraison spécifiée dans la requête de paiement. Si aucune adresse n’est fournie dans la requête alors l’adresse du compte est affichée.
- la valeur « NO_DISPLAY » n'affiche pas l'adresse de livraison.Référez-vous à la documentation Mercanet Essentiel /Mercanet Gestion Plus relative au connecteur que vous utilisez pour obtenir davantage d'informations sur la manière de spécifier l'adresse de livraison.
A noter
Si le champ addrOverride n’est pas transmis dans la requête de paiement, il sera transmis avec la valeur OVERRIDE.
Adresse de livraison invalide
Lorsque la surcharge de l’adresse de livraison est choisie que l’adresse de livraison n’est pas conforme aux validations effectuées par PayPal une erreur est retournée. Afin d’éviter l’affichage d’une erreur sur les pages de paiement Mercanet, un système de rattrapage est activé permettant de continuer le processus de paiement. Si un code d’erreur concernant une donnée de l’adresse de livraison est retourné par PayPal, Mercanet effectue les opérations suivantes :
- Suppression des données de surcharge de l’adresse de livraison ;
- Forçage du champ PayPal NOSHIPPING avec la valeur « 1 » (Pas de surcharge de l’adresse de livraison).
- Ci-dessous, la liste des codes d’erreur concernant l’adresse de livraison (gérés par Mercanet) :
Code d’erreur PayPal |
Description |
---|---|
10725 10726 10727 10728 10729 10730 10731 10732 10733 10734 10735 10736 10745 |
Erreur dans le champ pays Erreur dans un champ particulier de l’adresse de livraison Le champ « Address1 » est requis Le champ « Ville » est requis Le champ « Etat » est requis Le champ « Code postal» est requis Le champ « Pays » est requis Erreur dans un champ particulier de l’adresse de livraison Erreur dans un champ particulier de l’adresse de livraison Erreur dans un champ particulier de l’adresse de livraison Erreur dans un champ particulier de l’adresse de livraison Erreur dans la validation des champs Ville, Etat et Code postal Erreur dans un champ particulier de l’adresse de livraison |
Cette fonctionnalité n’est disponible que sur l’interface Mercanet Essentiel |
gestion de la duplication
Le processus de duplication d'une transaction nécessite que la transaction initiale soit marquée comme « duplicable ». 4 champs doivent être transmis dans la requête de paiement initiale :
- paymentMeanData.paypal.dupFlag
- paymentMeanData.paypal.dupType
- paymentMeanData.paypal.dupDesc
- paymentMeanData.paypal.dupCustom
A noter
PayPal doit avoir autorisé le compte commerçant à dupliquer les transactions. Contactez PayPal si vous avez besoin de cette fonctionnalité
Marqueur de duplication
Pour marquer la transaction comme duplicable, vous devez l'indiquer comme telle dans le message de création envoyée à Mercanet donnant au champ paymentMeanData.paypal.dupFlag de la Mercanet Essentiel la valeur « true » .
A noter
Si dupFlag a pour valeur « true », le client sera informé du fait qu'il autorise le commerçant à effectuer des paiements ultérieurs sans aucune requête. |
Description
Le champ dupDesc est facultatif et n'est utilisé que si le champ dupFlag a pour valeur « true ».
Ce champ est utilisé pour ajouter une description au processus de duplication. La description sera affichée sur la page de détails du paiement PayPal.
A noter
La longueur d'un identifiant de facture est limitée à 127 caractères (ANS). |
Type
Le champ dupType est facultatif et n'est utilisé que si le champ dupFlag a pour valeur « true ». Les valeurs acceptées sont :
- ANY : le commerçant accepte n'importe quel moyen de paiement pour l'accord de facturation, même si le mouvement des fonds vers le compte du commerçant peut prendre quelques jours. Cela inclut les chèques, en plus des cartes de crédit et de débit, et du solde PayPal.
- INSTANTONLY : les options de paiement acceptées par le commerçant sont limitées aux cartes de crédit et de débit ainsi qu'au solde PayPal, car le commerçant attend un paiement immédiat.
Par défaut, la valeur de ce champ est INSTANTONLY. |
Personalisation
Le champ dupCustom est facultatif et n'est utilisé que si le champ dupFlag a pour valeur « true ». Ce champ est un champ d'annotation personnalisé uniquement réservé au commerçant.
Vérification de paiement (Payment review)
Description
La vérification de paiement est une fonctionnalité de PayPal. Elle identifie les transactions à risque et informe le commerçant afin que ce dernier mette en attente les expéditions jusqu’à ce que PayPal ait évalué le risque de la transaction.
Etat de la transaction
Si un paiement est en cours de vérification par PayPal, l'état de la transaction est :
- TO_CONFIRM_AUTHOR (vérification du paiement à l'étape d'autorisation)
- TO_CONFIRM_CAPTURE (vérification du paiement à l’étape du paiement)
A noter
Toutes les opérations de gestion de caisse sont disponibles pour les transactions dont l'état est TO_CONFIRM_AUTHOR ou TO_CONFIRM_CAPTURE.
Déblocage d’une transaction dont paiement en cours de verification
Pour débloquer une transaction dont l'état est TO_CONFIRM_AUHTOR ou TO_CONFIRM_CAPTURE, un traitement par lot est exécuté quotidiennement pour obtenir l'état le plus récent des transactions et les mettre à jour en :
- REFUSED (si le paiement a été refusé)
- TO_CAPTURE/TO_VALIDATE (si l'autorisation a été approuvée)
- CAPTURED (si le paiement a été remis)
Compte PayPal du commerçant
Pour accepter le moyen de paiement PayPal, vous devez également disposer d’un compte PayPal. Il doit s’agir d’un compte « Entreprise » (le type de compte est choisi lorsque le commerçant s’inscrit sur ). Les fonds perçus chaque soir y seront transférés. Bien entendu, vous pouvez décider de les transférer sur votre compte bancaire. Si vous avez plusieurs boutiques en production (plus d’un merchant_id), nous vous recommandons de créer un compte PayPal par boutique. Sur votre compte PayPal, vous devez, en tant que commerçant, autoriser le prestataire de services de paiement (PSP) à appeler l'API de PayPal.
Description
Dans votre compte PayPal entreprise :
- Allez dans Préférence puis Accès à l’API :
- Cliquez sur le lien Accorder des droits d'accès API.
La fenêtre Ajouter de nouveaux droits d'accès à un tiers s'ouvre. Dans le champ textuel, entrez le compte technique sips-gestion-services_api1.worldline.com puis cliquez sur Rechercher.
Sélectionnez les options suivantes :
- Utiliser PayPal Option+ pour traiter vos paiements ;
- Effectuer un remboursement pour une transaction spécifique ;
- Traiter les paiements par carte bancaire de vos clients;
- Autoriser et collecter vos transactions PayPal ;
- Permet d'obtenir des informations concernant une transaction en particulier ;
- Obtenir une autorisation pour les paiements pré-approuvés et initier les transactions pré-approuvées ;
- Utiliser Paypal Option+ pour traiter vos paiements mobiles.
Cliquez ensuite sur le bouton Ajouter.
Annexes
Codes de réponse et Codes réponse acquéreur
Référez-vous au dictionnaire des données
Correspondances des codes réponses
Code erreur PayPal |
Code Réponse Acquéreur |
Code Réponse Mercanet |
---|---|---|
10001 |
90 |
90 |
10002 (Erreur interne Paypal) |
90 |
90 |
10002 |
05 |
05 |
10004 |
12 |
12 |
10007 |
40 |
05 |
10009 |
05 |
05 |
10010 |
12 |
12 |
10011 |
12 |
12 |
10101 |
90 |
90 |
10102 |
90 |
90 |
10103 |
05 |
05 |
10201 |
33 |
05 |
10202 |
12 |
12 |
10204 |
05 |
05 |
10207 |
05 |
05 |
10209 |
05 |
05 |
10211 |
12 |
12 |
10212 |
05 |
05 |
10216 |
05 |
05 |
10400 |
12 |
12 |
10401 |
12 |
12 |
10402 |
40 |
05 |
10404 |
12 |
12 |
10405 |
12 |
12 |
10406 |
12 |
12 |
10407 |
12 |
12 |
10408 |
12 |
12 |
10409 |
05 |
05 |
10410 |
12 |
12 |
10411 |
05 |
05 |
10412 |
94 |
90 |
10413 |
12 |
12 |
10414 |
12 |
12 |
10415 |
94 |
90 |
10416 |
05 |
05 |
10417 |
05 |
05 |
10418 |
12 |
12 |
10419 |
12 |
12 |
10420 |
12 |
12 |
10421 |
05 |
05 |
10422 |
05 |
05 |
10423 |
05 |
05 |
10424 |
12 |
12 |
10425 |
05 |
05 |
10426 |
12 |
12 |
10427 |
12 |
12 |
10428 |
12 |
12 |
10429 |
12 |
12 |
10430 |
12 |
12 |
10431 |
12 |
12 |
10432 |
12 |
12 |
10433 |
12 |
12 |
10434 |
12 |
12 |
10435 |
05 |
05 |
10436 |
12 |
12 |
10437 |
12 |
12 |
10438 |
12 |
12 |
10439 |
12 |
12 |
10440 |
12 |
12 |
10441 |
12 |
12 |
10442 |
12 |
12 |
10443 |
12 |
12 |
10444 |
12 |
12 |
10445 |
90 |
90 |
10446 |
12 |
12 |
10471 |
12 |
12 |
10472 |
12 |
12 |
10474 |
12 |
12 |
10504 |
05 |
05 |
10527 |
05 |
05 |
10537 |
05 |
05 |
10538 |
05 |
05 |
10539 |
05 |
05 |
10546 |
05 |
05 |
10553 |
05 |
05 |
10560 |
05 |
05 |
10567 |
05 |
05 |
10600 |
05 |
05 |
10601 |
05 |
05 |
10602 |
05 |
05 |
10603 |
05 |
05 |
10604 |
05 |
05 |
10605 |
12 |
12 |
10606 |
51 |
05 |
10607 |
90 |
90 |
10608 |
05 |
05 |
10609 |
12 |
12 |
10610 |
12 |
12 |
10611 |
05 |
05 |
10612 |
05 |
05 |
10613 |
12 |
12 |
10614 |
05 |
05 |
10615 |
05 |
05 |
10616 |
05 |
05 |
10617 |
05 |
05 |
10618 |
24 |
05 |
10619 |
12 |
12 |
10620 |
24 |
05 |
10621 |
24 |
05 |
10622 |
24 |
05 |
10623 |
05 |
05 |
10624 |
94 |
90 |
10625 |
12 |
12 |
10626 |
05 |
05 |
10627 |
12 |
12 |
10628 |
90 |
90 |
10629 |
24 |
05 |
10630 |
12 |
12 |
10724 |
12 |
12 |
10725 |
12 |
12 |
10726 |
12 |
12 |
10727 |
12 |
12 |
10728 |
12 |
12 |
10729 |
12 |
12 |
10730 |
12 |
12 |
10731 |
12 |
12 |
10732 |
12 |
12 |
10733 |
12 |
12 |
10734 |
12 |
12 |
10735 |
12 |
12 |
10736 |
12 |
12 |
10745 |
12 |
12 |
10747 |
05 |
05 |
10748 |
05 |
05 |
10755 |
05 |
05 |
11001 |
12 |
12 |
11094 |
05 |
05 |
11302 |
05 |
05 |
11450 |
05 |
05 |
11451 |
57 |
05 |
11452 |
05 |
05 |
11453 |
05 |
05 |
11454 |
05 |
05 |
11455 |
05 |
05 |
11456 |
12 |
12 |
11603 |
12 |
12 |
11604 |
90 |
90 |
11604 |
12 |
12 |
81251 |
90 |
90 |
81XXX (tout code commençant par 81) |
12 |
12 |
Tout autre code |
05 |
05 |
Devises acceptées
Code de devise |
Description |
---|---|
036 |
Dollar australien |
124 |
Dollar canadien |
208 |
Couronne danoise |
392 |
Yen japonais |
554 |
Dollar néo-zélandais |
578 |
Couronne norvégienne |
702 |
Dollar de Singapour |
752 |
Couronne suédoise |
756 |
Franc suisse |
826 |
Livre sterling |
840 |
Dollar américain |
978 |
Euro |
Langues acceptées
Code (champ de langue) |
Langue |
---|---|
fr |
français |
ge |
allemand |
en |
anglais |
es |
espagnol |
it |
italien |