Guide d’implémentation - PayZen

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 –


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 –


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 –


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’ :

https://www.paypal-france.fr/marchands/

Payzen –


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 –


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 –


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 –


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 –


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 –


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 –


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 –


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 –


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 –


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 –


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 –


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 –


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 :

http://www.payzen.eu/integration/document/Guide_d_implementation_formulaire_Paiement_V2-4Payzen.pdf

http://www.payzen.eu/integration/document/Guide_d_implementation_formulaire_Paiement_V2-4Payzen.pdf

Payzen –


Guide d’implémentation - PayZen

Documents

Transcript of Guide d’implémentation - PayZen