So testen Sie Stripe Connect
Vor dem Go-Live können Sie das Erstellen von Konten, die Identitätsprüfung und Auszahlungen über Ihre Connect-Integration testen.
Führen Sie Tests durch, um sicherzustellen, dass Ihre Connect-Integration verschiedene Abläufe korrekt abwickelt. Mit Sandboxes können Sie den Live-Modus simulieren und gleichzeitig die von Stripe bereitgestellten speziellen Token für Ihre Tests nutzen. Weitere Informationen zum Testen von Zahlungen, Zahlungsanfechtungen usw. finden Sie im Leitfaden zum Testen von Zahlungen.
Testkonten erstellen
Sie können mehrere Testkonten mit unterschiedlichen Kontotypen oder Controller-Eigenschaften erstellen, die Sie testen möchten.
Sie können Testkonten mit der Accounts API oder im Stripe-Dashboard erstellen.
Verwenden Sie bei der Aufforderung zum Erstellen von Testkonten als SMS-Code 000-000.
OAuth-Ablauf testen
Sie können Ihre OAuth-Integration mit verbundenen Konten testen, die ein von Stripe gehostetes Dashboard verwenden, indem Sie Ihre Test-client_ verwenden.
Ihre Test-client_ ist ca_. Sie finden dies in Ihren Connect OAuth-Einstellungen.
Ihre Test-client_ bietet Ihnen folgende Möglichkeiten:
- Ihre
redirect_auf eine Nicht-HTTPS-URL festlegenuri - Ihre
redirect_auf localhost festlegenuri - Das Kontoformular automatisch überspringen, um keinen kompletten Kontoantrag ausfüllen zu müssen (nur Stripe Dashboard-Konten)
- Token für den Testzugriff auf verbundene Konten abrufen
Um den OAuth-Ablauf zu testen, klicken Sie auf den OAuth-Link und erstellen Sie ein neues Konto. Sie können auch das Verbinden eines bestehenden Stripe-Kontos testen, allerdings nur, wenn die E-Mail-Adresse Ihrem Plattformkonto abweicht.
Identitätsprüfung
Nachdem Sie ein verbundenes Testkonto erstellt haben, können Sie mithilfe von Token verschiedene Verifizierungsstatus testen. So stellen Sie sicher, dass Ihre Plattform unterschiedliche Anforderungen und Kontostatus berücksichtigen kann. Für das Testen der Verifizierung mit Testkonten können Sie die folgenden Token nutzen.
Test-Geburtsdaten
Verwenden Sie diese Geburtsdaten, um bestimmte Verifizierungsbedingungen auszulösen.
| Geburtsdatum | Typ |
|---|---|
1901-01-01 | Übereinstimmung des Geburtsdatums war erfolgreich. Jedes andere Geburtsdatum führt zu keiner Übereinstimmung. |
1902-01-01 | Erfolgreich, sofortige Übereinstimmung des Geburtsdatums. Das Verifizierungsergebnis wird direkt in der Antwort zurückgegeben, nicht als Teil eines Webhook-Ereignisses. |
1900-01-01 | Dieses Geburtsdatum löst eine Warnung des Office of Foreign Assets Control (OFAC) aus. |
Test-Adressen
Verwenden Sie diese Adressen, um mit line1 bestimmte Verifizierungsbedingungen auszulösen. Für die Argumente city, state und postal_ müssen Sie gültige Werte angeben.
| Token | Typ |
|---|---|
address_ | Erfolgreiche Adressübereinstimmung. |
address_ | Erfolgreich, sofortige Adressübereinstimmung. |
address_ | Eine fehlgeschlagene Adressübereinstimmung löst wahrscheinlich Anforderungen in currently_ aus. |
address_ | Eine fehlgeschlagene Adressübereinstimmung löst wahrscheinlich Anforderungen in currently_ aus |
Test-Personalausweisnummern
Verwenden Sie diese Personalausweisnummern für das Attribut individual.id_number für das Account oder das Attribut id_number für das Person-Objekt, um bestimmte Verifizierungsbedingungen auszulösen.
| Die Nummer | Typ |
|---|---|
000000000 | Übereinstimmung mit der ID-Nummer ist erfolgreich. 0000 funktioniert auch für die Verifizierung der letzten vier Ziffern der Sozialversicherungsnummer. |
111111111 | Nicht erfolgreiche Übereinstimmung der ID-Nummer (Identität stimmt nicht überein), löst wahrscheinlich Anforderungen in currently_ aus. |
222222222 | Erfolgreicher, sofortiger Abgleich der ID-Nummer. Das Verifizierungsergebnis wird direkt in der Antwort zurückgegeben, nicht als Teil eines Webhook-Ereignisses. |
Test-Identitätsnachweise
Verwenden Sie zum Testen Testbilder oder Datei-Token, anstatt Ihre eigenen Test-IDs hochzuladen. Weitere Informationen finden Sie unter Hochladen einer Datei.
Test-Dokumentbilder
Sie können ein verifiziertes Bild verwenden, das bewirkt, dass die ID-Nummer erfolgreich übereinstimmt. Sie können ein nicht verifiziertes Bild verwenden, das zu einer Nichtübereinstimmung der Ausweisnummer führt, was zu currently_-Anforderungen führt.
Notiz
Testbilder haben Vorrang vor Test-ID-Nummern. Wenn Sie ein verifiziertes Bild hochladen, ist der Abgleich der ID-Nummer erfolgreich, auch wenn Sie außerdem einen erfolglosen Test-ID-Wert angeben. Auf ähnliche Weise schlägt die ID-Übereinstimmung bei einem nicht verifizierten Bild automatisch fehl, unabhängig vom Wert anderer Testartefakte.
Test-Datei-Token
Verwenden Sie diese Datei-Token, um bei der Identitätsprüfung bestimmte Bedingungen auszulösen.
| Token | Typ |
|---|---|
file_ | Verwendet das verifizierte Bild und markiert diese Dokumentanforderung als erfüllt. |
file_ | Verwendet das nicht verifizierte Bild und markiert diese Dokumentanforderung als nicht erfüllt. |
Verifizierung der Unternehmensinformationen
Prüfung von Geschäftsadressen
In einigen Ländern muss die mit Ihrem verbundenen Konto verknüpfte Geschäftsadresse geprüft werden, bevor Zahlungen und/oder Auszahlungen für das verbundene Konto aktiviert werden können.
Test-Geschäftsadressen
Verwenden Sie diese Adressen, um mit line1 bestimmte Validierungsbedingungen auszulösen. Für die Argumente city, state und postal_ müssen Sie gültige Werte angeben.
Beginnen Sie unbedingt mit einem Adress-Token, das die restriktivste Validierungsbedingung aufweist, auf die Sie testen möchten. Dies liegt daran, dass Sie kein Adresstoken verwenden können, das eine restriktivere Validierungsbedingung als das zuvor verwendete Token hat. Wenn Sie beispielsweise address_ angegeben haben, um sowohl Zahlungen als auch Auszahlungen zu aktivieren, können Sie Auszahlungen oder Zahlungen nicht hinterher deaktivieren, indem Sie das Token gegen ein ungültiges tauschen. Sie können dieses Problem umgehen, indem Sie ein neues Konto mit dem entsprechenden Token erstellen.
| Token | Typ |
|---|---|
address_ | Für das Konto sind sowohl Zahlungen als auch Auszahlungen aktiviert. |
address_ | Für das Konto sind nur Zahlungen aktiviert. Da die Validierung für das Attribut line1 gescheitert ist, wird es erneut im Hash requirements aufgelistet. |
address_ | Für das Konto sind weder Zahlungen noch Auszahlungen aktiviert. Da die Validierung gescheitert ist, werden die Adressattribute erneut im Hash requirements aufgelistet. |
Test-Steuernummern für Unternehmen
Verwenden Sie diese Steuernummern für Unternehmen für company.tax_id, um bestimmte Verifizierungsbedingungen auszulösen. Das Testverhalten kann sich abhängig von den Ländern des verbundenen Kontos und den Vorschriften in diesen Ländern ändern. Je nach den Vorschriften in diesen Ländern kann ein gültiges Steuerdokument die in diesen Ländern überprüfte Steuer-ID kennzeichnen.
| Die Nummer | Typ |
|---|---|
000000000 | Erfolgreiche Übereinstimmung der Unternehmens-ID-Nummer. |
000000001 | Übereinstimmung der Unternehmens-ID-Nummer als gemeinnützige Organisation erfolgreich. |
111111111 | Übereinstimmung mit der Unternehmens-ID-Nummer nicht erfolgreich (Identität stimmt nicht überein). |
111111112 | Übereinstimmung mit der Unternehmens-ID-Nummer nicht erfolgreich (Steueridentifikationsnummer wurde nicht ausgestellt). |
222222222 | Erfolgreicher, sofortiger Abgleich der Unternehmens-ID-Nummer. Das Verifizierungsergebnis wird direkt in der Antwort zurückgegeben, nicht als Teil eines Webhook-Ereignisses. |
Verifizierung der Unternehmensleitung testen
Stripe führt die Verifizierung der Unternehmensleitung durch, indem wir die Liste der Geschäftsinhaber/innen im Account-Objekt mit einer Liste abgleichen, die wir aus lokalen Registern beziehen. Wenn das Land dies erfordert, können Sie die Verifizierung für ein Account-Objekt auslösen, indem Sie diese Token für das Attribut first_name für die zugehörige Person verwenden und das Attribut Attribut relationship.director für die Person auf „true“ festlegen.
| Token | Typ |
|---|---|
mismatch_ | Keine Übereinstimmung aufgrund eines nicht übereinstimmenden Namens. Dies kann einen verification_-Verifizierungsfehler auslösen. |
missing_ | Keine Übereinstimmung aufgrund fehlender Geschäftsführer/innen in dem Konto. Dies kann einen verification_-Verifizierungsfehler auslösen. |
extraneous_ | Keine Übereinstimmung wegen zu vieler Geschäftsführer/innen in dem Konto. Dies kann einen verification_-Verifizierungsfehler auslösen. |
Die Verifizierungsfehler können ausgelöst werden, wenn mehrere Geschäftsführer/innen im Account-Objekt diese magischen Token verwenden.
Verifizierung des Unternehmensnamens testen
Lösen Sie die Verifizierung des Unternehmensnamens für ein Account-Objekt aus, indem Sie dieses Token für das Attribut company.name verwenden.
| Token | Typ |
|---|---|
mismatch_ | Keine Übereinstimmung aufgrund eines nicht übereinstimmenden Firmennamens. |
disallowed_ | Keine Übereinstimmung aufgrund eines allgemeinen oder bekannten Firmennamens. |
match_ | Erfolgreiche Übereinstimmung des Firmennamens. |
match_ | Keine Übereinstimmung aufgrund von Abweichungen des Firmennamens. |
Verifizierung der Zahlungsbeschreibung in der Abrechnung testen
Lösen Sie die Verifizierung für die Zahlungsbeschreibung in der Abrechnung für ein Account-Objekt aus, indem Sie dieses Token für das Attribut settings.payments.statement_descriptor verwenden.
| Token | Typ |
|---|---|
mismatch | Verifizierungsfehler invalid_ auslösen. |
disallowed | Verifizierungsfehler invalid_ auslösen. |
Lösen Sie die Verifizierung des Präfixes für die Zahlungsbeschreibung in der Abrechnung für ein Account-Objekt aus, indem Sie dieses Token für das Attribut settings.card_payments.statement_descriptor_prefix verwenden.
| Token | Typ |
|---|---|
mismatch | Verifizierungsfehler invalid_ auslösen. |
disallowed | Verifizierungsfehler invalid_ auslösen. |
Verifizierung der Unternehmens-URL testen
Lösen Sie die URL-Verifizierung für ein Account-Objekt aus, indem Sie dieses Token für das Attribut business_profile.url verwenden.
| Token | Typ |
|---|---|
https://disallowed. | Verifizierungsfehler invalid_ auslösen. |
https://geoblocked. | Löst einen Verifizierungsfehler des Typs invalid_ aus. |
https://problem. | Verifizierungsfehler invalid_ auslösen. |
https://missing. | Verifizierungsfehler invalid_ auslösen. |
https://mismatch. | Verifizierungsfehler invalid_ auslösen. |
https://passwordprotected. | Löst einen Verifizierungsfehler des Typs invalid_ aus. |
https://accessible. | Lösen Sie eine erfolgreiche Validierung der URL aus. |
https://underconstruction. | Löst einen Verifizierungsfehler des Typs invalid_ aus. |
https://inaccessible. | Verifizierungsfehler invalid_ auslösen. |
DBA-Verifizierung (Doing Business As) testen
Lösen Sie die DBA-Verifizierung für ein Account-Objekt aus, indem Sie dieses Token für das Attribut business_profile.name verwenden.
| Token | Typ |
|---|---|
disallowed_ | Verifizierungsfehler invalid_ auslösen. |
invalid_ | Verifizierungsfehler invalid_ auslösen. |
Verifizierung der Produktbeschreibung testen
Lösen Sie die Verifizierung der Produktbeschreibung für ein Account-Objekt aus, indem Sie dieses Token für das Attribut business_profile.product_description verwenden.
| Token | Typ |
|---|---|
require_ | Verifizierungsfehler invalid_ auslösen. |
Test der Telefonnummernvalidierung
Löschen Sie die Telefonnummernvalidierung für ein Account-Objekt mithilfe dieses Tokens für die folgenden Attribute:
Löschen Sie die Telefonnummernvalidierung für ein Person-Objekt mithilfe dieses Tokens für das Attribut phone.
| Token | Typ |
|---|---|
0000000000 | Erfolgreiche Validierung |
Gründe für Deaktivierung der Testfähigkeit
Lösen Sie die Zuweisung eines bestimmten requirements.disabled_reason zu allen inaktiven Capability-Objekten eines Account-Objekts aus, indem Sie dieses Token für das Attribut business_profile.url des Kontos verwenden.
| Token | Typ |
|---|---|
https://inactivity. | Legen Sie ein Konto als inaktiv fest und setzen Sie alle Verifizierungen für das Konto aus. Legen Sie den Deaktivierungsgrund für alle inaktiven Funktionen auf paused. fest (rejected. für API-Versionen vor 2024-06-20). |
Verifizierung auslösen oder voranbringen
Trigger-Karten
Verwenden Sie diese Kartennummern, um beim Testen beider Anforderungen und der sukzessiven Verifizierung verschiedene Bedingungen auszulösen. Damit die Auslöser-Aktionen funktionieren, müssen Sie diese Karten mit einer Connect-Zahlung verwenden. Legen Sie dazu on_behalf_of fest oder erstellen Sie die Zahlung direkt im verbundenen Konto.
| Die Nummer | Token | Typ |
|---|---|---|
| 4000000000004202 | tok_ | Ändert den nächsten Satz Anforderungen von später fällig in aktuell fällig. |
| 4000000000004210 | tok_ | Löst eine Zahlungssperre aus. |
| 4000000000004236 | tok_ | Löst eine Auszahlungssperre aus. |
Nächste Anforderungen auslösen
Im Live-Modus können zusätzliche Verifizierungsinformationen erforderlich sein, wenn ein verbundenes Konto ein bestimmtes Volumen verarbeitet. Mit dieser Karte wird festgelegt, dass zusätzliche Verifizierungsinformationen sofort erforderlich sind. Wenn keine zusätzlichen Informationen erforderlich sind, geschieht nichts weiter.
Trigger für Zahlungs- oder Auszahlungssperre
Wenn erforderliche Informationen nicht bis zur jeweiligen Frist bereitgestellt werden, deaktiviert Stripe Zahlungen oder Auszahlungen für das verbundene Konto. Diese Karten deaktivieren das verbundene Konto und alle aktuell fälligen Anforderungen werden überfällig. Diese Karten haben so lange keine Auswirkungen, bis ein Konto die zur Aktivierung von Zahlungen und Auszahlungen ursprünglich erforderlichen Informationen bereitstellt.
Überprüfung der Eigentumsrechte am Bankkonto auslösen
Verbundene Konten in den Vereinigten Staaten und Indien unterliegen einer Verifizierung der Eigentumsrechte am Bankkonto. Sie können diese Verifizierung durchführen, indem Sie Nachweise mit dem Connect Dashboard oder mit der API über den Hasch Dokumente[bank_account_ownership_verification] hochladen.
Während des Tests können Sie das Verifizierungsverfahren für die Inhaberschaft des US-Bankkontos simulieren. Verwenden Sie die folgenden Testbankkontonummern, um den Verifizierungsprozess auszulösen. Eine Zahl setzt eine erfolgreiche Verifizierung voraus und die andere fordert Sie auf, Testbilder oder Datei-Token hochzuladen, um die Verifizierung abzuschließen. Diese Testkonten sind nur für US-Konten verfügbar.
| Routing | Konto | Typ |
|---|---|---|
110000000 | 000999999991 | Verfahren zur Verifizierung der Eigentumsrechte am Bankkonto wird nach kurzer Verzögerung ausgelöst |
110000000 | 000999999992 | Verfahren zur Verifizierung der Eigentumsrechte am Bankkonto wird nach kurzer Verzögerung und Aufforderung zum Hochladen von Dokumenten ausgelöst |
Gelder in Stripe-Guthaben einzahlen
Um das Einzahlen von Geldern von einem Bankkonto auf Ihr Stripe-Guthaben im Dashboard zu testen, erstellen Sie eine Sandbox und wählen Sie das gewünschte Testbankkonto im Dropdown-Menü im Dialogfeld Guthaben aufstocken aus. Sie können Erfolg oder Misserfolg aufgrund unzureichender Deckung simulieren.
Verwenden Sie die folgenden Test-Bank-Token als Quelle, um das Hinzufügen von Geldern in der API zu testen. Jedes Token simuliert eine bestimmte Art von Ereignis.
| Token | Typ |
|---|---|
btok_ | Erfolgreich |
btok_ | Nicht erfolgreich mit Code no_ |
btok_ | Nicht erfolgreich mit Code account_ |
btok_ | Nicht erfolgreich mit Code insufficient_ |
btok_ | Nicht erfolgreich mit Code debit_ |
btok_ | Nicht erfolgreich mit Code invalid_ |
Payouts
Verwenden Sie die folgenden Test-Bankkontonummern und Test-Debitkartennummern, um bestimmte Ereignisse beim Testen von Auszahlungen auszulösen. Sie können diese Werte nur beim Testen mit Test-Geheimschlüsseln verwenden.
Testauszahlungen simulieren eine Live-Auszahlung, werden aber bei der Bank nicht verarbeitet. Für Testkonten mit Zugriff auf das Stripe-Dashboard sind Auszahlungen immer aktiviert, solange gültige externe Bankdaten angegeben wurden und ggf. weitere Bedingungen erfüllt sind. Eine richtige Identitätsprüfung ist nicht erforderlich.
Notiz
Sie können keine Test-Bankkontonummern und Test-Debitkartennummern im Stripe-Dashboard für ein verbundenes Konto im Live-Modus verwenden. Wenn Sie Ihre Bankkontodaten für ein Konto im Live-Modus eingegeben haben, können Sie weiterhin eine Sandbox verwenden, und Testauszahlungen simulieren eine Live-Auszahlung, ohne dass echtes Geld verarbeitet wird.
Bankkontonummern
Verwenden Sie zum Testen von Auszahlungen diese Test-Bankkontonummern. Sie können nur mit Test-Geheimschlüsseln verwendet werden.
Debitkartennummern
Verwenden Sie zum Testen von Auszahlungen diese Test-Debitkartennummern. Sie können nur mit Test-Geheimschlüsseln verwendet werden.