Paiements Boleto

Une Checkout Session doit remplir la condition suivante pour prendre en charge les paiements Boleto :

• 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.

Cela vous guide tout au long de l’activation de Boleto 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 Boleto comme moyen de paiement

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

1. Ajouter boleto à la liste des payment_method_types.
2. Veillez à ce que tous vos postes line_items utilisent la devise brl.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=brl \
  -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]"=boleto \
  --data-urlencode success_url="https://example.com/success"

Options supplémentaires du moyen de paiement

Vous pouvez spécifier une option expires_after_days dans les options du moyen de paiement pour votre Session qui définit le nombre de jours calendaires avant l’expiration d’un bon Boleto. Par exemple, si vous créez un bon d’achat Boleto le lundi et que vous définissez expires_after_days à 2, le bon Boleto expirera mercredi à 23 h 59, heure de Sao Paulo (America/Sao_Paulo : UTC-3). Si vous le réglez sur 0, le bon Boleto expirera à la fin de la journée. Le paramètre expires_after_days peut être défini de 0 à 60 jours. La valeur par défaut est de 3 jours. Vous pouvez personnaliser le délai par défaut avant expiration sur votre compte dans les paramètres du moyen de paiement.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=brl \
  -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_options[boleto][expires_after_days]"=7 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=boleto \
  --data-urlencode success_url="https://example.com/success"

Rediriger vers la page du coupon hébergée par Stripe

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 bon Boleto. Si vous souhaitez envoyer à vos clients un e-mail contenant un lien vers le bon, localisez l’adresse 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 : 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 :

Lors du test de votre intégration Checkout, sélectionnez le moyen de paiement Boleto, puis cliquez sur le bouton Payer.

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.

Le client ne peut pas contester un paiement Boleto.