Migrer vers une configuration Connect prise en charge

Découvrez comment migrer votre intégration Connect vers une configuration prise en charge.

Lorsque vous créez des frais indirects (frais de destination ou frais et transferts séparés), les éléments suivants sont toujours vrais, quels que soient les paramètres de votre compte connecté :

Votre plateforme est responsable des soldes négatifs.
Vos comptes connectés ne peuvent pas gérer les remboursements ou les litiges.
Stripe perçoit ses honoraires directement sur la plateforme.
Si vous utilisez également des frais directs, leur comportement est toujours contrôlé par les paramètres de votre compte connecté. Cela peut vous obliger à maintenir deux flux de monétisation différents.

Si vous utilisez des frais indirects, Stripe vous recommande d’attribuer la responsabilité des frais Stripe et des soldes négatifs à votre plateforme. Sinon, le comportement réel peut entrer en conflit avec vos paramètres. Cette recommandation s’applique que vous utilisiez ou non le paramètre on_behalf_of.

Si votre intégration actuelle ne respecte pas cette recommandation, nous vous recommandons de:

Modifiez vos paiements en frais directs, ce qui fait de vos comptes connectés le marchand officiel et leur permet de gérer leurs propres remboursements et litiges.
Changez de responsabilité pour les soldes négatifs et le paiement des frais Stripe sur votre plateforme. Dans ce cas, vos comptes connectés ne peuvent plus utiliser le Dashboard Stripe complet.

Changer le type débité en charges directes

Modifiez votre débité en débit direct si:

Votre intégration Connect utilise actuellement des frais indirects (frais de destination ou frais et transferts séparés)
Vous souhaitez continuer à utiliser la même configuration de compte connecté où :
- Stripe détient un passif à solde négatif
- Vos comptes connectés paient des frais de traitement des paiements

La modification de votre type débité affecte plusieurs aspects de votre flux de travail, notamment la disponibilité des données, la déclaration des revenus et la manière dont vous gérez les remboursements et rétrofacturations.

Modifications apportées à l’API

Ces exemples montrent les différentes approches pour créer une PaymentIntent lorsque vous utilisez des frais directs au lieu de frais indirects.

Avant

Après

Pour les frais de destination, passez l’ID du compte connecté en utilisant transfer_data[destination].

Pour les frais directs, passez l’identifiant du compte connecté à l’aide de l’en-tête du compte stripe.

Webhooks

Frais indirects	Paiements directs
Ces types débités sont associés à la plateforme, et vous pouvez écouter les événements liés aux débités depuis votre compte de plateforme. En outre, pensez à écouter les événements de paiement et de transfert, qui peuvent affecter vos comptes connectés.	Des débités directs sont associés au compte connecté, et vous pouvez écouter les événements liés aux débits depuis les comptes connectés.

Disponibilité et migration des données

Frais indirects	Paiements directs
Stripe enregistre toutes les informations relatives aux clients, aux transactions et aux méthodes de paiement au niveau de la plateforme. Votre plateforme ne peut pas accéder immédiatement aux informations enregistrées à partir des comptes connectés, ou l’inverse.	Stripe enregistre toutes les informations relatives aux clients, aux transactions et aux modes de paiement au niveau du compte connecté.

Migrer les moyens de paiement de la plateforme vers les comptes connectés

Utilisez l’API Modes de paiement pour cloner les Modes de paiement pertinents enregistrés sur votre compte de plateforme à chaque compte connecté souhaité. Découvrez comment partager les modes de paiement sur plusieurs comptes pour les frais directs.

Marchand officiel

Étant donné que le type débité que vous utilisez détermine le commerçant officiel, assurez-vous que le type débité que vous utilisez correspond à votre modèle économique. Désignez correctement le commerçant officiel pour éviter des amendes à votre plateforme.

Frais indirects	Paiements directs
La plateforme est le marchand d’enregistrement par défaut. Vous pouvez définir le compte connecté comme marchand d’enregistrement à l’aide du paramètre on_behalf_of.	Le compte connecté doit être le marchand d’enregistrement.

Rapports sur les revenus

Frais indirects	Paiements directs
Vous voyez une vue unifiée des revenus dans votre Dashboard, qui comprend tous les montants des transactions, les frais et les remboursements.	Les revenus sont enregistrés directement sur le compte connecté, et vous n’avez pas une vue directe sur les revenus ou les frais de traitement générés par ces frais.

Remboursements et contestations de paiement

Frais indirects	Paiements directs
Vous êtes responsable des remboursements et des rétrofacturations.	Le compte connecté gère directement les remboursements et les rétrofacturations. Vous surveillez les performances de chaque compte connecté séparément.

Modifier la configuration de votre compte connecté

