Migrer votre intégration Connect pour utiliser les propriétés du contrôleur au lieu des types de comptes
Apprenez à utiliser les propriétés du contrôleur de compte au lieu de spécifier des types de compte.
Vous pouvez désormais configurer vos comptes connectés à l’aide des propriétés du contrôleur de compte au lieu de définir les comptes sur les types Standard, Express ou Custom. Ces propriétés de contrôleur vous permettent de spécifier différents comportements de compte tels que le type de Dashboard hébergé par Stripe auquel le compte peut accéder ou auprès de qui Stripe perçoit les frais. Cette modularité vous donne accès à des options de configuration plus flexibles.
Using account controller properties doesn’t require you to update your API version. Migrating your integration to use controller properties is optional. If you only use one type of connected account and aren’t interested in using a new configuration, you don’t need to update your integration.
Nous vous recommandons de mettre à jour votre intégration pour profiter d’une modularité accrue et des nouvelles configurations disponibles. Les nouvelles propriétés sont entièrement rétrocompatibles : vous pouvez ainsi migrer votre intégration progressivement tout en continuant de travailler avec les types de compte.
Chaque type de compte correspond à un ensemble de propriétés du contrôleur. Nous définissons automatiquement ces propriétés sur vos comptes connectés existants et sur tous les comptes nouvellement créés avec des types de compte. Lorsque vous mettez votre intégration à jour de façon à ce qu’elle fonctionne avec les propriétés du contrôleur, vous n’avez pas besoin de mettre à jour vos comptes connectés.
Note
Vous pouvez commencer à utiliser des fonctionnalités telles que les composants intégrés sans prendre en compte les modifications suggérées dans ce guide.
Avant de commencer![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- Découvrez comment fonctionnent les propriétés du contrôleur de compte et de quelle manière elles correspondent à vos comptes connectés existants.
- Déterminez quelles sont les nouvelles configurations de compte qui conviennent à votre intégration.
La mise à jour de votre intégration implique ce qui suit :
- Identifier le code de votre intégration qui référence le type de compte et le mettre à jour pour qu’il référence les propriétés correspondantes du contrôleur.
- Mettre à jour votre processus de création de compte pour spécifier les propriétés du contrôleur au lieu du
type
. Il n’est plus nécessaire de spécifier letype
.
Propriétés du contrôleur de compte![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Vous pouvez spécifier des valeurs pour les propriétés du contrôleur lorsque vous créez un compte connecté à l’aide de l’API Accounts. Les propriétés non spécifiées sont définies sur une valeur par défaut qui présente les exigences d’intégration les moins complexes.
Si vous créez une nouvelle intégration, vous pouvez obtenir une recommandation de configuration en effectuant l’inscription de la plateforme Connect.
Propriété | Valeur par défaut | Description |
---|---|---|
controller.losses.payments | stripe | Valeurs possibles :
|
| Valeurs possibles :
Lorsque vous créez un compte, vous pouvez uniquement spécifier
Pour consultez la description complète des frais Stripe, reportez-vous à la documentation sur le comportement en matière de frais. | |
controller.requirement_collection | stripe | Valeurs possibles :
|
controller.stripe_dashboard.type | full | Valeurs possibles :
|
Voir la description | Valeurs possibles :
La spécification du |
Correspondance entre les types de comptes et les paramètres du contrôleur![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Chacun des trois types de compte est associé à des valeurs dans le hachage controller
de v1/accounts
qui correspondent au comportement de ce type.
Standard![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Si vous créez un compte sans spécifier de propriétés de contrôleur, les valeurs par défaut correspondent au comportement d’un compte Standard. Vous pouvez également créer l’équivalent d’un compte Standard en spécifiant les valeurs qui correspondent au comportement d’un compte Standard.
Ces valeurs correspondent au comportement d’un compte Standard :
losses.
:payments stripe
fees.
:payer account
requirement_
:collection Stripe
stripe_
:dashboard. type full
Express![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Ces valeurs correspondent au comportement d’un compte Express :
losses.
:payments application
fees.
:payer application
(voir note)requirement_
:collection Stripe
stripe_
:dashboard. type express
Note
Lorsque vous créez un compte Express en utilisant type
, la propriété controller.
est définie sur application_
au lieu d’application
. Cette différence indique une variation dans le comportement de facturation des frais de Stripe lorsque que votre plateforme utilise les paiements directs.
Custom![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Ces valeurs correspondent au comportement d’un compte Custom :
losses.
:payments application
fees.
:payer application
(voir note)requirement_
:collection application
stripe_
:dashboard. type none
Lors de la création d’un compte Custom, vous devez également spécifier le pays du compte et demander les fonctionnalités card_
et transfers
.
Note
Lorsque vous créez un compte Custom en utilisant type
, la propriété controller.
est définie sur application_
au lieu d’application
. Cette différence indique une variation dans le comportement de facturation des frais de Stripe lorsque que votre plateforme utilise les paiements directs.
Migrer le code pour utiliser les propriétés du contrôleur![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
En plus de mettre à jour votre processus de création de compte pour utiliser les propriétés du contrôleur, mettez votre intégration à jour en examinant votre code et en recherchant des références aux types de compte.
Pour chaque référence à un type de compte, déterminez les propriétés du contrôleur pertinentes et mettez le code à jour en conséquence.
Par exemple, imaginons que votre code comprenne une instruction conditionnelle qui s’applique aux comptes Express et Custom, liée à la responsabilité de votre plateforme à l’égard des soldes négatifs. Mettez à jour cette logique en remplaçant if type == express
ou if type == custom
par if controller.
.
Si vous créez des comptes connectés qui ne correspondent pas à un type de compte, tenez également compte des propriétés de leur contrôleur lors de la mise à jour de votre code. La logique de gestion de ces comptes peut différer de la logique existante basée sur les types de compte.
Vous pouvez utiliser ce tableau pour identifier les propriétés du contrôleur associées à chaque type de compte :
Type de compte | losses.payments | fees.payer | requirement_collection | stripe_dashboard.type |
---|---|---|---|---|
Custom | application | application_ | application | none |
Express | application | application_ | stripe | express |
Standard | stripe | account | stripe | full |
Note
N’oubliez pas que les comptes Express et Custom ont une valeur différente pour fees.
que les comptes équivalents créés à l’aide des propriétés du contrôleur. Lorsque vous mettez à jour le code lié à la perception des frais, vous devez tenir compte de cette différence de comportement.
Configurations non prises en charge![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Lors de la création de comptes avec des propriétés de contrôleur, les configurations suivantes ne sont pas prises en charge :
controller.
= application
n’est compatible avec aucune des valeurs suivantes :
controller.
=losses. payments stripe
controller.
=fees. payer account
controller.
=stripe_ dashboard. type express
controller.
=stripe_ dashboard. type full
controller.
= express
n’est compatible avec aucune des valeurs suivantes :
controller.
=losses. payments stripe
controller.
=fees. payer account
controller.
=requirement_ collection application
controller.
= full
n’est compatible avec aucune des valeurs suivantes :
controller.
=losses. payments application
controller.
=fees. payer application
controller.
=requirement_ collection application
controller.
= none
n’est pas pris en charge lorsque les deux valeurs suivantes sont définies (il est pris en charge lorsqu’une seule d’entre elles est définie) :
controller.
=requirement_ collection stripe
controller.
=losses. payments application