So testen Sie Stripe Connect
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_id
im Testmodus verwenden.
Ihr Testmodus-client_id
ist ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb
. Sie finden diese in Ihren Connect OAuth-Einstellungen.
Mit Ihrer client_id
im Testmodus können Sie:
- Ihre
redirect_uri
auf eine Nicht-HTTPS-URL festlegen - Ihre
redirect_uri
auf localhost festlegen - 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_code
müssen Sie gültige Werte angeben.
Token | Typ |
---|---|
address_full_match | Verifizierung erfolgreich. |
address_no_match | Verifizierung nicht erfolgreich. |
address_line1_no_match | 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 Datei-Token, anstatt Ihre eigenen Test-IDs hochzuladen. Weitere Informationen finden Sie unter Hochladen einer Datei.
Test-Datei-Token
Verwenden Sie diese Datei-Token, um bei der Identitätsprüfung bestimmte Bedingungen auszulösen.
Token | Typ |
---|---|
file_identity_document_success | Verwendet das verifizierte Bild und markiert diese Dokumentanforderung als erfüllt. |
file_identity_document_failure | 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_code
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_full_match
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_full_match | Für das Konto sind sowohl Zahlungen als auch Auszahlungen aktiviert. |
address_no_match | 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_line1_no_match | 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.
Nummer | Typ |
---|---|
000000000 | Verifizierung erfolgreich. |
000000001 | Verifizierung als gemeinnützige Organisation erfolgreich. |
100000002 | Erfolgreiche Verifizierung als in Kanada registrierte Wohltätigkeitsorganisation. |
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 Geschäftsführer/in testen (nur in Kanada)
Lösen Sie die Verifizierung der Leitung für ein Account
-Objekt aus, indem Sie dieses Token für das Attribut individual.first_name. verwenden und das Attribut individual.relationship.director auf „true“ festlegen.
Token | Typ |
---|---|
mismatch_director | Die Verifizierung dieser Leitung war nicht erfolgreich. |
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_business_name | Die Verifizierung konnte aufgrund eines nicht übereinstimmenden Firmennamens nicht erfolgreich durchgeführt werden. |
disallowed_name | Die Verifizierung konnte aufgrund des allgemeinen oder bekannten Firmennamens nicht erfolgreich durchgeführt werden. |
match_name_relationships | Der Firmenname konnte erfolgreich verifiziert werden. |
match_name_only | 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_statement_descriptor_business_mismatch auslösen. |
disallowed | Verifizierungsfehler invalid_statement_descriptor_denylisted 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_statement_descriptor_prefix_mismatch auslösen. |
disallowed | Verifizierungsfehler invalid_statement_descriptor_prefix_denylisted 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.stripe.com | Verifizierungsfehler invalid_url_denylisted auslösen. |
https://problem.stripe.com | Verifizierungsfehler invalid_url_website_other auslösen. |
https://missing.stripe.com | Verifizierungsfehler invalid_url_website_incomplete auslösen. |
https://mismatch.stripe.com | Verifizierungsfehler invalid_url_website_business_information_mismatch auslösen. |
https://accessible.stripe.com | Lösen Sie eine erfolgreiche Validierung der URL aus. |
https://inaccessible.stripe.com | Verifizierungsfehler invalid_url_website_inaccessible 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_dba | Verifizierungsfehler invalid_business_profile_name_denylisted auslösen. |
invalid_dba | Verifizierungsfehler invalid_business_profile_name 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_url | Verifizierungsfehler invalid_url_web_presence_detected auslösen. |
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_visa_triggerNextRequirements | Ändert den nächsten Satz Anforderungen von später fällig in aktuell fällig. |
4000000000004210 | tok_visa_triggerChargeBlock | Löst eine Zahlungssperre aus. |
4000000000004236 | tok_visa_triggerPayoutBlock | 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 | BetaVerfahren zur Verifizierung der Eigentumsrechte am Bankkonto wird nach kurzer Verzögerung ausgelöst und ein Dokumenten-Upload wird angefordert |
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.currently_due |
---|---|---|
Verifiziertes Geburtsdatum und verifizierte Adresse | Verifiziert | Keine |
Verifiziertes Geburtsdatum und nicht verifizierte Adresse | Nicht verifiziert | verification.additional_document |
Nicht verifiziertes Geburtsdatum und verifizierte Adresse | Nicht verifiziert | verification.document |
Nicht verifiziertes Geburtsdatum und nicht verifizierte Adresse | Nicht verifiziert | verification.additional_document , verification.document |
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_us_verified | Erfolgreich |
btok_us_verified_noAccount | Nicht erfolgreich mit Code no_account |
btok_us_verified_accountClosed | Nicht erfolgreich mit Code account_closed |
btok_us_verified_insufficientFunds | Nicht erfolgreich mit Code insufficient_funds |
btok_us_verified_debitNotAuthorized | Nicht erfolgreich mit Code debit_not_authorized |
btok_us_verified_invalidCurrency | Nicht erfolgreich mit Code invalid_currency |
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.