Modifiez la configuration de votre compte connecté si:

Votre intégration Connect utilise des débits indirects (frais de destination ou frais et transferts séparés) et vous souhaitez continuer à utiliser ce type débité
Stripe détient un passif à solde négatif
Vos comptes connectés paient des frais de traitement des paiements

Au lieu du Stripe Dashboard standard, migrez vers un Dashboard intégré ou express.

Stripe ne prend pas en charge la modification directe du type d’un compte connecté existant, mais vous devez créer de nouveaux comptes connectés avec la configuration de compte souhaitée et réintégrer vos utilisateurs.

Conditions préalables

Utiliser les propriétés du contrôleur : Si vous utilisez des types de compte (Standard, Express ou Custom), nous vous recommandons de migrer vos comptes vers des propriétés du contrôleur au lieu d’utiliser des types de compte.
Mises à jour légales ou CGU potentielles : confirmez auprès de votre équipe juridique que vous pouvez mettre à jour les conditions d’utilisation de votre plateforme en ayant la possibilité de gérer et de contrôler les comptes connectés. Il se peut que vous ayez déjà des dispositions énoncées dans vos conditions d’utilisation. Les conditions d’utilisation de Stripe tiennent compte des changements dans la gestion et le contrôle du compte connecté par les plateformes Connect. Selon la configuration du compte connecté, vous devrez peut-être également inclure le contrat de compte connecté Stripe dans les conditions d’utilisation de votre plateforme.
Communiquez avec les comptes connectés au sujet de la migration : préparez-vous à envoyer un message à vos utilisateurs au sujet des mises à jour de leur migration. Incluez les informations suivantes dans votre message :
- Toute mise à jour des conditions d’utilisation
- Raisons pour lesquelles l’utilisateur s’inscrit à un nouveau compte
- Toute mise à jour ou modification de l’expérience utilisateur
- Comment l’utilisateur peut contacter votre équipe de support avec des questions
Préparez vos équipes d’assistance et d’opérations : Nous vous recommandons de documenter tous les changements que les utilisateurs pourraient subir sur leurs nouveaux comptes, ainsi que tout changement de tarification, de gestion des risques et de gestion des comptes. Préparez une feuille de réponses que votre équipe d’assistance pourra utiliser pour aider les utilisateurs qui ont des questions. Si vos utilisateurs ont toujours accès au support Stripe après la migration, coordonnez-vous avec l’équipe de votre compte Stripe pour créer un support pour gérer les exceptions et créer une bibliothèque de FAQ.
Assurez la parité des fonctionnalités pour les comptes standards qui migrent vers Express ou Custom : si vous avez des comptes standards qui utilisent régulièrement leur Stripe Dashboard, informez-les qu’ils ne pourront pas accéder à leur Dashboard et qu’ils ont toujours accès à toutes les fonctionnalités qu’ils s’attendent à conserver via un Dashboard Express ou l’interface utilisateur de votre plateforme à l’aide de composants intégrés.

Créer des comptes connectés

Créez un nouveau compte connecté avec la nouvelle configuration du compte Connect. Lors de la création du compte, écrivez l’identifiant de compte précédent sur l’objet de métadonnées Accounts v1 et stockez-le pour vos propres enregistrements. Cela associe l’identifiant de compte existant d’un utilisateur au nouvel identifiant de compte connecté. Cette correspondance copie les clients et les méthodes de paiement corrects sur les nouveaux comptes, et suit les anciens et les nouveaux comptes.
(Facultatif) Utilisez l’intégration en réseau pour vos comptes connectés, ce qui permet aux propriétaires de comptes connectés de réutiliser certaines informations, telles que le nom de leur société légale ou leurs détails commerciaux. Vous pouvez également préremplir les informations de compte de l’ancien compte pour accélérer le processus pour les comptes connectés. L’intégration hébergée ou intégrée saute les champs préremplis, et le compte connecté doit confirmer leurs informations et réaccepter les Conditions d’utilisation de Connect avant de terminer l’intégration.
Invitez vos comptes connectés à terminer l’intégration.

Batch la migration en phases

Nous vous recommandons de répartir la migration par lots pour les utilisateurs existants en phases, en fonction des cas d’utilisation spécifiques de votre plateforme. Commencez la migration avec un petit groupe d’utilisateurs pour vous assurer que l’intégration fonctionne et que vous pouvez travailler avec ces utilisateurs et recueillir des commentaires pendant le processus.

Les plateformes peuvent avoir des comptes connectés Standard, Express et Personnalisés en même temps. Nous vous recommandons d’intégrer de nouveaux comptes en utilisant la nouvelle configuration de compte connecté et de migrer les comptes existants en parallèle.