Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageUtiliser Managed Payments
Paiements par TPE
Moyens de paiement
Ajouter des moyens de paiement
Scénarios de paiement
Au-delà des paiements

Accepter un paiement PayPal

Comment accepter les paiements PayPal, un portefeuille électronique populaire auprès des entreprises européennes.

Mise en garde

Stripe peut automatiquement proposer les moyens de paiement pertinents à vos clients en évaluant la devise, les restrictions liées aux moyens de paiement et d’autres paramètres.

  • Suivez le guide Accepter un paiement pour créer une intégration de paiement qui utilise des moyens de paiement dynamiques.
  • Si vous ne souhaitez pas utiliser de moyens de paiement dynamiques, suivez les étapes ci-dessous pour configurer manuellement les moyens de paiement dans votre intégration Checkout.

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

Remarque

Avant d’utiliser ce guide, commencez par créer une intégration permettant d’accepter un paiement avec Checkout.

Ce guide vous explique comment activer PayPal et montre les différences entre l’acceptation de paiements via des moyens de paiement dynamiques et la configuration manuelle des moyens de paiement.

Activer le moyen de paiement PayPal

Effectuez les actions suivantes à la création d’une session Checkout :

  1. Ajoutez paypal à la liste des payment_method_types.
  2. Veiller à ce que tous vos line_items utilisent la même devise.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=paypal \
  --data-urlencode success_url="https://example.com/success"

Traiter vos commandes

Maintenant que vous savez accepter des 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 votre intégration. Assurez-vous toutefois de connecter vos comptes PayPal et Stripe une fois prêt à activer les paiements en mode production.

Lorsque la page Checkout affiche le bouton PayPal, vous devez disposer d’un compte PayPal Sandbox personnel pour effectuer le test de paiement. Si la page Checkout indique PayPal comme moyen de paiement, sélectionnez PayPal et cliquez sur Payer - aucun compte PayPal Sandbox n’est nécessaire.

Pour simuler les scénarios d’intégration et d’échec les plus communs pour les paiements PayPal, transmettez des valeurs email correspondant aux modèles décrits dans ces scénarios de test.

Scénarios de test

E-mail typeScénarioExplication
.*payee_account_restricted@.*Compte marchand soumis à des restrictionsSi 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éeSi 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.
.*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

En savoir plus sur les litiges et les remboursements PayPal.