Payer via le solde StripeVersion bêta publique

Les plateformes Connect peuvent créer un moyen de paiement lié au solde Stripe disponible d’un compte connecté. Cela permet à une plateforme 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 tels que les cartes.

É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 sur lesquels votre plateforme fournit des paiements intégrés, 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.

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

Approbation de vos comptes connectés requise

Vous devez obtenir toutes les autorisations et approbations nécessaires de vos comptes connectés avant de prélever des paiements sur 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 via leur solde Stripe :

Remboursements

Vous pouvez rembourser partiellement ou totalement tout paiement via le solde Stripe réussi. Le processus de remboursement est identique à celui des paiements 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.

Avoid balance payment failures

Because payments from a connected account’s Stripe balance rely on its available funds, you can avoid payment failures by taking steps to maximize your connected accounts’ balances.

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

Coordinate your payout schedules with your subscription billing cycles. For example, if you charge subscription fees on the first day of each month, and schedule weekly payouts on Mondays, then months with more Mondays have more payouts. Those months have lower available balances than months with fewer payouts, making payment failures more likely.

Pour éviter les échecs de paiement dus aux virements, vous pouvez également passer aux virements manuels avant le paiement d’un abonnement. Avant chaque paiement d’abonnement, si les fonds sur le solde d’un compte connecté donné sont suffisants, basculez-le vers les virements manuels. Une fois le paiement effectué, repassez aux virements automatiques. Cela empêche le virement automatique au titre du paiement de l’abonnement.

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

Handle balance payment failures

Set up webhooks and event destinations to receive notifications about subscription payments. Identify payment failures by listening for the invoice.payment_failed event. When a payment fails:

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

If a payment from a Stripe balance fails due to insufficient available funds, you can retry it by following these steps:

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.

Supported currencies by country

Stripe doesn’t support all currencies in every jurisdiction. When you collect a payment from a connected account’s Stripe balance, that account’s country determines which currencies are available. The following table shows the supported currencies for Stripe balance payments from accounts in each country.

Below is the full table of supported currencies for paying from a Stripe balance, based on the connected account’s country.

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