Accepter un paiement PayPal

Stripe envoie un événement payment_intent.succeeded à l’issue du paiement. Utilisez le Dashboard, un webhook personnalisé ou une solution partenaire pour recevoir ces événements et exécuter des actions, comme envoyer une confirmation de commande par e-mail à votre client, enregistrer la vente dans une base de données ou lancer un workflow de livraison.

Plutôt que d’attendre un rappel de votre client, écoutez ces événements. En effet, côté client, l’acheteur pourrait fermer la fenêtre de son navigateur ou quitter l’application avant l’exécution du rappel. Des personnes malveillantes peuvent en profiter pour manipuler la réponse. Si vous configurez votre intégration de manière à écouter les événements asynchrones, cela vous permettra également d’accepter de nouveaux moyens de paiement plus facilement à l’avenir. Apprenez-en davantage sur les différences entre les différents moyens de paiement pris en charge.

Recevoir des événements et exécuter des actions métier

Plusieurs options s’offrent à vous pour recevoir et exécuter des actions métier.

Manuellement

Utilisez le Dashboard pour consulter tous vos paiements Stripe, envoyer des reçus par e-mail, gérer les virements et relancer les paiements ayant échoué.

• Afficher vos paiements tests dans le Dashboard

Code personnalisé

Créez un gestionnaire de webhooks pour écouter des événements et créer des tunnels de paiement asynchrones personnalisés. Testez et déboguez votre intégration de webhooks en local, grâce à la CLI Stripe.

• Créer un webhook personnalisé

Applications préconfigurées

Intégrez une application partenaire pour gérer les événements métier courants, comme l’automatisation, le marketing ou les ventes.

Stripe.js vous aide à ajouter d’autres moyens de paiement à votre intégration. Cependant, vous pouvez rediriger vos clients manuellement vers votre serveur.

1. Créez et confirmez un PaymentIntent de type paypal. En spécifiant payment_method_data, vous créez un PaymentMethod qui est utilisé immédiatement avec ce PaymentIntent.

Vous devez également fournir dans le champ return_url l’URL vers laquelle le client est redirigé une fois qu’il a finalisé son paiement. Vous pouvez fournir vos propres paramètres de requête dans cette URL. Ces paramètres seront inclus dans l’URL finale à l’issue du flux de redirection.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=paypal \
  -d "payment_method_data[type]"=paypal \
  --data-urlencode return_url="https://example.com/checkout/complete" \
  -d confirm=true

1. Vérifiez que le PaymentIntent a l’état requires_action et que le type de next_action est redirect_to_url.

{
  "status": "requires_action",
  "next_action": {
    "type": "redirect_to_url",
    "redirect_to_url": {
      "url": "https://hooks.stripe.com/...",
      "return_url": "https://example.com/checkout/complete"
    }
  },
  "id": "pi_1G1sgdKi6xqXeNtkldRRE6HT",
  "object": "payment_intent",
  ...
}

1. Redirigez le client vers l’URL fournie dans la propriété next_action.redirect_to_url.url. Cet exemple de code fourni ici n’a qu’une valeur illustrative : la méthode de redirection peut différer sur votre framework Web.

if payment_intent.status == 'requires_action' && payment_intent.next_action.type == 'redirect_to_url'
  url = payment_intent.next_action.redirect_to_url.url
  redirect(url)
end

Le client est redirigé vers l’URL return_url une fois qu’il a effectué le paiement. Les paramètres de la requête d’URL payment_intent et payment_intent_client_secret sont inclus avec tous vos propres paramètres. Stripe recommande de configurer un endpoint de webhook pour configurer l’état d’un paiement par voie programmatique.

PayPal prend en charge l’autorisation et la capture distinctes. Si vous avez opté pour la réception des fonds sur votre compte Stripe, vos autorisations sont valables pendant 10 jours. Stripe réautorise automatiquement le paiement pour prolonger la période d’autorisation de 10 jours supplémentaires, ce qui correspond à un total de 20 jours. Si la réautorisation ne fonctionne pas, Stripe fait expirer le paiement au bout de 10 jours. Écoutez le webhook charge.expired pour connaître la date de fin de la période d’autorisation.

Si vous avez choisi de recevoir les fonds sur PayPal, vos autorisations restent valides durant 3 jours. Stripe tente de prolonger la période d’autorisation de 3 jours supplémentaires. Pour bénéficier d’une période d’autorisation garantie étendue pouvant aller jusqu’à 10 jours, appelée honor period dans PayPal, contactez le service de support de PayPal.

Indiquez à Stripe d’autoriser seulement

Pour indiquer que vous souhaitez une autorisation et une capture séparées, définissez capture_method sur manual lors de la création du PaymentIntent. Ce paramètre indique à Stripe de n’autoriser que le montant figurant sur le compte PayPal du client.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d capture_method=manual \
  -d "payment_method_types[]"=paypal \
  -d "payment_method_data[type]"=paypal \
  -d confirm=true \
  --data-urlencode return_url="http://example.com"

Une fois l’autorisation accordée, Stripe envoie un événement payment_intent.amount_capturable_updated. Pour en savoir plus, consultez notre guide des événements.

Capturer les fonds

Une fois l’autorisation réussie, l’état du PaymentIntent passe à requires_capture. Pour capturer les fonds autorisés, faites une requête de capture PaymentIntent. Le montant total autorisé est capturé par défaut ; vous ne pouvez pas capturer un montant supérieur à cette valeur, mais vous pouvez capturer un montant inférieur.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount_to_capture=750

Facultatif Annuler l’autorisation

Si vous devez annuler une autorisation, vous pouvez annuler le PaymentIntent correspondant.

Par défaut, Stripe autorise uniquement les moyens de paiement synchrones sur PayPal. Vous recevez ainsi une notification immédiate vous informant de la réussite ou de l’échec de chaque paiement. Si vous autorisez les moyens de paiement asynchrones, vous pouvez recevoir des notifications différées pour certains paiements. Vous devrez alors utiliser des endpoints de webhook pour recevoir des notifications concernant la réussite ou l’échec de certains paiements.

Pour activer les paiements asynchrones sur PayPal, contactez le service Support de Stripe.

Il s’agit des codes d’erreur les plus courants lors d’une intégration avec PayPal. Si une requête à l’API PayPal a renvoyé l’erreur, elle inclut un code d’émission PayPal et l’ID de débogage associé à la requête. Vous pouvez utiliser cet ID de débogage lorsque vous contactez le service de support de PayPal pour obtenir de l’aide sur votre problème.

Pour simuler un paiement réussi sur votre intégration PayPal, utilisez vos clés API de test et accédez à la page de redirection. Cette page vous donne la possibilité d’Autoriser ou de Faire échouer l’authentification de l’utilisateur selon plusieurs scénarios test. Lorsque vous sélectionnez Autoriser le paiement test, le PaymentIntent passe de l’état requires_action à succeeded.

Pour tester un échec d’authentification de l’utilisateur, utilisez vos clés API de test et accédez à la page de redirection. Sur cette page, cliquez sur Faire échouer le paiement test. Votre PaymentIntent bascule alors de l’état requires_action à requires_payment_method.

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 de la section Scénarios test lorsque vous créez le PaymentIntent dans les informations de facturation. Par exemple, lors de la confirmation du PaymentIntent côté serveur, voilà à quoi ressemble une requête qui simule une transaction refusée par PayPal :

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=eur \
  -d "payment_method_types[]"=paypal \
  -d "payment_method_data[type]"=paypal \
  --data-urlencode "payment_method_data[billing_details][email]"="transaction_refused@example.com"

Scénarios de test