Paiements Boleto

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

Suivez ce guide pour savoir comment activer Boleto et découvrir les différences entre l’acceptation d’un paiement par carte et l’utilisation de Boleto.

Activer Boleto comme moyen de paiement

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

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

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'boleto'],
  # The parameter is optional. The default value of expires_after_days is 3.
  payment_method_options: {
    boleto: {
      expires_after_days: 7
    }
  },
  line_items: [{
    price_data: {
      # To accept `boleto`, all line items must have currency: brl
      currency: 'brl',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Options supplémentaires du moyen de paiement

Vous pouvez définir le paramètre facultatif expires_after_days dans les options du moyen de paiement de votre Session. Celui-ci permet de paramétrer le nombre de jours calendaires au bout duquel votre bon Boleto expirera. Par exemple, si vous créez un bon Boleto le lundi et que vous définissez expires_after_days sur 2, le bon Boleto expirera le mercredi à 23 h 59, heure de Sao Paulo (America/Sao_Paulo : UTC-3). Si vous le définissez sur 0, le bon Boleto expire à la fin de la journée. Le paramètre expires_after_days accepte une durée comprise entre 0 et 60 jours. La valeur par défaut est de 3 jours. Vous pouvez personnaliser le nombre de jours de validité par défaut dans les paramètres des moyens de paiement de votre compte

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.