PayPal

From Documentation Mercanet
Jump to: navigation, search

Contents

Introduction

L’objectif du présent document est d’aider les Commerçants à mettre en œuvre et gérer la solution des paiements PayPal.
Info.png 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

✔

✔

✔

-

-

-



Info.png A noter

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 :
P 1.PNG
Séquence des écrans de paiement avec Mercanet Essentiel

MERCANET ESSENTIEL


P 2.PNG
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 :
P 3.PNG
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


P 4.PNG
Choix du moyen de paiement
P 5.PNG
Page d’authentification de PayPal
P 6.PNG
Page de vérification et de confirmation des paiements PayPal
P 7.PNG
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


P 8.PNG
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


Info.png A noter

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


P 9.PNG
Processus de gestion des nouvelles tentatives de paiement

  1. Le commerçant redirige son acheteur vers Mercanet ;
  2. L’acheteur sélectionne le paiement par PayPal, Mercanet et le redirige vers les pages de paiement PayPal ;
  3. L’acheteur sélectionne son moyen de paiement et valide la transaction. PayPal redirige alors l’acheteur vers Mercanet  ;
  4. 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 ;
  5. L’acheteur choisi un autre moyen de paiement et valide la transaction ;
  6. 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 ;
  7. Mercanet redirige l’internaute vers le site internet du commerçant.

Info.png A noter

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


P 10.PNG
Description du panier d'achats sur les pages PayPal Description

  1. Nom du produit
  2. Description du produit
  3. Code produit
  4. Prix unitaire du produit
  5. Quantité du produit
  6. Calculé automatiquement par PayPal
  7. Montant total des taxes sur le panier d'achats
  8. Montant des frais d’expédition
  9. Indisponible dans Mercanet
  10. Indisponible dans Mercanet
  11. 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.
    Info.pngA 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 
    Info.png 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 »
Info.png 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.
    Info.png 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


Info.png A noter

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
    Info.png 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 » .
Info.png 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.
Info.png 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. 


    • Info.png A noter

    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)
    Info.png 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 :


Paypal 1.png

  • Cliquez sur le lien Accorder des droits d'accès API.

Parametrer-compte-paypal-2.png

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.


Parametrer-compte-paypal-3.png

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

Retrieved from "https://documentation.mercanet.bnpparibas.net/index.php?title=PayPal&oldid=2879"