Paiements Boleto
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 (par exemple, pour accepter des paiements en mode abonnement). Sinon, migrez vers le Dashboard.
Boleto est un moyen de paiement à usage unique où les clients doivent prendre des mesures supplémentaires pour effectuer leur paiement. Les clients règlent en utilisant un bon Boleto avec un numéro généré soit dans les distributeurs automatiques de billets, les banques, les portails bancaires ou les agences autorisées.
Déterminer la compatibilité
Pour prendre en charge les paiements Boleto, une session Checkout doit remplir toutes les conditions suivantes :
- Pour tous les postes de facture, les tarifs doivent être exprimés dans la même devise. Si vous avez des postes dans différentes devises, créez des sessions Checkout distinctes pour chaque devise.
- 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
Note
Avant d’utiliser ce guide, commencez par créer une intégration permettant d’accepter un paiement avec Checkout.
Use this guide to learn how to enable Boleto—it shows the differences between accepting a card payment and using Boleto.
Activer Boleto comme moyen de paiement
Lorsque vous créez une session Checkout, vous devez :
- Ajouter
boleto
à la liste des moyens de paiements,payment_method_types
. - Veillez à ce que tous vos postes
line_items
utilisent la devisebrl
.
Options supplémentaires du moyen de paiement
You can specify an optional expires_after_days
parameter in the payment method options for your Session
that sets the number of calendar days before a Boleto voucher expires. For example, if you create a Boleto voucher on Monday and you set expires_after_days
to 2, the Boleto voucher expires on Wednesday at 23:59 America/Sao_Paulo (UTC-3) time. If you set it to 0, the Boleto voucher expires at the end of the day. The expires_after_days
parameter can be set from 0 to 60 days. The default is 3 days. You can customize the default expiration days on your account in the Payment methods settings
Rediriger vers la page du coupon hébergée par Stripe
Note
Contrairement aux paiements par carte bancaire, le client ne sera pas redirigé vers le lien success_url lors d’un paiement avec Boleto.
Après avoir soumis le formulaire Checkout avec succès, le client est redirigé vers le hosted_voucher_url
. Le client peut copier le numéro du Boleto ou télécharger le PDF du coupon à partir de la page hébergée.
Stripe envoie un événement payment_intent.requires_action lors de la création d’un coupon Boleto. Si vous souhaitez envoyer à vos clients un e-mail contenant un lien vers les instructions de paiement du coupon, vous pouvez placer l’URL hosted_voucher_url
dans payment_intent.next_action.boleto_display_details. En savoir plus sur le suivi d’un PaymentIntent avec des webhooks.
Stripe vous permet de personnaliser les interfaces utilisateur sur la page Paramètres de marque. Vous pouvez appliquer les paramètres de marque suivants au coupon :
- Icône : l’image représentant votre marque et votre dénomination sociale publique
- Couleur d’accentuation : utilisée comme couleur du bouton Copier le numéro
- Couleur de marque : utilisée comme couleur d’arrière-plan
Traiter vos commandes
Boleto é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énement | Description | Étapes suivantes |
---|---|---|
Le client a soumis le formulaire Checkout avec succès. Stripe a généré le coupon Boleto. Vous pouvez choisir d’envoyer le | Attendez que le client s’acquitte du paiement du coupon Boleto. | |
checkout.session.async_payment_succeeded | Le client s’est acquitté du paiement Boleto. Le PaymentIntent bascule sur succeeded . | Traitez la commande de biens ou de services du client. |
checkout.session.async_payment_failed | Le coupon Boleto a expiré, ou le paiement a échoué pour un autre motif. Le PaymentIntent revient à l’état requires_payment_method . | Contactez votre 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 Boleto, puis cliquez sur le bouton Payer.
Description | |
---|---|
| Simule un coupon Boleto réglé par le client au bout de 3 minutes et pour lequel le webhook Exemple : fulaninho@example.com |
| Simule un coupon Boleto immédiatement réglé par le client et pour lequel le webhook Exemple : succeed_immediately@example.com |
| Simule un coupon Boleto qui expire avant le règlement du client et pour lequel le webhook Le champ Exemple : expire_immediately@example.com |
| Simule un coupon Boleto qui expire avant le règlement du client et pour lequel le webhook Le champ Exemple : expire_with_delay@example.com |
| Simule un paiement Boleto qui ne réussit jamais. Il expire conformément à la valeur du champ Exemple : fill_never@example.com |
Numéro fiscal | Description |
---|---|
CPF CNPJ | En mode test, définissez |
Gérez les remboursements
Les paiements Boleto ne peuvent pas être remboursés. Certains marchands ont créé un processus distinct pour créditer les clients qui s’adressent à eux pour un remboursement.
Gérez les litiges
Le client ne peut pas contester un paiement Boleto.