Post on 19-Jun-2022
Payzen –
Guide d’implémentation - Paypal 1/18
Guide d’implémentation
Intégration du moyen de paiement PayPal
Paiement différé (Mode Order)
Version 1.0
Payzen –
Guide d’implémentation - Paypal 2/18
SUIVI, HISTORIQUE
Rédaction, Vérification, Approbation
Rédaction Vérification Approbation Nom Date/Visa Nom Date/Visa Nom Date/Visa
Lyra-Network 24/08/2011 Lyra-Network 24/08/2011 Lyra-Network 24/08/2011
Historique du document
Version Auteur Date Commentaires
1.0 Lyra-Network 24/08/2011 Version initiale.
Confidentialité
Toutes les informations contenues dans ce document sont considérées comme confidentielles.
L’utilisation de celles-ci en dehors du cadre de cette consultation ou la divulgation à des
personnes extérieures est soumise à l’approbation préalable de Lyra Network.
Payzen –
Guide d’implémentation - Paypal 3/18
SOMMAIRE
Suivi, historique ....................................................... 2
1. Presentation ......................................................... 4
2. Pré requis ............................................................. 4 2.1: Création d’un compte PayPal .................................................................................................................................................................... 4
3. Paramétrage depuis le back office ........................ 4 3.1: Ajout et paramétrage du contrat (Back office commerçant) ..................................................................................................... 4 3.2: Gestion des habilitations ............................................................................................................................................................................ 5 3.3: Association à la boutique ............................................................................................................................................................................ 5
4. Cinématique de paiement ..................................... 6
5. Paiement différé ................................................... 8 5.1: Délai capture inférieur ou égal à 3 jours ............................................................................................................................................. 8 5.2: Délai capture supérieur à 3 jours ........................................................................................................................................................... 8
6. Opérations possibles sur les transactions ............. 9 6.1: Transaction effectuée avec un paiement différé .............................................................................................................................. 9 6.2: Valider ................................................................................................................................................................................................................. 9 6.3: Modifier ........................................................................................................................................................................................................... 10 6.4: Annuler ............................................................................................................................................................................................................ 12 6.5: Editer la référence commande .............................................................................................................................................................. 13 6.6: Renvoyer l’email de confirmation ....................................................................................................................................................... 13 6.7: Expiration de la transaction ................................................................................................................................................................... 13
7. Opérations Spécifiques en multi capture ............ 13 7.1: Présentation .................................................................................................................................................................................................. 13 7.2: Procédure multi capture .......................................................................................................................................................................... 14 7.3: Clôturer ........................................................................................................................................................................................................... 16
8. Formulaire de paiement ..................................... 16 8.1: Paramètre paiement .................................................................................................................................................................................. 16 8.2: Délai de capture ........................................................................................................................................................................................... 16 8.3: Paramètre de validation........................................................................................................................................................................... 17 8.4: Formulaire de paiement en php ........................................................................................................................................................... 17
Payzen –
Guide d’implémentation - Paypal 4/18
1. PRESENTATION
Ce document présente le moyen de paiement PayPal et son intégration dans la plateforme
Payzen.
2. PRE REQUIS
La transaction de paiement se fait entre le compte marchand et le compte client, vous devez
donc avoir impérativement un compte PayPal Entreprise:
Soit vous ne possédez pas de compte PayPal, dans ce cas, il faudra en créer un comme
dans le chapitre 2.1
Soit vous possédez déjà un compte PayPal et dans ce cas, vous pouvez passer directement
au chapitre 3
2.1: Création d’un compte PayPal
Pour commencer, vous devez créer un compte marchand, connectez vous sur le site suivant:
https://www.paypal-france.fr/marchands/
Dans l’onglet marchant, vous avez une multitude d’offre. Choisissez celle qui vous convient le
mieux, puis renseignez les champs demandés.
Attention : A la fin de l’inscription, PayPal vous enverra un mail de confirmation de l’inscription. Il est
important de le faire sinon votre compte ne sera pas actif.
3. PARAMETRAGE DEPUIS LE BACK OFFICE
3.1: Ajout et paramétrage du contrat (Back office commerçant)
Paramétrage/ Enseigne / Comptes PayPal
Cliquez ensuite sur ‘Ajouter un compte’ :
Payzen –
Guide d’implémentation - Paypal 5/18
Une nouvelle fenêtre apparait :
Détail des champs à renseigner:
Email :
Paramètre obligatoire. Il s’agit de votre email PayPal Professionnel.
Mode du compte :
Sandbox : Mode test
Live : Mode production
3.2: Gestion des habilitations
Pour recevoir les paiements sur le compte PayPal, il est indispensable de donner l’habilitation :
En cliquant sur ce bouton, vous allez être redirigé sur le site PayPal, où il vous sera demandé de
vous identifier et d’accepter les permissions.
3.3: Association à la boutique
Pour proposer le moyen de paiement PayPal il faut associer le contrat à votre boutique.
Ce paramétrage se fait en cochant la case boutique associé au compte. N’oubliez pas de cliquer
sur sauvegarder pour que le paramètre soit enregistré.
Payzen –
Guide d’implémentation - Paypal 6/18
4. CINEMATIQUE DE PAIEMENT
L’internaute finalise sa commande sur le site marchand, en choisissant le logo PayPal il est redirigé
sur la plateforme de paiement PayPal :
Payzen –
Guide d’implémentation - Paypal 7/18
L’internaute devra s’identifier et sera redirigé sur cette page :
Ainsi l’internaute pourra vérifier si le montant est correct avant de valider son paiement.
En cliquant sur le bouton payer, il sera redirigé sur la plateforme Payzen qui affichera le résultat du
paiement :
Payzen –
Guide d’implémentation - Paypal 8/18
5. PAIEMENT DIFFERE
Le délai de capture est strictement supérieur à 0. Comme pour un paiement par Carte Bancaire, le
comportement diffère si le délai de capture est supérieur à la durée de validité de l’autorisation. Il
est de 3 jours pour PayPal au lieu de 6 pour la CB.
5.1: Délai capture inférieur ou égal à 3 jours
Une autorisation est effectuée le jour du paiement. La capture sera faite le jour de la date de
présentation demandée.
5.2: Délai capture supérieur à 3 jours
Le jour du paiement, une opération semblable à la prise d’empreinte.
L’autorisation quant à elle sera réalisée 3 jours avant la date de présentation demandée.
La capture est toujours faite le jour de la date de présentation.
Veuillez trouver ci dessous un exemple de transaction pour un paiement différé avec un délai de
10 jours :
- Date de création de la transaction.
- Statut : En attente d’auto : seul une
demande d’empreinte a été réalisée.
L’autorisation sera faite ultérieurement
- Date de présentation demandée,
soit 10 jours après la création.
Le paiement est réalisé le 19/08/2011
La date de présentation demandée
est le 29/08/2011
La demande d’autorisation sera
réalisée le 26/08/2011 soit 3 jours
avant la date de présentation
demandée.
- Mention empreinte, uniquement en
mode différé.
Payzen –
Guide d’implémentation - Paypal 9/18
6. OPERATIONS POSSIBLES SUR LES TRANSACTIONS
6.1: Transaction effectuée avec un paiement différé
Pour modifier une transaction, vous devez faire un clic droit sur la transaction que vous souhaitez.
Une fenêtre s’ouvre comme ci-dessus, plusieurs opérations sont disponibles.
6.2: Valider
Le mode de validation est automatique pour les paiements immédiats. En revanche, pour le
paiement différé, le marchand aura la possibilité de valider le paiement ou de le laisser en
validation automatique. Voir chapitre 8 pour l’intégrer au formulaire.
Si vous choisissez la validation manuelle, vous devrez valider le paiement ultérieurement. Dans ce
cas la transaction aura comme statut A valider (délai de capture initial inferieur à 3 jours) ou A
valider et autoriser (délai initial supérieur à 3 jours).
Statut A valider
Choisissez donc votre transaction et cliquez sur « Valider » puis une fenêtre de confirmation
s’ouvrira.
Vous visualisez le nouveau statut de la transaction
Le statut d’un paiement avec un délai de capture inférieur ou égal à 3 jours, après la validation,
est « En attente de remise »
Statut A valider et autoriser
Choisissez donc votre transaction et cliquez sur « Valider » puis une fenêtre de confirmation
s’ouvrira.
Payzen –
Guide d’implémentation - Paypal 10/18
Vous visualisez le nouveau statut de la transaction
Le statut d’un paiement avec un délai de capture supérieur à 3 jours, après la validation, est « En
attente d’auto»
L’autorisation sera réalisée à j-3 avant la date de présentation fixée initialement.
6.3: Modifier
L’option modifiée est uniquement possible sur les transactions ayant comme statut :
- A valider
- A valider et autoriser
- En attente d’auto.
- En attente de remise
Montant
Contrairement au paiement immédiat, tant que la transaction n’a pas atteint la date de
présentation, il est possible pour le marchand de modifier le montant. Le nouveau montant doit
être inférieur au montant initial.
Date de présentation
Il est également possible de modifier la date de présentation, de reculer ou d’avancer celle-ci.
- Pour les transactions ayant un statut « en attente de remise » ou « à valider » la plage
possible de présentation est de 3 jours. En effet la demande d’autorisation valable 3 jours a
déjà été effectuée.
Exemple ci-dessous :
- Pour les transactions ayant un statut « A valider et autoriser » ou « En attente d’auto » vous
pouvez choisir la date de votre choix.
Exemple ci-dessous :
Payzen –
Guide d’implémentation - Paypal 11/18
Exemple
Choisissez donc l’option comme ci-dessous pour procéder à la modification du montant.
Renseignez le nouveau montant et la nouvelle date de présentation si nécessaire.
Après avoir validé la modification de la transaction, si on affiche les détails, nous pouvons constater
le changement :
Montant initial lors de la
transaction effectué par le
client.
Montant actuel
Date de présentation modifiée.
Payzen –
Guide d’implémentation - Paypal 12/18
REMARQUE
Si la modification est réalisée sur un paiement non validé (statut à valider ou à valider et autoriser)
alors il sera possible de valider la transaction comme ci-dessous :
6.4: Annuler
Tant que la transaction n’a pas atteint la date de présentation, il est possible d’annuler la
transaction. Pour cela, faites un clic droit sur votre transaction et sélectionnez le bouton ci-dessous.
Une fenêtre de confirmation s’ouvrira, choisissez OK pour continuer.
Détail de la transaction :
Le statut de la transaction
devient « annulé ».
Payzen –
Guide d’implémentation - Paypal 13/18
6.5: Editer la référence commande
Vous avez la possibilité d’éditer la référence commande. Pour cela faites un clic droit sur la
transaction puis sélectionnez le champ suivant.
Une fenêtre s’ouvre, modifiez librement la référence de votre commande puis cliquez sur OK.
6.6: Renvoyer l’email de confirmation
Comme pour le paiement immédiat, il est possible de renvoyer un email de confirmation.
Pour cela faire un clic droit sur la transaction, puis de sélectionner votre choix.
6.7: Expiration de la transaction
Tous les paiements dans un statut « A valider ou A valider et autoriser » expirent à la date de
présentation demandée si ces derniers n’ont pas été validés manuellement.
Le statut de la transaction est « Expiré »
7. OPERATIONS SPECIFIQUES EN MULTI CAPTURE
7.1: Présentation
Le mode multi capture est une option de PayPal qui se configure sur le compte marchand. Il est
possible que vous n’ayez pas cette option si vous n’avez pas souscrit à l’offre multi-capture.
Rapprochez vous de Paypal pour en savoir plus pour cette option.
Cette option doit être également rajoutée sur votre compte Payzen.
Le mode multi capture permet de capturer en plusieurs fois une partie du montant ou sa totalité.
Exemple 1 : Totalité du montant
Un paiement de 100 euros pour 2 articles (30 euros et 70 euros)
- Départ livraison premier article => débit 30 euros
- Départ livraison 2eme article => débit 70 euros
- Clôture définitive de la commande
Payzen –
Guide d’implémentation - Paypal 14/18
Exemple 2 : montant partiel
Un paiement de 100 euros pour 2 articles (30 euros et 70 euros)
- Départ livraison premier article => débit 30 euros
- Clôture définitive de la commande
7.2: Procédure multi capture
Ci-dessous la transaction sur laquelle sera appliquée l’option multi capture. Le montant initial de la
transaction dans cet exemple est de 100 euros.
Etape 1 : Annulation
Cette opération d’annulation permet d’annuler définitivement la commande. Avec l’option multi-
capture la commande reste cependant ouverte.
Sélectionnez la transaction, effectuez un clic droit et sélectionnez Annuler
La transaction est annulée mais la commande reste ouverte.
Etape 2 : Dupliquer
Cette opération permet de dupliquer la transaction annulée en indiquant un montant partiel et la
date de présentation.
Sélectionnez la transaction annulée, effectuez un clic droit et sélectionnez Dupliquer
La fenêtre de duplication apparaît à l’écran, Saisir le montant partiel (exemple 70 euros) et la date
de présentation.
Ecran suivant :
Fixez la date de présentation au jour
même si vous souhaitez capturer le
montant immédiatement.
Fixez le montant.
Payzen –
Guide d’implémentation - Paypal 15/18
Vous avez donc capturé 70 euros sur 100 euros. Vous pouvez renouveler plus tard cette opération
pour capturer le montant restant (30 euros) comme décrit ci-dessous.
Sélectionner la transaction annulée de 100 euros. Clic droit puis « dupliquer » :
Ecran suivant :
Vous avez donc capturé 30 euros.
Résumé de la visualisation sur le back office
Cette ligne correspond à la transaction initiale de 100 euros qui a été annulé.
Cette ligne correspond à la première capture partielle de 70 euros.
Cette ligne correspond à la deuxième capture de 30 euros.
La totalité du montant de la transaction initiale a été capturée. Plus aucun autre montant ne sera
capturé pour cette transaction. Il est possible de clôturer la commande auprès des services de
PayPal.
Fixez la date de présentation dans 6
jours si vous souhaitez par exemple
débiter ce montant dans 6 jours.
Fixez le montant.
Payzen –
Guide d’implémentation - Paypal 16/18
ATTENTION : Cette opération de « clôture » ne devra être réalisée que lorsque tous les paiements
auront été envoyés à PayPal. Cela signifie que les paiements liés à la commande sont visualisables
dans l’outil de gestion de caisse dans l’onglet paiement remis.
Remarque : Il est possible de clôturer une transaction même si celle-ci a été capturée
partiellement. A noter une fois la transaction clôturée plus aucune autre capture ne sera autorisée.
7.3: Clôturer
Une fois que les transactions de capture partielle seront envoyées à PayPal, et donc remontées
dans l’onglet paiement remis, vous pouvez clôturer la commande. Si vous ne réalisez pas cette
étape, votre client verra dans son compte PayPal « paiement en cours » indéfiniment.
ATTENTION: si vous clôturez la commande alors que certaines transactions rattachées à cette
commande se situent toujours dans l’onglet paiement en cours, vous annulerez ces transactions.
Soyez donc vigilent et attendez que tous les paiements rattachés à une commande se situent
dans l’onglet « Paiement remis » avant d’effectuer une clôture.
8. FORMULAIRE DE PAIEMENT
8.1: Paramètre paiement
Dans votre formulaire d’envoi, il est possible de rajouter un paramètre nommé
vads_payment_cards. Celui-ci vous permettra d’envoyer l’internaute directement sur la page
PayPal, autrement dit sans avoir à choisir le mode de paiement.
Le paramètre à rajouter est le suivant :
vads_payment_cards = PAYPAL_SB => pour le mode test
vads_payment_cards = PAYPAL =>pour le mode production
Si vous laissez vide le paramètre alors sera proposé l’ensemble des moyens de paiement (CB,
PayPal, etc ...).
8.2: Délai de capture
Dans le formulaire il est possible de préciser le délai de remise à PayPal.
Le paramètre à rajouter ou modifier dans votre formulaire est :
vads_capture_delay = valeur exprimé en jour (nombre entier)
Le délai de capture égal zéro correspond au paiement immédiat (chapitre 3.1)
Le délai de capture supérieur ou égal à 1 correspond au paiement immédiat (chapitre 3.2)
Payzen –
Guide d’implémentation - Paypal 17/18
8.3: Paramètre de validation
Dans le formulaire il est possible de préciser le type de validation d’une transaction.
Le paramètre à rajouter ou modifier dans votre formulaire est :
vads_validation_mode = 1 => mode manuel
vads_validation_mode = 0 => mode automatique
ATTENTION : dans le cas d’un délai de capture égal à 0 il est impératif d’avoir un type de validation
positionnée à automatique.
vads_validation_mode = 0 => mode automatique
Ce paramètre est décrit dans la documentation chapitre 5.2.1
Pour plus d’information veuillez consulter la documentation d’intégration du formulaire de
paiement.
http://www.payzen.eu/integration/document/Guide_d_implementation_formulaire_Paiement_V2-
4Payzen.pdf
8.4: Formulaire de paiement en php
Exemple pour PayPal :
Payzen –
Guide d’implémentation - Paypal 18/18