Contenu :
Plus d'informations
Les fonctions
Réaliser un paiement
Vous pouvez réaliser un paiement comptant à redirection. Les paiements à la commande ou à l'expédition sont disponibles.
- Paiement en mode One Time Payment.
- Paiement 1 Clic avec un portefeuille virtuel.
- Intégration PayPal en mode ExpressCheckOut PRÉVU DANS UN PROHAIN LOT
Les web services en mode web
Les fonctions disponibles avec les web services :
Interfaces de paiement : API WebPayment.
Paiement à la commande : en utilisant le service doWebPayment avec payment.mode à CPT et code Action à 100 ou 101.
- Mode de paiement : comptant avec le code Mode = CPT.
- Demande d'annulation d'une autorisation non encaissée : utilisez la fonction doReset permet au marchand de demander l’annulation totale de la commande.
- Demande de remboursement d'une transaction remisée : utilisez le service doRefund.
- Réponse de paiement : consulter la réponse du service getWebPaymentDetails pour obtenir les informations du moyen de paiement et de l'acheteur.
Le remboursement
Vous pouvez réaliser le remboursement de vos transactions PayPal depuis l'API Web Service doRefund ou sur le centre d'administration Monext Online.
La limite du montant des remboursements correspond par défaut au montant de la transaction d'origine.
Si vous souhaitez modifier ces limites, vous pouvez contacter votre responsable commercial PayPal.
Le délai max de remboursement est de 365 jours et configurable sur le moyen de paiement.
Le paiement one-clic
Plusieurs configuration sont nécessaires pour permettre ce parcours à l'acheteur :
1. Dans la console Paypal
- Option Vault activée sur le compte par un administrateur Paypal.
2. Dans le centre administration Monext Online
- Contacter le support pour activer les options de configuration
- pour le point de vente l'option "Enregistrement des données de paiement activée (Portefeuille virtuel)".
- pour le moyen de paiement l'option "Wallet.flag"='Y'
- Contacter le support pour activer les options de configuration
Mode Widget : Le commerçant communique dans le service doWebPayment les informations wallet (balise walletId à minima).
Mode Direct : le commerçant appelle le service doImmediateWalletPayment.
Les web services GetCards et GetWallet renvoient les mêmes informations du ou des comptes PayPal contenu dans le wallet interrogé si un ou plusieurs comptes PayPal y sont enregistrés.
Les informations sont les mêmes que celles retournées dans le GetWebPaymenDetails.
Journaux de transactions Payline
Toutes les transactions PayPal, acceptées, refusées et impayés, apparaissent dans le fichier des transactions de Payline.
Ce fichier peut être généré manuellement depuis notre centre d'administration ou automatiquement transmis sur vos serveurs par transfert de fichier sécurisé.
Le fichier des paiements avec Réconciliation est disponible.
Structure du compte PayPal
Les web services GetCards et GetWallet contiennent les mêmes informations du ou des comptes PayPal contenu dans le wallet interrogé si un ou plusieurs comptes PayPal y sont enregistrés.
Les informations sont les mêmes que celles retournées dans le GetWebPaymentDetails.
La structure PartnerAdditionalData de l'objet transaction avec une structure JSON contenant :
<AdditionalData> {
"PARTNER_TRANSACTION_ID":"xxxx",
"PAYER_EMAIL":"xxxx",
"PAYER_ID":"xxxx",
"PAYER_FIRTNAME":"xxxx",
"PAYER_LASTNAME":"xxxx",
"PAYER_STATUS":"xxxx",
"COUNTRY_CODE":"xxxx",
"GROSS_AMOUNT":"xxxx",
"PAYPAL_FEE":"xxxx",
"SALES_TAX":"xxxx",
"REASON_CODE":"xxxx", }
</additionalData>
Personnalisation PayPal
Le nom commercial est envoyé à PayPal. Ce paramètre est configuré dans le contrat du moyen de paiement.
La langue sera configurée lors de l'appel au service de paiement.
Nom de la ligne dans la table WEB_PAYMENT | Valorisation |
|---|---|
LANGUAGE_CODE | doWebPayment languagecode |
SoftDescriptor PayPal
L'information affichée sur le relevé de compte de l'acheteur et sur le ticket de paiement peut être transmise à PayPal.
Le champ softdescriptor des objets Transaction et Payment de l'API Payline est étendu à 127 caractères spécifiquement pour PayPal.
État En Attente
Ce moyen de paiement propose de générer des transactions en attente de validation. Votre transaction sera en attente avec l'état ONHOLD_PARTNER.
Il est recommandé de gérer cet état et d'indiquer l'état de la commande à votre acheteur.
Vous pouvez consulter la description de la gestion des états et des codes retour.
Champs Obligatoires
Obligatoire | Object | Balise |
|---|---|---|
O | payment | amount |
O | payment | currency |
N | payment | softDescriptor |
N | order | ref |
C | order | amount |
C | order | taxes |
N | order | deliveryMode |
C | order | deliveryCharge |
C | order | discountAmount |
N | order | details.comment (tronqué à 127 caractères) |
C | order | details.price |
C | order | details.quantity |
N | buyer | firstName |
N | buyer | last_name |
N | buyer | buyer.mobilePhone |
N | buyer | buyer.email |
C | buyer | shipping.country |
N | buyer | shipping.street1 |
N | buyer | shipping.street2 |
N | buyer | shipping.state |
N | buyer | shipping.cityName |
N | buyer | shipping.zipCode |
N | buyer | buyer.shippingAddress.phone |
N | buyer | buyer.mobilePhone |
N | private data (max 127 caractères) : [cle::valeur][cle::valeur] |
Pour obtenir la garantie de PayPal et bénéficier la garantie marchand contre les contestations des acheteurs, il est essentiel de rajouter les détails du panier :
- order.details.ref
- order.details.price
- order.details.quantity
Afin de faciliter la migration sur ce nouveau PayPal, vous pouvez supprimer l'envoi du détail du panier en configuration du moyen de paiement avec l'option : 
Règle obligatoire
Les montants de la transaction et de la commande doivent être cohérents.
- payment.amount = order.amount
- order.amount = SUM(order.details.price x order.details.quantity) + order.deliverycharge - order.discountAmount
Intégration du paiement en mode widget / page web
Étape 1 : Utilisation de l'interface Web
Pour réaliser un paiement
- Initier le paiement Depuis le Web services doWebPayment.
- Récupérer le résultat de la transaction avec le Web Service getWebPaymentDetails.
Le web service doWebPayment
Le service doWebPayment permet d'initialiser une transaction de paiement web avant de rediriger votre client sur les pages de paiement Payline :
- Avec un paiement immédiat en indiquant les champs « payment.Action » à 101, « payment.Mode » à CPT et « payment.ContractNumber » avec le numéro de contrat PAYPAL.
Payline réalise une demande d'autorisation auprès de l'acquéreur et dans le cas d'un accord, Payline valide automatiquement le paiement. - Avec un paiement à l'expédition en indiquant les champs « payment.Action » à 100, « payment.Mode » à CPT et « payment.ContractNumber » avec le numéro de contrat PAYPAL.
Pour déclencher le paiement, vous devez réaliser un appel au web service doCapture avec votre numéro de contrat PAYPAL et l'identifiant de votre transaction d'autorisation initiale. 
Fournir l'email dans l'object buyer afin d'afficher l'email dans la page de login de PayPal.
- Avec un paiement immédiat en indiquant les champs « payment.Action » à 101, « payment.Mode » à CPT et « payment.ContractNumber » avec le numéro de contrat PAYPAL.
Le web service getWebPaymentdetails
Pour obtenir le résultat de la transaction de paiement, Payline met à votre disposition ce web service getWebPaymentdetails.
Vous devez transmettre le jeton d'authentification délivré par Payline lors de la demande d'initialisation (résultat de la fonction doWebPayment) pour obtenir un résultat détaillé du paiement.
Mode d'intégration
Payline redirige l'acheteur sur les pages de paiement PayPal.
Étape 2 : Gérer vos encaissements PayPal avec Payline
Vous pouvez réaliser les opérations d'encaissement correspondant au montant initial de vos transactions PayPal :
- Validations partielles ou total.
- Remboursements partiels ou total.
Intégration du paiement 1 Clic avec un portefeuille virtuel
Le principe
Le principe du paiement en 1 clic est de permettre au consommateur de payer chez un commerçant sans avoir à s'authentifier sur PayPal à partir du deuxième achat.
- Lors du choix de PayPal dans la première commande, le consommateur est invité à donner son accord pour de futurs achats en '1 clic' ;
- Si le paiement est mené à son terme, Payline enregistre les informations d'agrément de paiement de PayPal ;
- À partir de la deuxième commande, le choix du moyen de paiement PayPal rappelle l'accord du consommateur pour de futurs achats en '1 clic'. La simple validation du choix du moyen de paiement déclenche le paiement.
Les fonctionnalités
Payline propose au commerçant de définir depuis son compte commerçant s'il autorise ou non les paiements en 1 clic et propose la gestion par l'API :
- Demande de l'accord du consommateur PayPal
- Payline affiche la case à cocher pour collecter l'accord du consommateur sur la page choix du moyen de paiement gérée par Payline ;
- Dans le cas où le choix du moyen de paiement est proposé sur la boutique en ligne, le commerçant renseigne le champ walletID de l'API Payline lorsqu'il obtient l'accord du consommateur.
- Enregistrement et gestion de la référence de l'accord
- Payline enregistre la référence de l'accord dans le portefeuille virtuel Payline (wallet) utilisé pour le paiement 1 clic via carte bancaire. De ce fait, pour le commerçant l'utilisation du paiement en 2 clics ne nécessite aucun développement supplémentaire s'il utilise déjà cette API.
- En complément, Payline fournit au commerçant une page de « gestion » des moyens de paiement enregistrés (1 clic visa/mastercard et 2 clic PayPal).
- Demande de l'accord du consommateur PayPal
Les limites sont les suivantes :
- Type autorisation+validation (action=101) et autorisation (action=100) ;
- Seule la fonction suppression est disponible avec le service ManageWebWallet ;
- Un seul contrat PayPal par portefeuille (External_Wallet_ID) est autorisé.
- L'option de Activation du portefeuille doit être activé dans la configuration du moyen de paiement Payline.
Un identifiant de wallet correspond à un External_Wallet_ID, ceci suffit à identifier le wallet PayPal courant qui est unique.
Les web services
L'option '1-clic' est utilisée par le commerçant si le « doWebPayment » contient un identifiant de wallet et un seul contrat VAD.
Il existe un accord de paiement s'il existe un Wallet avec External_Wallet_ID égal aux arguments reçus via le « doWebPayment » et si la case à cocher de l'accord de paiement a été sélectionnée.
L'accord d'enregistrement peut être transmis en paramètre de la fonction doWebPayment avec un PrivateData dont la clé est recordingAgreement, la valeur est 'Y'.
Le service doImmediateWalletPayment est également disponible pour réaliser les paiements : SI l'option '1-clic' est configurée et activée et s'il existe un accord de paiement.
WALLET | Valorisation |
|---|---|
LASTNAME | doWebPayment : buyer.lastName |
FIRSTNAME | doWebPayment : buyer.firstName |
doWebPayment : buyer.email | |
EXTERNAL_WALLET_ID | doWebPayment : buyer.walletId |
| IP | doWebPayment : buyer.ip |
Voir l'objet buyer de l'API Payline.
1er paiement : exemple de page de redirection avec utilisation du portefeuille virtuel
En mode widget :
Paiement suivant : exemple de page de redirection avec utilisation du portefeuille virtuel
Gestion du portefeuille
Le service manageWebWallet permet à l'acheteur la suppression du moyen de paiement PayPal d'un portefeuille.
Pour configurer PayPal
Vous devez sélectionner deux nouvelles options sur votre compte Paypal dans vos environnement d'homologation et de production : voir la configuration de Paypal.
Les codes retour
- Lorsque Payline n'a aucun retour du consommateur une fois redirigé chez PayPal, par exemple : lorsque le navigateur est fermé, vous recevrez une notification de refus avec le motif CANCELLED et un code 02319.
Le paiement est accepté avec réserve (Etat temporaire) : l'état de l'opération de type commande est PENDING_RISK avec le code 02017.
Le paiement a été acquitté par Paypal et mis en attente pour une prise de décision ultérieure (Etat temporaire) : l'état de l'opération de type commande est ONHOLD_PARTNER avec le code 02005.
- Vous pouvez demander à PayPal de configurer sur votre compte business de recevoir un CANCELLED à la place du PENDING (=ONHOLD_PARTNER).
Monext Online vous informe du résultat d’un paiement via le ShortMessage, selon le mode d'intégration proposé par le moyen de paiement. Les états retournés : La gestion des états et des codes retour sont listés ici.