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
Paiements en ligne
PrésentationTrouver votre cas d'usageManaged Payments
Moyens de paiement
Interfaces de paiement
Scénarios de paiement
Paiements par TPE
Au-delà des paiements

Accepter un paiement Multibanco

Découvrez comment accepter le moyen de paiement Multibanco.

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.

Si vous souhaitez continuer à configurer manuellement les moyens de paiement proposés à vos clients avec Checkout, utilisez ce guide. Sinon, migrez vers le Dashboard.

Multibanco est un moyen de paiement à l’aide de coupons 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 l’API Payment Intents.

Pour effectuer une transaction, les clients reçoivent un bon sur lequel figurent les numéros d’entité et de référence Multibanco. Les clients utilisent ces informations de coupon pour effectuer un paiement en dehors de votre tunnel de paiement, via leur espace bancaire en ligne ou au 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.

Activez Multibanco en effectuant les modifications suivantes dans votre intégration de paiement par carte bancaire.

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.
Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'multibanco'],
  line_items: [{
    price_data: {
      currency: 'usd',
      # To accept `multibanco`, all line items must have currency: eur
      currency: 'eur',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

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.

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

Cette page vous a-t-elle été utile ?
OuiNon