Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
AperçuMettre votre intégration à niveau
Démarrer une intégration
Payment scenarios
Ajouter des moyens de paiement
Paiements par TPE
Other Stripe products

Accepter un paiement PayPal

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

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.

If you want to continue manually configuring the payment methods you present to your customers with Checkout, use this guide. Otherwise, update your integration to configure payment methods in the 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 :

  1. Ajoutez paypal à la liste des payment_method_types.
  2. Veiller à ce que tous vos line_items utilisent la même devise.
Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'paypal'],
  line_items: [{
    price_data: {
      currency: 'usd',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Traiter vos commandes

After accepting a payment, learn how to fulfill orders.

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.

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.
.*lost_dispute@.*Litige perduAu 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

En savoir plus sur les litiges et les remboursements PayPal.

Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service d'assistance.
Rejoignez notre programme d'accès anticipé.
Consultez notre journal des modifications des produits.
Des questions ? Contactez l'équipe commerciale.
Propulsé par Markdoc
Sur cette page
Déterminer la compatibilité
Accepter un paiement
Activer le moyen de paiement PayPal
Traiter vos commandes
Tester votre intégration
Scénarios de test
Gérer les litiges et les remboursements
Produits utilisés
Payments
Checkout