Facturer des frais SaaS à vos comptes connectésVersion bêta publique

Créez un produit et un tarif représentant vos frais d’abonnement. Vous pouvez utiliser l’API ou le Dashboard.

Vous pouvez prélever les frais d’abonnement SaaS directement depuis le solde Stripe d’un compte connecté. Le compte connecté doit répondre aux exigences suivantes :

• Il doit disposer à la fois des configurations merchant et customer.
• La fonctionnalité card_payments de sa configurationmerchant doit être active.
• Son solde disponible doit disposer de fonds suffisants pour effectuer le paiement complet.

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-04-30.preview" \
  -d "payment_method_types[]"=stripe_balance \
  -d confirm=true \
  -d customer_account=acct_xxxxxxxxxxxxxx \
  -d usage=off_session \
  -d "payment_method_data[type]"=stripe_balance

{
  "id": "seti_123",
  "object": "setup_intent",
  "customer": "cus_xxxxxxxxxxxxxx",
  "customer_account": "acct_xxxxxxxxxxxxxx",
  "payment_method": "pm_xxxxxxxxxxxxxx",
  "status": "succeeded"
}

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -H "Stripe-Version: 2025-04-30.preview" \
  -d customer_account=acct_xxxxxxxxxxxxxx \
  -d default_payment_method=pm_xxxxxxxxxxxxxx \
  -d "items[0][price]"=price_xxxxxxxxxxxxxx \
  -d "items[0][quantity]"=1 \
  -d "payment_settings[payment_method_types][0]"=stripe_balance

Lorsque vous encaissez un paiement à partir du solde Stripe d’un compte connecté, le solde disponible du compte doit disposer de fonds suffisants pour effectuer le paiement complet. Dans le cas contraire, le paiement échoue. Si vous prévoyez d’encaisser des paiements directement à partir du solde Stripe de vos comptes connectés, nous vous recommandons de configurer votre intégration pour gérer les échecs de paiement liés au solde.

Éviter les échecs de paiement à partir du solde

Étant donné que les paiements provenant du solde Stripe d’un compte connecté dépendent de ses fonds disponibles, vous pouvez éviter les échecs de paiement en prenant des mesures pour optimiser les soldes de vos comptes connectés.

Personnaliser la fréquence de virement des comptes connectés

Coordonnez vos fréquences de virement avec vos cycles de facturation d’abonnement. Par exemple, si vous facturez vos frais d’abonnement le premier jour du mois et que vous programmez des virements hebdomadaires le lundi, davantage de virements seront effectués les mois avec davantage de lundis. Ces mois afficheront des soldes disponibles plus faibles que ceux avec moins de virements, ce qui augmentera la probabilité d’échecs de paiement.

Pour éviter les échecs de paiement liés aux virements, vous pouvez également passer aux virements manuels avant le paiement d’un abonnement. Avant chaque paiement d’abonnement, si les fonds disponibles d’un compte connecté sont suffisants, passez aux virements manuels afin que le paiement de l’abonnement soit réglé avant que le virement automatique n’effectue la compensation du compte. Une fois l’abonnement payé, réactivez les virements automatiques.

Définir un solde minimum sur les comptes connectés

Vous pouvez empêcher les virements automatiques de faire baisser le solde disponible d’un compte connecté en dessous d’un certain montant en définissant un solde minimum pour ce compte.

1. Recherchez le compte dans votre Dashboard.
2. Dans le menu déroulant du compte (), sélectionnez Afficher le Dashboard comme….
3. Cliquez sur l’icône d’engrenage et sélectionnez Paramètres.
4. Sous Paramètres du compte, cliquez sur Entreprise.
5. Sélectionnez l’onglet Comptes de virement externes et fréquence des virements.
6. Activez l’option Conserver un montant minimum dans votre solde de paiements et saisissez un montant.

Vous devez définir manuellement le solde minimum pour chaque compte connecté.

Gérer les échecs de paiement à partir du solde

Configurez des webhooks et des destinations d’événement pour recevoir des notifications sur les paiements d’abonnement. Identifiez les échecs de paiement en écoutant l’événement invoice.payment_failed. En cas d’échec d’un paiement :

• L’état du PaymentIntent passe à requires_action.
• L’abonnement reste à l’état incomplete pour la facture en cours.
• L’abonnement continue de générer des factures, qui restent à l’état draft.

Relances automatiques

Activer les nouvelles tentatives pour les paiements de solde échoués en raison de fonds disponibles insuffisants sur les factures d’abonnement récurrentes. Les nouvelles tentatives automatiques programment 2 tentatives de paiement suite à un échec pour fonds insuffisants :

• La première nouvelle tentative a lieu au moins 24 heures après l’échec du paiement.
• Si nécessaire, la deuxième nouvelle tentative a lieu le dimanche suivant la première.

Ce calendrier de nouvelles tentatives vise à donner à votre compte connecté le temps d’accumuler plus de fonds sur son solde Stripe et à éviter les conflits avec les virements programmés.

Vous pouvez activer les nouvelles tentatives pour n’importe quel montant, sans frais supplémentaires.

Nouvelle tentative manuelle

Si un paiement à partir d’un solde Stripe échoue en raison de fonds disponibles insuffisants, vous pouvez le relancer manuellement en suivant ces étapes :

1. Définissez la fréquence des virements du compte connecté sur manual.
2. Écoutez le prochain paiement qui sera effectué sur le compte connecté, puis vérifiez le solde disponible du compte.
3. Si le solde disponible est supérieur ou égal aux frais d’abonnement, définissez le moyen de paiement de la facture impayée sur stripe_balance et réessayez. Sinon, continuez à écouter les paiements jusqu’à ce que le solde disponible soit suffisant pour payer la facture.
4. Si le paiement réussit, rétablissez la fréquence de virement normale du compte connecté.

Plutôt que de relancer un paiement ayant échoué à partir d’un solde Stripe, vous pouvez essayer d’utiliser un autre moyen de paiement en l’indiquant directement sur la facture. Vous pouvez également mettre en place un flux qui permet aux comptes connectés de mettre à jour les moyens de paiement qu’ils utilisent dans le cadre de leur abonnement.