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

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'

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.


Récupération des informations de PayPal

Certaines informations provenant de PayPal sont retournées au commerçant dans la structure PartnerAdditionalData de l'objet transaction avec une structure JSON contenant :

    • Email du compte acheteur PayPal ;
    • Statut du compte (verified/unverified) ;
    • Pays du compte (ISO3166) ;
    • Identifiant de la transaction PayPal est restitué dans a balise referenceID pour les version de l'API supérieure ou égale à 16.

Le champ est valorisé pour chaque transaction réalisée avec PayPal si au moins un des 3 informations est disponible et pour une version du service 16 ou supérieur avec le typeCarte = PAYPAL.

Cette structure sera retourné dans les réponses des services : getTransactionDetails et getWebPaymentDetails.


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

ObjectBalise

O

paymentamount

O

paymentcurrency

N

paymentsoftDescriptor

N

orderref

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

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


Les champs suivants sont enregistrés dans le portefeuille (Code commun non spécifique à un MdP) PAYPAL_APIREST - Echanges partenaires (Workflow & Mapping)

Champ Wallet

Source

Champ PayPal

FIRSTNAME

MARCHAND (TRAME)

buyer.firstName

LASTNAME

MARCHAND (TRAME)

buyer.last_name

ADDRESS_NAME

MARCHAND (TRAME)

buyer.shippingAddress.title

ADDRESS_STREET1

MARCHAND (TRAME)

buyer.shippingAddress.street1

ADDRESS_STREET2

MARCHAND (TRAME)

buyer.shippingAddress.street2

ADRESS_CITYNAME

MARCHAND (TRAME)

buyer.shippingAddress.cityName

ADDRESS_COUNTRY

MARCHAND (TRAME)

buyer.shippingAddress.country

ADDRESS_ZIPCODE

MARCHAND (TRAME)

buyer.shippingAddress.zipCode

ADDRESS_PHONE

MARCHAND (TRAME)

buyer.shippingAddress.phone

ADDRESS_MOBILE

MARCHAND (TRAME)

buyer.mobilePhone

EMAIL

PARTNER

buyer.email





Intégration du paiement en mode widget / page web

Étape 1 : Utilisation de l'interface Web


Pour réaliser un paiement

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.

    • (ampoule) Fournir l'email dans l'object buyer afin d'afficher l'email dans la page de login de 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). 

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

EMAIL

doWebPayment : buyer.email

EXTERNAL_WALLET_ID

doWebPayment : buyer.walletId

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



 Remplace par les codes retour APM

  




Pages associées