Connect-Integration migrieren, um Controller-Eigenschaften anstelle von Kontotypen zu verwenden
Erfahren Sie, wie Sie mit den Eigenschaften der Konto-Controller arbeiten, anstatt Kontotypen anzugeben.
Sie können nun verbundene Konten mit den Eigenschaften des Konto-Controllers konfigurieren, anstatt Konten speziell als Standard, Express oder Custom zu definieren. Mit diesen Controller-Eigenschaften können Sie einzelne Kontoverhaltensweisen festlegen, z. B. auf welches von Stripe gehostete Dashboard das Konto zugreifen kann oder von wem Stripe Gebühren erhebt. Diese Modularität ermöglicht flexiblere Konfigurationsmöglichkeiten.
Durch die Verwendung der Controller-Eigenschaften für die Konten müssen Sie Ihre API-Version nicht zwingend aktualisieren. Die Migration Ihrer Integration zur Verwendung der Controller-Eigenschaften ist optional. Wenn Sie nur einen Typ verbundener Konten verwenden und nicht daran interessiert sind, eine neue Konfiguration zu verwenden, müssen Sie Ihre Integration nicht aktualisieren.
Wir empfehlen Ihnen, Ihre Integration zu aktualisieren. So können Sie von der verbesserten Modularität und den neuen verfügbaren Konfigurationen profitieren. Die neuen Eigenschaften sind vollständig abwärtskompatibel, sodass Sie Ihre Integration schrittweise migrieren können, während Sie weiterhin mit den Kontotypen arbeiten.
Jeder Kontotyp wird einem Satz von Controller-Eigenschaften zugeordnet. Wir legen diese Eigenschaften automatisch für Ihre bestehenden verbundenen Konten und für alle Konten fest, die Sie in Zukunft mit Kontotypen erstellen. Wenn Sie Ihre Integration aktualisieren, um mit Controller-Eigenschaften zu arbeiten, müssen Sie keines Ihrer verbundenen Konten aktualisieren.
Notiz
Sie können Funktionen, wie z. B. eingebettete Komponenten verwenden, ohne die Änderungen in diesem Leitfaden vorzunehmen.
Bevor Sie beginnen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
- Erfahren Sie, wie Controller-Eigenschaften funktionieren und wie sie Ihren bestehenden verbundenen Konten zugeordnet werden.
- Bestimmen Sie, welche der neuen Kontokonfigurationen für Ihre Integration sinnvoll sind.
Die Aktualisierung Ihrer Integration umfasst Folgendes:
- Suchen Sie nach dem Code in Ihrer Integration, der auf den Kontotyp verweist. Aktualisieren Sie diesen so, dass er stattdessen auf die entsprechenden Controller-Eigenschaften verweist.
- Aktualisieren Sie den Ablauf Ihren Kontoerstellung, um Controller-Eigenschaften anstelle von
type
anzugeben. Die Angabe destype
ist nicht mehr erforderlich.
Eigenschaften des Konto-Controllers![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Sie können Werte für die Controller-Eigenschaften angeben, wenn Sie ein verbundenes Konto mit der Accounts API erstellen. Jede Eigenschaft, die Sie nicht angeben, ist auf einen Standardwert mit den am wenigsten komplexen Integrationsanforderungen festgelegt.
Wenn Sie eine neue Integration erstellen, können Sie eine Konfigurationsempfehlung erhalten, indem Sie das Connect Onboarding für Plattformen abschließen.
Eigenschaft | Standardwert | Beschreibung |
---|---|---|
controller.losses.payments | stripe | Mögliche Werte:
|
| Mögliche Werte:
Wenn Sie ein Konto erstellen, können Sie nur entweder
Eine umfassende Beschreibung der Zahlungsmodelle für Stripe finden Sie in der Dokumentation zum Gebührenverhalten. | |
controller.requirement_collection | stripe | Mögliche Werte:
|
controller.stripe_dashboard.type | full | Mögliche Werte:
|
Siehe Beschreibung | Mögliche Werte:
Die Angabe des |
Zuordnung von Kontotypen zu Controller-Parametern![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Jeder der drei Kontotypen entspricht Werten im controller
-Hash von v1/accounts
zugeordnet, die dem Verhalten dieses Typs entsprechen.
Standard![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Wenn Sie ein Konto erstellen und dabei keine Controller-Eigenschaften angeben, entsprechen die Standardwerte dem Verhalten eines Standard-Konto. Sie können auch das Äquivalent eines Standard-Kontos erstellen, indem Sie die Werte angeben, die dem Verhalten des Standard-Konto entsprechen.
Diese Werte können dem Verhalten eines Standard-Kontos zugordnet werden:
losses.
:payments stripe
fees.
:payer account
requirement_
:collection stripe
stripe_
:dashboard. type full
Express![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Diese Werte können dem Verhalten eines Express-Kontos zugordnet werden:
losses.
:payments application
fees.
:payer application
(siehe Hinweis)requirement_
:collection stripe
stripe_
:dashboard. type express
Notiz
Wenn Sie ein Express-Konto mit type
erstellen, wird die Eigenschaft controller.
auf application_
anstelle von application
festgelegt. Wenn Ihre Plattform Direct Charges verwenden, wird durch diesen Unterschied eine Änderung am Abrechnungsverhalten für die Stripe-Gebühren aufgezeigt.
Custom![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Diese Werte können dem Verhalten eines Custom-Kontos zugordnet werden:
losses.
:payments application
fees.
:payer application
(siehe Hinweis)requirement_
:collection application
stripe_
:dashboard. type none
Beim Erstellen eines Custom-Kontos müssen Sie auch das Kontoland angeben sowie die Funktionen card_
and transfers
anfordern.
Notiz
Wenn Sie ein Custom-Konto mit type
erstellen, wird die Eigenschaft controller.
auf application_
anstelle von application
festgelegt. Wenn Ihre Plattform Direct Charges verwenden, wird durch diesen Unterschied eine Änderung am Abrechnungsverhalten für die Stripe-Gebühren aufgezeigt.
Code migrieren, um Controller-Eigenschaften zu verwenden![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Um Controller-Eigenschaften zu verwenden, aktualisieren Sie zusätzlich zur Aktualisierung Ihres Ablaufs für Kontoerstellungen auch Ihre Integration, indem Sie Ihren Code überprüfen und nach Verweisen auf Kontotypen suchen.
Bestimmen Sie für jeden Verweis auf einen Kontotyp, welche Controller-Eigenschaft(en) relevant sind, und aktualisieren Sie Ihren Code entsprechend.
Angenommen, Ihr Code enthält eine bedingte Anweisung, die für Express- und Custom-Konten gilt, da sie sich darauf bezieht, dass Ihre Plattform für negative Salden haftet. Aktualisieren Sie diese Logik von if type == express
oder if type == custom
auf if controller.
.
Wenn Sie verbundene Konten erstellen, die mit keinem Kontotyp übereinstimmen, sollten Sie bei der Aktualisierung Ihres Codes auch deren Controller-Eigenschaften berücksichtigen. Die Logik für die Verwaltung dieser Konten kann von Ihrer bestehenden Logik, die auf dem Kontotyp basiert, abweichen.
Sie können diese Tabelle verwenden, um die Controller-Eigenschaften zu bestimmen, die jedem Kontotyp zugeordnet sind:
Kontotyp | losses.payments | fees.payer | requirement_collection | stripe_dashboard.type |
---|---|---|---|---|
Custom | application | application_ | application | none |
Express | application | application_ | stripe | express |
Standard | stripe | account | stripe | full |
Notiz
Bedenken Sie, dass Express- und Custom-Konten einen anderen Wert für fees.
haben als ähnliche Konten, die mit Controller-Eigenschaften erstellt wurden. Bei der Aktualisierung Ihres Codes im Zusammenhang mit der Erhebung von Gebühren müssen Sie die unterschiedlichen Verhaltensweisen berücksichtigen.
Nicht unterstützte Konfigurationen![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
Beim Erstellen von Konten mit Controller-Eigenschaften werden die folgenden Kombinationen nicht unterstützt:
controller.
= application
ist mit keinem der folgenden Werte kompatibel:
controller.
=losses. payments stripe
controller.
=fees. payer account
controller.
=stripe_ dashboard. type express
controller.
=stripe_ dashboard. type full
controller.
= express
ist mit keinem der folgenden Werte kompatibel:
controller.
=losses. payments stripe
controller.
=fees. payer account
controller.
=requirement_ collection application
controller.
= full
ist mit keinem der folgenden Werte kompatibel:
controller.
=losses. payments application
controller.
=fees. payer application
controller.
=requirement_ collection application
controller.
= none
wird nicht unterstützt, wenn beide der folgenden Werte eingestellt sind (es wird jedoch unterstützt, wenn nur einer eingestellt ist):
controller.
=requirement_ collection stripe
controller.
=losses. payments application