PAYPAL Partenaires - 2009 User Manual [fr]

Présentation et

cadrage des solutions partenaires.

Version 1.0 – September 2009

Sommaire

PREAMBULE – CERTIFICATION PAYPAL 3

1.1

Scénario de commande 4

1.1.1 Flux PAYPAL EXPRESS (ECS) 4

1.1.2 Flux PAYPAL OPTION + (ECM) 8

1.1.3 Flux PAYPAL INTEGRAL 9

1.1.4 Embarquement accéléré des marchands 10

1.2

Intégration visuelle de PayPal 11

1.2.1 Comment présenter PayPal aux visiteurs de votre site ? 11

1.2.2 Comment présenter PayPal dans le backoffice marchand ? 12

2. INTEGRATION TECHNIQUE DES SOLUTIONS PAYPAL 13

2.1

Appels API 13

2.1.1 Schéma des workflow de paiement 13

2.1.2 SETEXPRESSCHECKOUT (SetEC) 14

2.1.3 URL de redirection 16

2.1.4 GETEXPRESSCHECKOUT (GetEC) 17

2.1.5 DOEXPRESSCHECKOUT (DoEC) 17

2.2

Traitement de la transaction PayPal 19

2.2.1 Paiements en attente 19

2.2.2 Notification instantanée de paiement (IPN) 20

2.2.3 Remboursements 20

2.3

Détails d’intégration 21

2.3.1 Informations d'authentification API 21

2.3.2 Third part autorisation 22

2.3.3 Environnement de test 23

2.3.4 Données à stocker cote partenaire 23

3. ANNEXES 24

3.1

Détail des états de transaction 24

3.2

Codes erreur 26

3.3

Process de configuration d’une 3rd part Authorisation 28

3.4

Flux de création de compte avec PayPal Express 30

3.5

Migration vers une intégration API 30

Préambule – Certification PayPal

Ce document a pour objectif de donner une première vision claire et rapide de l’intégration des produits API PayPal tant au niveau technique qu’au niveau visuel. PayPal dispose de documentations supplémentaires que vous pourrez vous fournir en fonction des spécificités du projet.

Par ailleurs, PayPal France a mis en place un processus de certification qui repose notamment sur les principes d’intégration exposés dans ce document ; le but de cette certification est de récompenser les partenaires qui ont fait les efforts d’intégration technique et visuelle qui permettent d’offrir au marchand et à l’acheteur final une meilleure expérience de nos solutions.

Au-delà de la bonne intégration de nos principales solutions, les points suivants seront particulièrement importants dans le processus de certification:

• Le respect des bonnes pratiques d’intégration Visuelle (1.2):

o Expérience souhaitée pour le marchand : le marchand peut différentier

