Accepter un paiement PayPal
PayPal est un moyen de paiement réutilisable à notification immédiate qui demande aux clients d’authentifier leur paiement. Pour effectuer un paiement avec PayPal, les clients sont redirigés depuis votre site Web vers PayPal où ils choisissent une source de financement (par exemple, un portefeuille PayPal, une carte associée ou une méthode de paiement différé fournie par PayPal) et authentifient le paiement. À l’issue du processus d’autorisation, le client est redirigé vers votre site Web.
Stripe Checkout et le composant Express Checkout Element prennent tous deux en charge le bouton PayPal indépendant. Ce bouton permet à un client de réutiliser ses informations de livraison et de facturation précédemment enregistrées sur PayPal afin de ne pas avoir à les saisir à nouveau au moment d’un achat. En cliquant sur ce bouton, un client peut approuver le paiement à partir d’une fenêtre contextuelle (?window/modal/redirected/embedded) sans avoir à quitter votre site Web. Ce bouton prend uniquement en charge les paiements PayPal ponctuels (non récurrents).
Mise en garde
Stripe propose automatiquement à vos clients des options de moyens de paiement selon leur devise, les restrictions sur les moyens de paiement et d’autres paramètres. Nous vous recommandons de configurer vos moyens de paiement à partir du Dashboard Stripe en suivant les instructions indiquées dans Accepter un paiement.
Si vous souhaitez continuer à configurer manuellement les moyens de paiement proposés à vos clients avec Checkout, utilisez ce guide (par exemple, pour accepter des paiements en mode abonnement). Sinon, migrez vers le Dashboard.
Stripe Checkout affiche PayPal comme un moyen de paiement standard ou sous la forme d’un bouton indépendant, selon l’option la plus susceptible d’augmenter le taux de conversion.
Déterminer la compatibilité
Une session Checkout doit remplir toutes les conditions suivantes pour prendre en charge les paiements PayPal :
- Pour tous les postes, les tarifs doivent être exprimés dans la même devise. Si vous avez des postes dans diverses devises, créez des sessions Checkout distinctes pour chaque devise.
Accepter un paiement
Note
Avant d’utiliser ce guide, commencez par créer une intégration permettant d’accepter un paiement avec Checkout.
Suivez ce guide pour savoir comment activer PayPal et découvrir les différences entre l’acceptation d’un paiement par carte bancaire et l’utilisation de PayPal.
Activer le moyen de paiement PayPal
Effectuez les actions suivantes à la création d’une session Checkout :
- Ajoutez
paypal
à la liste despayment_method_types
. - Veiller à ce que tous vos
line_items
utilisent la même devise.
Traiter vos commandes
Après l’acceptation de paiements, découvrez comment traiter les commandes.
Tester votre intégration
Il n’est pas nécessaire de connecter votre compte professionnel PayPal pour tester l’intégration. Vous devez cependant connecter vos comptes PayPal et Stripe avant d’activer les paiements en mode production.
Lors du test de votre intégration Checkout, sélectionnez le moyen de paiement PayPal et cliquez sur Payer.
To simulate the most common integration and failure scenarios for PayPal payments, pass email
values that match the patterns described in these test scenarios.
Scénarios de test
E-mail type | Scénario | Explication |
---|---|---|
.*payee_account_restricted@.* | Compte marchand soumis à des restrictions | Si votre compte marchand est limité par PayPal, la capture ou l’autorisation du paiement échoue avec l’erreur payment_method_unexpected_state . Pour faire échouer l’autorisation, veuillez indiquer une adresse e-mail correspondant à ce modèle au moment de l’autorisation. |
.*transaction_refused@.* | Transaction refusée | Si la transaction est refusée par PayPal, la capture du paiement échoue avec l’erreur payment_method_provider_decline . |
.*instrument_declined@.* | Instrument de paiement refusé | Si l’instrument présenté est refusé par le prestataire de services de paiement ou la banque, ou bien qu’il ne peut pas être utilisé pour ce paiement, la capture du paiement échoue avec l’erreur payment_method_provider_decline . |
.*lost_dispute@.* | Litige perdu | Au moment de la capture, le PaymentIntent est contesté. Le litige créé est déjà perdu et le marchand ne peut pas soumettre de preuves dans le Dashboard Stripe. |
.*authorization_expired@.* | Capturer manuellement un paiement autorisé | Si l’autorisation a déjà expiré, la capture du paiement autorisé échoue avec l’erreur capture_charge_authorization_expired . |
Gérer les litiges et les remboursements
Apprenez en plus sur les litiges et les remboursements PayPal.