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
Scénarios de paiement
Au-delà des paiements

Accepter un paiement Multibanco

Découvrez comment accepter le moyen de paiement Multibanco.

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.

Multibanco est un moyen de paiement basé sur des bons. Il est répandu au Portugal. Si votre entreprise est établie en Europe ou aux États-Unis, vous pouvez accepter les paiements Multibanco de vos clients au Portugal à l’aide de Stripe Checkout.

Pour effectuer une transaction, le client reçoit un bon sur lequel figurent les numéros d’entité et de référence Multibanco. Il utilise ces informations pour effectuer un paiement en dehors de votre tunnel de paiement, via son espace bancaire en ligne ou à un distributeur automatique de billets.

La confirmation du paiement peut être retardée de plusieurs jours en raison de l’initiation d’un virement bancaire lorsqu’un client règle un bon Multibanco. Les virements bancaires peuvent subir des retards, en particulier le week-end, ce qui contribue à retarder la confirmation du paiement.

Déterminer la compatibilité

Une session Checkout doit remplir toutes les conditions suivantes pour prendre en charge Multibanco :

  • Pour tous les postes de facture, les tarifs doivent être exprimés dans la même devise (EUR).
  • Vous ne pouvez utiliser que des postes ponctuels (les postes récurrents dans le cadre de plans d’abonnement ne sont pas pris en charge).

Accepter un paiement

Remarque

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

Cela vous guide tout au long de l’activation de Multibanco et vous montre les différences entre l’acceptation de paiements à l’aide de moyens de paiement dynamiques et la configuration manuelle des moyens de paiement.

Activer le moyen de paiement Multibanco

Lors de la création d’une nouvelle session Checkout, vous devez :

  1. Ajoutez multibanco à la liste payment_method_types.
  2. Assurez-vous que tous vos line_items utilisent la devise eur.
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]"=eur \
  -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]"=multibanco \
  --data-urlencode success_url="https://example.com/success"

Redirection vers la page des coupons hébergée par Stripe

Remarque

Contrairement aux paiements par carte bancaire, le client ne sera pas redirigé vers le success_url avec un paiement Multibanco.

Après avoir envoyé le formulaire Checkout, le client est redirigé vers l’hosted_voucher_url. Le client peut se référer aux instructions de paiement de la page hébergée pour savoir comment effectuer son paiement. Vous pouvez afficher la page sur les plateformes de bureau et mobiles, et elle est également imprimable.

Stripe envoie un événement payment_intent.requires_action lors de la création d’un bon Multibanco. Si vous avez besoin d’envoyer un e-mail avec le lien vers les instructions de paiement du bon, localisez le PaymentIntent dans data.object sur l’événement requires_action, puis extrayez hosted_voucher_url dans next_action.multibanco_display_details.hosted_voucher_url sur le PaymentIntent.

Traiter vos commandes

Multibanco étant un moyen de paiement à notification différée, vous devez utiliser une méthode telle que des webhooks pour suivre l’état des paiements et gérer le traitement des commandes. En savoir plus sur la configuration des webhooks et le traitement des commandes.

Les événements suivants sont envoyés lorsque l’état du paiement change :

Nom de l’événementDescriptionProchaines étapes
checkout.session.completedLe client a bien envoyé le formulaire Checkout. Stripe a généré un bon Multibanco.Attendez que le client règle le bon Multibanco.
checkout.session.async_payment_succeededLe client s’est acquitté du paiement du coupon Multibanco. Le PaymentIntent passe à l’état succeeded.Traitez la commande de biens ou de services du client.
checkout.session.async_payment_failedLe bon Multibanco a expiré, ou le paiement a échoué pour un autre motif. Le PaymentIntent revient à l’état requires_payment_method.Contactez le client par e-mail et demandez-lui de passer une nouvelle commande.

FacultatifEnvoyer des instructions de paiement automatisées par e-mail

