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.
Verwenden Sie Tests, um sicherzustellen, dass Ihre Connect-Integration die verschiedenen Abläufe korrekt handhabt. Im Test-Modus können Sie den Live-Modus simulieren und profitieren gleichzeitig von speziellen Stripe-Token, die Sie für Ihre Tests nutzen können. Weitere Informationen zum Testen von Zahlungen, Zahlungsanfechtungen usw. finden Sie in unserem 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 testen, die ein von Stripe gehostetes Dashboard mit Ihrer client_ im Testmodus verwenden.
Ihr Testmodus-client_ ist ca_. Sie finden diese in Ihren Connect OAuth-Einstellungen.
Mit Ihrer client_ im Testmodus können Sie:
- 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.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. |
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. | Set an account with no recent activity as inactive and pause all verifications for it. Set the disabled reason for any inactive capabilities to paused. (rejected. for API versions prior to 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.
Im Testmodus können Sie den Verifizierungsvorgang der Eigentümerschaft über das US-Bankkonto simulieren. Verwenden Sie die folgenden Testbankkontonummern, um den Verifizierungsvorgang 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-Bankkonten verfügbar.
| Bankleitzahl | Kontonummer | Typ |
|---|---|---|
110000000 | 000999999991 | Verfahren zur Verifizierung der Eigentumsrechte am Bankkonto wird nach kurzer Verzögerung ausgelöst |
110000000 | 000999999992 | Triggers the bank account ownership verification process after a short delay and requests for document upload |
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
Wenn Sie im Dashboard das Einzahlen von Geldern von einem Bankkonto in Ihr Stripe-Guthaben testen möchten, aktivieren Sie den Test-Modus und wählen Sie im Dropdown-Menü unter Zum Guthaben hinzufügen das gewünschte Test-Bankkonto aus. Sie können erfolgreiche und (durch unzureichende Kontodeckung) fehlgeschlagene Einzahlungen simulieren.
Um das Einzahlen von Geldern in der API zu testen, verwenden Sie im Test-Modus die folgenden Test-Bank-Token als Quelle. 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 bei Auszahlungen bestimmte Ereignisse auszulösen. Sie können diese Werte nur im Test-Modus mit Test-Geheimschlüsseln verwenden.
Auszahlungen im Test-Modus simulieren eine richtige Auszahlung, werden aber bei der Bank nicht verarbeitet. Für Testmodus-Konten 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 Testbank- und Debitkartennummern im Stripe Dashboard auf einem verbundenen Konto im Live-Modus verwenden. Wenn Sie Ihre Bankkontodaten auf einem Live-Modus-Konto eingegeben haben, können Sie trotzdem den Testmodus verwenden, und die Auszahlungen im Testmodus 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.