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 erstellen und jeden beliebigen Kontotyp oder Cotroller-Eigenschaften (zum Beispiel für verschiedene Währungen) verwenden.
Sie können Testkonten über die 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, die ein von Stripe gehostetes Dashboard verwenden, mit Ihrer client_ testen.
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 | Erfolgreiche Verifizierung. Jedes andere Geburtsdatum führt zu einem Fehlschlagen der Verifizierung. |
1902-01-01 | Erfolgreiche, sofortige Verifizierung. 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_ | Verifizierung erfolgreich. |
address_ | Verifizierung nicht erfolgreich. |
address_ | Verifizierung aufgrund teilweiser Adressübereinstimmung nicht erfolgreich. |
Test-Personalausweisnummern
Verwenden Sie diese Personalausweisnummern für individual.id_number oder das Attribut id_number im Objekt Person, um bestimmte Verifizierungsbedingungen auszulösen.
| Nummer | Typ |
|---|---|
000000000 | Erfolgreiche Verifizierung. 0000 funktioniert auch für die Verifizierung der letzten vier Ziffern der Sozialversicherungsnummer. |
111111111 | Verifizierung nicht erfolgreich (Identität stimmt nicht überein). |
222222222 | Erfolgreiche, sofortige Verifizierung. 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, mit dem die Nutzerin/der Nutzer automatisch als verified markiert wird. Sie können ein nicht verifiziertes Bild verwenden, mit dem die Nutzerin/der Nutzer automatisch als unverified markiert wird.
Notiz
Testbilder haben Vorrang vor Test-ID-Nummern. Wenn Sie ein verifiziertes Bild hochladen, ist die Verifizierung erfolgreich, auch wenn Sie außerdem einen erfolglosen Test-ID-Wert angeben. Ebenso schlägt die Verifizierung eines nicht verifizierten Bilds automatisch fehl, unabhängig vom Wert anderer Test-Artefakte.
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 hat, auf die Sie testen möchten. Grund dafür ist, dass Sie kein Adress-Token verwenden können, das eine restriktivere Validierungsbedingung als das zuvor verwendete Token hat. Wenn Sie zum Beispiel für address_ sowohl Zahlungen als auch Auszahlungen aktiviert haben, können Sie Auszahlungen oder Zahlungen nicht hinterher deaktivieren, indem Sie das Token gegen ein ungültiges tauschen. Sie können dieses Problem aber 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 das Attribut erneut im Hash requirements aufgelistet. |
address_ | Für das Konto sind weder Zahlungen noch Auszahlungen aktiviert. Da die Validierung gescheitert ist, werden die Adress-Attribute erneut im Hash requirements aufgelistet. |
Test-Steuernummern für Unternehmen
Verwenden Sie diese Steuernummern für Unternehmen, um mit company.tax_id bestimmte Verifizierungsbedingungen auszulösen. Das Testverhalten kann sich abhängig von den Ländern des verbundenen Kontos und den gelten 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.
| Nummer | Typ |
|---|---|
000000000 | Verifizierung erfolgreich. |
000000001 | Verifizierung als gemeinnützige Organisation erfolgreich. |
111111111 | Verifizierung nicht erfolgreich (Identität stimmt nicht überein). |
111111112 | Verifizierung nicht erfolgreich (Steueridentifikationsnummer wurde nicht ausgestellt). |
222222222 | Erfolgreiche, sofortige Verifizierung. 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 des Account-Objekts 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 person.first_name verwenden und das Attribut person.relationship.director auf „true“ setzen.
| Token | Typ |
|---|---|
mismatch_ | Verifizierung der Geschäftsführerin/des Geschäftsführers war aufgrund eines nicht übereinstimmenden Namens nicht erfolgreich. Dies kann einen Verifizierungsfehler des Typs verification_ auslösen. |
missing_ | Verifizierung war aufgrund fehlender Geschäftsführer/innen in dem Konto nicht erfolgreich. Dies kann einen Verifizierungsfehler des Typs verification_ auslösen. |
extraneous_ | Verifizierung war aufgrund zu vieler Geschäftsführer/innen in dem Konto nicht erfolgreich. Dies kann einen Verifizierungsfehler des Typs verification_ 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_ | Die Verifizierung konnte aufgrund eines nicht übereinstimmenden Firmennamens nicht erfolgreich durchgeführt werden. |
disallowed_ | Die Verifizierung konnte aufgrund des allgemeinen oder bekannten Firmennamens nicht erfolgreich durchgeführt werden. |
match_ | Der Firmenname konnte erfolgreich verifiziert werden. |
match_ | Die Verifizierung konnte aufgrund von Abweichungen des Firmennamens nicht erfolgreich durchgeführt werden. |
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 Verifizierung der URL 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, indem Sie dieses Token für das phone-Attribut verwenden.
| 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 ohne aktuelle Aktivität als inaktiv fest und pausieren Sie alle Verifizierungen dafür. Setzen Sie den deaktivierten Grund für alle inaktiven Funktionen auf paused. (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.
| 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 haben zur Folge, dass das verbundene Konto deaktiviert wird und alle aktuell fälligen Anforderungen überfällig werden. 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 über das Connect-Dashboard oder mit der API über den Hash documents[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.
| Bankleitzahl | Kontonummer | 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 |
Anforderungen simulieren
Wenn Ihre Plattform über verbundene Konten in verschiedenen Ländern verfügt oder entsprechende Pläne hat, müssen Sie je nach Land unter Umständen die Adressen und Identitäten von Personen prüfen. Stripe stellt Ihnen Muster-Geburtsdaten und Muster-Adressen zur Verfügung, um diese Anforderung zu testen.
| Bereitgestellte Informationen | Status der Identitätsprüfung | requirements. |
|---|---|---|
| Verifiziertes Geburtsdatum und verifizierte Adresse | Verifiziert | Keine |
| Verifiziertes Geburtsdatum und nicht verifizierte Adresse | Nicht verifiziert | verification. |
| Nicht verifiziertes Geburtsdatum und verifizierte Adresse | Nicht verifiziert | verification. |
| Nicht verifiziertes Geburtsdatum und nicht verifizierte Adresse | Nicht verifiziert | verification., verification. |
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_ |
Auszahlungen
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.