Vous pouvez activer l’envoi d’instructions sur les paiements Multibanco par e-mail sur la page Paramètres des e-mails dans le Dashboard. Une fois activé, Stripe envoie automatiquement des instructions de paiement par e-mail dès la confirmation du PaymentIntent. Les e-mails contiennent les instructions pour l’achat d’un bon Multibanco et un lien vers la page des coupons hébergée par Stripe.

Remarque

Dans les environnements de test, seules les adresses e-mail associées au compte Stripe reçoivent des instructions par e-mail.

FacultatifPersonnaliser l’apparence du coupon

Personnalisez les interfaces utilisateur dans la page Adaptation à votre marque.

Vous pouvez appliquer les paramètres de marque suivants à la page des coupons hébergée par Stripe :

  • Icône : l’image représentant votre marque et votre dénomination sociale publique
  • Logo : l’image de votre marque
  • Couleur d’accentuation : utilisée comme couleur du bouton d’impression
  • Couleur de marque : utilisée comme couleur d’arrière-plan

Tester votre intégration

Lors du test de votre intégration Checkout, sélectionnez le moyen de paiement Multibanco, puis cliquez sur Payer. Renseignez les modèles d’e-mails suivants dans le formulaire Checkout pour tester différents scénarios.

E-mailDescription

{any_prefix}@{any_domain}

Simule un bon Multibanco payé par un client. Le webhook payment_intent.succeeded arrive après environ 3 minutes.

Exemple : julie@exemple.com

{any_prefix}succeed_immediately@{any_domain}

Simule un bon Multibanco qu’un client paie immédiatement. Le webhook payment_intent.succeeded arrive en quelques secondes.

Exemple : succeed_immediately@exemple.com

{any_prefix}expire_immediately@{any_domain}

Simule un bon Multibanco qui expire immédiatement. Le webhook payment_intent.payment_failed arrive en quelques secondes.

Exemple : expire_immediately@exemple.com

{any_prefix}expire_with_delay@{any_domain}

Simule un bon Multibanco qui expire avant le règlement du client. Le webhook payment_intent.payment_failed arrive après environ 3 minutes.

Exemple : expire_with_delay@exemple.com

{any_prefix}fill_never@{any_domain}

Simule un bon Multibanco qui n’aboutit jamais. Le webhook payment_intent.payment_failed arrive au bout de 11 jours, ce qui simule le comportement en mode production. En savoir plus sur l’expiration des bons Multibanco.

Exemple : fill_never@example.com

Date d’expiration

Les bons Multibanco expirent à la date UNIX expires_at indiquée dans next_action.multibanco_display_details.expires_at, soit 7 jours après la création du bon. Les clients ne peuvent pas payer un bon Multibanco après son expiration. Après expiration, l’état du PaymentIntent passe de requires_action à processing et Stripe envoie un événement payment_intent.processing.

Le PaymentIntent demeure à l’état processing pendant une période de 4 jours pour tenir compte des éventuels retards de notification de paiement réussi causés par les retards de virement bancaire. Si le paiement Multibanco n’est pas finalisé au cours de cette période, l’état du PaymentIntent passe à requires_payment_method et Stripe envoie un événement payment_intent.payment_failed. Si vous recevez les fonds du client après cette période, Stripe lance automatiquement un processus de remboursement pour le montant indûment versé.

Annulation

Vous pouvez annuler les bons Multibanco en annulant un PaymentIntent. Après l’annulation, Stripe envoie un événement payment_intent.canceled.

Si les fonds d’un client sont versés alors que le bon Multibanco est annulé, Stripe lance automatiquement le processus de remboursement du montant indûment versé.

Remarque

L’annulation d’un paiement en attente entraîne l’invalidation des instructions initiales du bon. Lorsque vous annulez un paiement Multibanco en attente, informez-en votre client.

Lorsque vous reconfirmez avec succès un PaymentIntent à l’état requires_action, Stripe crée de nouvelles instructions pour le coupon et un nouveau hosted_voucher_url. Vous devez les fournir à votre client.

Remboursements

En savoir plus sur les remboursements Multibanco.

Voir aussi