Ajoute des paramètres de solde de compte et de virement via l’API Balance Settings.
Nouveautés
Vous pouvez désormais personnaliser la façon dont le solde et le virement d’un compte connecté sont gérés par votre plateforme grâce à l’API Balance Settings. Ces options sont incluses :
- payments.debit_negative_balances : détermine si Stripe doit tenter de récupérer les soldes négatifs d’un compte bancaire associé.
- payments.payouts.minimum_balance_by_currency : définit le solde minimum à conserver par devise après les virements automatiques — seuls les fonds dépassant ce seuil sont versés.
- payments.payouts.schedule : définit la planification, y compris la fréquence des virements et les jours du mois ou de la semaine.
- payments.payouts.statement_descriptor : spécifie le texte qui apparaît sur l’extrait de compte bancaire pour les virements.
- payments.règlement_timing : définit le délai de règlement pour que les fonds en attente soient disponibles.
Si vous utilisiez l’API Balance Settings sur des versions bêta antérieures à 2025-09-30., vous remarquerez les changements suivants :
Ajoute la possibilité de définir les paramètres du solde delay_days par défaut en affichant une valeur vide
delay_. La valeur par défaut est la plus basse disponible pour votre compte.days_ override Le champ delay_days_override ajouté à l’objet Balance Settings, que vous pouvez définir lorsque vous mettez à jour les paramètres de solde.
Impact
Toutes les plateformes Stripe peuvent désormais utiliser l’API Balance Settings pour personnaliser les soldes des comptes, configurer les soldes minimums pour les virements automatiques, et gérer les paramètres de virement.
Nous recommandons d’utiliser l’API Balance Settings pour Accounts v1 et Accounts v2 plutôt que l’ancien hachage settings.payouts dans l’API Accounts v1. Toutefois, si vous êtes une plateforme sur Accounts v1 et que vous utilisez actuellement settings., vous n’avez pas besoin de migrer. Si vous êtes une plateforme sur Accounts v2, consultez la rubrique Créer une plateforme SaaS, pour en savoir plus.