Accepter un paiement EPS

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.

L’élément EPS Bank indique la banque sélectionnée par le client, même si celle-ci a changé. Si vous souhaitez effectuer une logique supplémentaire à partir de la valeur Bank (par exemple, en rendant ce champ obligatoire pour la validation du formulaire), vous pouvez surveiller l’événement Change :

epsBank.on('change', (event) => {
  const bank = event.value;
  // Perform any additional logic here...
});

L’événement indiquant un changement contient d’autres paramètres qui peuvent vous aider à enrichir votre expérience utilisateur. Pour en savoir plus, consultez la documentation de Stripe.js.

Nous recommandons l’utilisation de Stripe.js pour gérer les redirections et paiements EPS avec confirmEpsPayment. Toutefois, vous pouvez également rediriger vos clients manuellement :

1. En fournissant l’URL vers laquelle vos clients sont redirigés une fois leur paiement effectué.
2. En indiquant la banque du client (facultatif), vers laquelle il sera redirigé pour autoriser son paiement. Vous trouverez la liste des banques disponibles dans la section Valeurs des banques.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/confirm \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "return_url"="https://example.com/checkout/complete" \
  -d "payment_method_data[type]"="eps" \
  -d "payment_method_data[eps][bank]"="bank_austria"

1. En vérifiant que l’état du PaymentIntent est bien requires_action et que le type de next_action est redirect_to_url.

{
  "next_action": {
    "type": "redirect_to_url",
    "redirect_to_url": {
      "url": "https://hooks.stripe.com/...",
      "return_url": "https://example.com/checkout/complete"
    }
  },
  "charges": {
    "data": [
      {
        "payment_method_details": {
          "eps": {
          "bank": "bank_austria",
          "verified_name": "JENNY ROSEN"

1. En redirigeant le client vers l’URL indiquée dans la propriété next_action.

const action = intent.next_action;
if (action && action.type === 'redirect_to_url') {
  window.location = action.redirect_to_url.url;
}

À l’issue du processus de paiement, le client est redirigé vers la destination return_url. Les paramètres de requête d’URL payment_intent et payment_intent_client_secret sont inclus et vous pouvez par ailleurs transmettre vos propres paramètres de requête, comme indiqué plus haut.

Vous ne pouvez pas réutiliser les PaymentMethods EPS ni les enregistrer pour les clients. Vous devez créer un nouveau PaymentMethod EPS chaque fois que votre client sélectionnera ce moyen de paiement dans votre formulaire de paiement, en utilisant l’Element EPS Bank. Pour garder une trace de la préférence bancaire de votre client, nous vous recommandons de la conserver dans votre propre base de données ou d’utiliser la propriété metadata de l’objet Customer.

Lorsque vous créez l’élément EPS Bank, vous pouvez le préremplir avec la banque choisie par le client :

const options = {
  // Include the bank name along with any custom styling
  value: "bank_austria",
  style: {
    base: {
      padding: '10px 12px',
      color: '#32325d',
      fontSize: '16px',
      '::placeholder': {
        color: '#aab7c4'
      },
    },
  },
}

// Create an instance of the Element
const epsBank = elements.create('epsBank', options);

// Mount the Element
epsBank.mount('#eps-bank-element');
TODO: highlight: [3]