les 3 offres PayPal (sur le site du partenaire et/ou au sein de l'interface de gestion de sa boutique en ligne) et choisir celle qui lui convient ; il peut facilement afficher le logo qui correspond à l'offre qu'il a choisie dans les différentes sections de sa boutique.

o Expérience souhaitée pour l'acheteur : le marchand présente à

l'acheteur tous les moyens de paiement disponibles, c'est-à-dire les cartes bancaires et privatives, le compte bancaire et le compte PayPal dans le cas de PayPal Intégral, ou le compte PayPal uniquement dans le cas de PayPal Option+ et PayPal Express.

• L’utilisation du traceur Bouton Source (BN Code) (2.1.2.1):

Le BN Code est un Identifiant de transactions réalisées via un partenaire PayPal. Merci de contacter PayPal pour obtenir le vôtre. (partenaires@paypal.com)

• La gestion des transactions via l’IPN (2.2.2)

Les critères de certification pourront être complétés pour inclure de nouvelles fonctionnalités de PayPal afin d'offrir aux marchands et aux acheteurs finaux les versions de nos solutions les plus performantes.

Si vous souhaitez obtenir la certification, merci de nous contacter en envoyant un email à

partenaires@paypal.com

Expériences de l'acheteur/du marchand

L’intégration de PayPal permet de proposer à vos clients une expérience basée sur la simplicité et la sécurité. L’utilisation des API PayPal permet d’intégrer PayPal de deux façons :

• Simplifier et raccourcir le tunnel de commande pour le client grâce à une utilisation optimisée de PayPal à partir du panier de commande (PayPal Express).

• Lister PayPal comme un moyen de paiement additionnel à côté des autres moyens de paiements (PayPal Option+)

• Proposer également un paiement par cartes bancaires et/ou cartes privatives via la plateforme PayPal (PayPal Intégral)

1.1 Scénario de commande

1.1.1 FLUX PAYPAL EXPRESS (ECS)

L’intégration de PayPal Express permet à l’acheteur de passer une commande rapidement sans avoir à remplir de formulaire sur le site marchand

Scénario :

Le bouton « Paiement Express PayPal » s’affichera sur la page panier d’achat du site ou sur la page « produit »

1. Le client clique sur le bouton

2. Le client est redirigé vers le site PayPal.com. La page de connexion PayPal s’affiche.

Une fois connecté, la page de vérification PayPal s’affiche. Là, il pourra

conserver les paramètres par défaut de son compte PayPal ou bien changer de source d’approvisionnement et/ou d’adresse de livraison.

….

3. Le client clique sur « Continuer ». Il est redirigé vers la page de confirmation d’achat, sur le site du marchand. L’adresse de livraison est déjà remplie à l’aide des informations fournies par PayPal. Le champs « Mode de paiement » indique également PayPal comme mode de paiement et affichera l'adresse email du compte PayPal du client.

•

PayPal transmet des informations liées à l’acheteur au site marchand

•

Le site marchand prérenseigne les informations nécessaires à la finalisation de la

• Nom, prénom de l’acheteur,

• Adresse de livraison

• Adresse email

Avec ces informations, vous pouvez ensuite soit reconnaître un client existant, soit créer un compte sur votre site pour l’acheteur, la création étant simplifiée puisque vous avez déjà les coordonnées de l’acheteur.

Il suffit ensuite de demander des informations complémentaires nécessaires à la création d’un compte (Mot de passe du compte, inscription à une newsletter, …)

À cette étape, aucune transaction n’est commencée. Le client a seulement donné son accord au site marchand pour débiter son compte PayPal.

4. Lorsque le client clique sur le bouton de confirmation d’achat du site marchand, la transaction réelle sera initiée et le client sera dirigé vers la page de remerciement.

1.1.2 FLUX PAYPAL OPTION + (ECM)

PayPal apparaîtra sous la forme d'un moyen de paiement supplémentaire sur la page du panier d'achat du site marchand à côté d'autres modes de paiement :

1. Le client sélectionne PayPal comme moyen de paiement

2. Le client est redirigé vers une page de connexion à PayPal

3. Une fois connecté, la page de vérification PayPal s’affiche. Sur cette page, il peut utiliser la source d'approvisionnement par défaut ou en sélectionner une autre. Le champ « Adresse de livraison» de la page affiche l'adresse de livraison fournie sur le site du marchand et le client ne pourra pas la modifier. Cette page sera configurée pour que le bouton « Continuer » soit remplacé par « Payer » afin d'indiquer que la transaction va avoir lieu dès que le client cliquera dessus.

4. Le client clique sur ce bouton « Payer » : il est redirigé vers la page de remerciement. Aucune transaction n’est réellement effectuée jusqu'à ce que le client revienne sur le site du marchand et que soit envoyée la requête API finale.

1.1.3 FLUX PAYPAL INTEGRAL

Le flux PAYPAL INTEGRAL est en grande partie identique à celui de PayPal OPTION+. Seule change la page d’identification sur le site PayPal qui propose alors la possibilité de payer avec un autre moyen paiement que PAYPAL, sans que l’acheteur ait à se créer un compte PAYPAL :

Note1 : Il est recommandé de pré-remplir les noms et contacts de l’acheteur identifié, afin d’accélérer le processus de paiement.

Note2 : Merci de vous rendre sur le site www.PayPal.fr pour obtenir une liste à jour de tous les autres moyens de paiement proposés par PayPal dans chaque pays.

+ 21 hidden pages