Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous
AperçuAccepter un paiementMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usagePaiements récurrents
Paiements par TPE
Disponibilité
Moyens de paiement
Ajouter des moyens de paiement
Opérations de paiement
Soldes et délai de règlementReçusRemboursements et annulations
Intégrations avancées
Au-delà des paiements

Accepter un paiement PayPal

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

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.

Activer le moyen de paiement PayPal

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

  1. Activez PayPal dans votre Dashboard. Stripe affiche automatiquement PayPal aux clients éligibles grâce aux moyens de paiement dynamiques. Si vous spécifiez actuellement payment_method_types, consultez le guide de migration.
  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_VePHdqKTYQjKNInc7u56JBrQ
:" \
  -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 \
  --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.