Payer via le solde StripeVersion bêta publique

En tant que plateforme Connect, vous pouvez créer un moyen de paiement lié au solde Stripe disponible d’un compte connecté. Cela vous permet de collecter les paiements d’abonnement directement à partir du solde disponible d’un compte connecté, plutôt que par le biais de moyens de paiement externes comme les cartes bancaires.

Intégrer les paiements via les soldes Stripe

Ce moyen de paiement n’est disponible que dans le cadre d’une version bêta avec Accounts V2.

Éligibilité

Les paiements sur solde Stripe sont soumis aux conditions suivantes :

• Vous pouvez uniquement configurer ce moyen de paiement pour les comptes connectés actifs contrôlés par votre plateforme et dont la fonctionnalité card_payments est active.
• Vous pouvez uniquement utiliser ce moyen de paiement pour débiter les paiements d’abonnement des comptes connectés auxquels votre plateforme fournit une fonctionnalité de paiement via Connect, et non pour d’autres biens ou services.
• Vous ne pouvez pas payer via le solde Stripe si vous utilisez les moyens de paiement dynamiques. Lors de la création d’un paiement d’abonnement, vous devez spécifier explicitement le paiement via le solde Stripe.

Approbation de vos comptes connectés requise

Vous devez obtenir l’approbation des comptes connectés avant de collecter des paiements à partir de leurs soldes Stripe. Nous vous recommandons d’utiliser le message suivant pour informer vos comptes connectés et leur offrir la possibilité de refuser le paiement par solde Stripe :

Calendrier et disponibilité des fonds

Les paiements effectués à partir d’un solde Stripe sont confirmés immédiatement. Les paiements sur solde Stripe des comptes connectés situés dans le même pays que votre plateforme sont disponibles sur votre solde Stripe avec un règlement le jour même (T+0). Les paiements internationaux provenant de comptes connectés situés dans un autre pays sont disponibles dans votre solde Stripe avec un règlement le jour suivant (T+1).

Paiements transfrontaliers

Vous pouvez créer des paiements par solde Stripe dans une devise autre que la devise par défaut de votre plateforme, à condition que le compte Stripe du compte connecté inclue cette devise. Stripe convertit automatiquement les fonds dans la devise par défaut du compte de votre plateforme.

Remboursements

Vous pouvez rembourser partiellement ou totalement tout paiement effectué via un solde Stripe, de la même manière que vous rembourseriez un paiement par carte.

Échecs de transaction

Pour effectuer un paiement à partir du solde Stripe d’un compte connecté, vous devez disposer de fonds suffisants dans la devise de présentation indiquée. Dans le cas contraire, le PaymentIntent échoue avec le code de refus insufficient_funds. Le paiement échoue même si le compte dispose de fonds suffisants dans une autre devise.

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.

Si un paiement effectué à partir d’un solde Stripe échoue en raison de fonds insuffisants, vous pouvez réessayer 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é.

Instead of retrying a failed payment from a Stripe balance, you can try using a different payment method by specifying it directly on the invoice. You can also implement a flow that allows connected accounts to update their own subscription payment methods.

Création de rapports et suivi des paiements

Les paiements effectués via le solde Stripe d’un compte connecté génèrent des données de transaction reflétant les informations du paiement sur la plateforme et sur le compte connecté.

Sur la plateforme, le paiement crée un objet Charge et un BalanceTransaction avec des montants positifs. Les valeurs de BalanceTransaction sont les suivantes :

• reporting_category : charge
• source : ID de l’objet Charge
• type : payment

Sur le compte connecté, le paiement ne crée qu’une BalanceTransaction, avec un montant négatif et les valeurs suivantes :

• description : paiement du solde Stripe - + description du PaymentIntent
• reporting_category : stripe_balance_payment_debit
• source : null
• type :
  • Pour les paiements : stripe_balance_payment_debit
  • Pour les remboursements : stripe_balance_payment_debit_reversal