Testing Stripe Connect
Before going live, test your Connect integration for account creation, identity verification, and payouts.
Use testing to make sure your Connect integration handles different flows correctly. You can use Sandboxes to simulate live mode while taking advantage of Stripe-provided special tokens to use in your tests. See the payments testing guide for more information on testing charges, disputes, and so on.
Testing capabilities
Sandboxes and test mode might not enforce some capabilities. In certain cases, they can allow an account to perform capability-dependent actions even when the associated capability’s status isn’t active.
Créer des comptes de test
You can create multiple test accounts with different account types or controller properties that you want to test.
You can create test accounts using the Accounts API or in the Stripe Dashboard.
Utilisez 000-000 comme code SMS lorsque vous êtes invité à saisir des comptes de test.
Tester le flux OAuth
You can test your OAuth integration with connected accounts that use a Stripe-hosted Dashboard using your test client_.
Your test client_ is ca_. You can find this in your Connect OAuth settings.
Your test client_ allows you to:
- Définir votre
redirect_sur une URL non HTTPSuri - Définir votre
redirect_sur localhosturi - Ignorer le formulaire du compte pour éviter de devoir renseigner un formulaire d’activation entier (comptes avec un accès au Dashboard Stripe uniquement)
- Obtenir des tokens d’accès pour les comptes connectés
Pour tester le flux OAuth, créez un nouveau compte après avoir cliqué sur le lien OAuth. Vous pouvez également tester la connexion à un compte Stripe existant, mais uniquement si l’adresse e-mail est différente de celle du compte de votre plateforme.
Vérification d'identité
Après avoir créé un compte connecté de test, vous pouvez utiliser des tokens pour tester différents états de vérification afin de vous assurer que vous pouvez prendre en charge différents états de compte et différentes exigences. Vous pouvez utiliser les tokens suivants pour tester la vérification avec des comptes de test.
Tester les dates de naissance
Utilisez ces dates de naissance pour déclencher certaines conditions de vérification.
| Date de naissance | Type |
|---|---|
1901-01-01 | Successful date of birth match. Any other DOB results in a no-match. |
1902-01-01 | Successful, immediate date of birth match. The verification result is returned directly in the response, not as part of a webhook event. |
1900-01-01 | This DOB triggers an Office of Foreign Assets Control (OFAC) alert. |
Tester des adresses
Utilisez ces adresses pour que line1 déclenche certaines conditions de vérification. Vous devez utiliser des valeurs valides pour les arguments city, state et postal_.
| Jeton | Type |
|---|---|
| Successful address match. |
| Unsuccessful address match likely to trigger requirements in currently_. |
| Unsuccessful address match likely to trigger requirements in currently_ |
Tester des numéros d’ID personnels
Use these personal ID numbers for the individual.id_number attribute on the Account or the id_number attribute on the Person object to trigger certain verification conditions.
| Numéro | Type |
|---|---|
000000000 | Successful ID number match. 0000 also works for SSN last 4 verification. |
111111111 | Unsuccessful ID number match (identity mismatch) likely to trigger requirements in currently_. |
222222222 | Successful, immediate ID number match. The verification result is returned directly in the response, not as part of a webhook event. |
Test government-issued ID documents
Pour effectuer des tests, utilisez des images de test ou des tokens de fichier plutôt que vos propres identifiants de test. Pour en savoir plus, consultez la section Charger un fichier.
Tester des images de documents
You can use a verified image that causes the ID number to match successfully. You can use an unverified image that causes a mismatch on the ID number, leading to currently_ requirements.
Remarque
Test images take precedence over test ID numbers. If you upload a verified image, the ID number matching succeeds, even if you also provide an unsuccessful test ID value. Similarly, an unverified image automatically fails ID matching regardless of the value of other test artifacts.
Tester des tokens de fichier
Utilisez ces tokens de fichier pour déclencher certaines conditions de vérification.
| Jeton | Type |
|---|---|
file_ | Utilise l’image vérifiée et marque cette exigence documentaire comme satisfaite. |
file_ | Utilise l’image non vérifiée et marque cette exigence documentaire comme non satisfaite. |
Vérification des Informations de l'entreprise
Validation de l’adresse professionnelle
Dans certains pays, l’adresse professionnelle associée à votre compte connecté doit être validée pour que les paiements, les virements ou les deux puissent être activés.
Tester des adresses professionnelles
Utilisez ces adresses pour déclencher certaines conditions de validation. Vous devez transmettre des valeurs valides pour les arguments city, state et postal_.
Assurez-vous de commencer par le jeton d’adresse disposant des conditions de validation à tester les moins permissives. En effet, vous ne pouvez pas utiliser un jeton d’adresse qui a une condition de validation plus restrictive que le jeton précédent utilisé. Par exemple si vous avez fourni address_ pour que les paiements et les virements soient activés, vous ne pouvez plus désactiver les virements ou les paiements par la suite en remplaçant le jeton par un jeton non valide. Vous pouvez contourner ce problème en créant un nouveau compte et en spécifiant le jeton qui vous intéresse.
| Jeton | Type |
|---|---|
| Les paiements et les virements sont activés pour le compte. |
| Only charges are enabled on the account. Since validation failed on the line1 attribute, it becomes listed again in the requirements hash. |
| Neither charges nor payouts are enabled on the account. Since validation failed, the address attributes become listed again in the requirements hash. |
Tester des numéros d’identification fiscale d’entreprises
Use these business tax ID numbers for company.tax_id to trigger certain verification conditions. The test behavior might change depending on the Connected Account countries and the regulations in those countries. Depending on the country’s regulation, a valid tax document can mark tax ID verified in these countries.
| Numéro | Type |
|---|---|
000000000 | Successful business ID number match. |
000000001 | Successful business ID number match as a non-profit. |
111111111 | Unsuccessful business ID number match (identity mismatch). |
111111112 | Unsuccessful business ID number match (tax ID not issued). |
222222222 | Successful, immediate business ID number match. The verification result is returned directly in the response, not as part of a webhook event. |
Tester la vérification du poste de directeur
Stripe performs directorship verification by comparing the list of directors on the Account object against a list retrieved from local registries. If the country requires it, you can trigger verification for an Account object by using these tokens for the first_name attribute on the associated Person and setting the relationship.director attribute on the Person to true.
| Jeton | Type |
|---|---|
mismatch_ | Unsuccessful match due to a mismatched name. This can trigger a verification_ verification error. |
missing_ | Unsuccessful match due to directors missing on the account. This can trigger a verification_ verification error. |
extraneous_ | Unsuccessful match due to too many directors on the account. This can trigger a verification_ verification error. |
Les erreurs de vérification peuvent se produire si plusieurs directeurs de l’objet Account utilisent ces tokens magiques.
Tester la vérification du nom de l'entreprise
Trigger company name verification for an Account object by using this token for the company.name attribute.
| Jeton | Type |
|---|---|
mismatch_ | Unsuccessful match due to a mismatched business name. |
disallowed_ | Unsuccessful match due to a generic or well-known business name. |
match_ | Successful match of the business name. |
match_ | Unsuccessful match due to a business name discrepancy. |
Tester la vérification du libellé d'instruction
Trigger statement descriptor verification for an Account object by using this token for the settings.payments.statement_descriptor attribute.
| Jeton | Type |
|---|---|
mismatch | Déclencher une erreur de vérification invalid_ . |
disallowed | Déclencher une erreur de vérification invalid_ . |
Trigger statement descriptor prefix verification for an Account object by using this token for the settings.card_payments.statement_descriptor_prefix attribute.
| Jeton | Type |
|---|---|
mismatch | Déclencher une erreur de vérification invalid_ . |
disallowed | Déclencher une erreur de vérification invalid_ . |
Tester la vérification de l'URL de l'entreprise
Trigger URL verification for an Account object by using this token for the business_profile.url attribute.
| Jeton | Type |
|---|---|
https://disallowed. | Déclencher une erreur de vérification invalid_ . |
https://geoblocked. | Déclenchez une erreur de vérification invalid_. |
https://problem. | Déclencher une erreur de vérification invalid_ . |
https://missing. | Déclencher une erreur de vérification invalid_ . |
https://mismatch. | Déclencher une erreur de vérification invalid_ . |
https://passwordprotected. | Déclenchez une erreur de vérification invalid_. |
https://accessible. | Trigger a successful validation of the URL. |
https://underconstruction. | Déclenchez une erreur de vérification invalid_. |
https://inaccessible. | Déclencher une erreur de vérification invalid_ . |
Tester la fonctionnalité des motifs de désactivation
Trigger assignment of a specific requirements.disabled_reason to all of an Account object’s inactive Capability objects by using this token for the account’s business_profile.url attribute.
| Jeton | Type |
|---|---|
https://inactivity. | Set an account 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). |
Tester la vérification Doing Entreprise As (Nom commercial)
Trigger DBA verification for an Account object by using this token for the business_profile.name attribute.
| Jeton | Type |
|---|---|
disallowed_ | Déclencher une erreur de vérification invalid_ . |
invalid_ | Déclencher une erreur de vérification invalid_ . |
Test product description verification
Trigger product description verification for an Account object by using this token for the business_profile.product_description attribute.
| Jeton | Type |
|---|---|
require_ | Déclencher une erreur de vérification invalid_ . |
Tester la validation du numéro de téléphone
Clear phone number validation for an Account object by using this token for the following attributes:
Clear phone number validation for a Person object by using this token for the phone attribute.
| Jeton | Type |
|---|---|
0000000000 | Validation réussie |
Trigger or advance verification
Déclencher des cartes
Use these card numbers to trigger various conditions when you’re testing both requirements and tiered verification. For the trigger actions to work, you must use these cards with a Connect charge by setting on_behalf_of or creating a direct charge on the connected account. The connected account must have an eventually_due requirement.
| Numéro | Jeton | Type |
|---|---|---|
| 4000000000004202 | tok_ | Modifie l’ensemble suivant d’exigences potentiellement attendues en exigences actuellement attendues. |
| 4000000000004210 | tok_ | Déclenche un bloc de paiement. |
| 4000000000004236 | tok_ | Déclenche un bloc de virement. |
Trigger next requirements
Live mode can require additional verification information when a connected account processes a certain amount of volume. This card sets any additional verification information to be required immediately. If no additional information is required, nothing appears.
Trigger a charge or payout block
If required information isn’t provided by the deadline, Stripe disables the connected account’s charges or payouts. These cards disable the connected account and move any currently due requirements to overdue. These cards have no effect until an account provides the initial information that’s required to enable charges and payouts.
Trigger bank account ownership verification
Connected accounts in the United States and India are subject to Bank account ownership verification. You can complete this verification by uploading supporting documents with the Connect Dashboard or with the API through the documents[bank_account_ownership_verification] hash.
While you’re testing, you can simulate the US bank account ownership verification process. Use the following test bank account numbers to trigger the verification process. One number presumes successful verification and the other prompts you to upload test images or file tokens to complete the verification process. These test accounts are only available for US accounts.
| Acheminement | Compte | Type |
|---|---|---|
11000000 | 000999999991 | Déclenche le processus de vérification de la propriété du compte bancaire et le finalise après un bref délai |
11000000 | 000999999992 | Déclenche le processus de vérification de la propriété du compte bancaire après un court délai et demande le téléversement de documents. |
Ajouter des fonds au solde Stripe
To test adding funds to your Stripe balance from a bank account in the Dashboard, create a sandbox and select the desired test bank account in the dropdown menu within the Add to balance dialog. You can simulate success or failure due to insufficient funds.
To test adding funds in the API, use the following test bank tokens as the source while you’re testing. Each token simulates a specific kind of event.
| Jeton | Type |
|---|---|
btok_ | Réussis |
btok_ | Échec avec le code no_ |
btok_ | Échec avec le code account_ |
btok_ | Échec avec le code insufficient_ |
btok_ | Échec avec le code debit_ |
btok_ | Échec avec le code invalid_ |
Virements
Utilisez les numéros de carte bancaire et de carte de débit suivants pour déclencher certains événements pendant les tests des virements. Vous ne pouvez utiliser ces valeurs que lors de tests avec des clés API secrètes de test.
Les versements tests simulent un versement réel, mais ne sont pas traités par la banque. Les comptes tests disposant d’un accès au Dashboard Stripe ont toujours les versements activés, à condition que les informations bancaires externes soient valides et que les autres conditions requises soient remplies. Ils ne nécessitent jamais de vérification d’identité réelle.
Remarque
Vous ne pouvez pas utiliser les numéros de carte bancaire et de carte de débit dans le Dashboard Stripe sur un compte connecté en mode production. Si vous avez saisi vos informations bancaires sur un compte en mode production, vous pouvez toujours utiliser un bac à sable, et les versements tests simuleront un versement réel sans traiter des fonds réels.
Numéros de compte bancaire
Utilisez ces numéros de compte bancaire pour tester les virements. Vous ne pouvez les utiliser qu’avec des clés API de test.
Numéros de carte de débit
Utilisez ces numéros de carte de débit pour tester les virements vers une carte de débit. Vous ne pouvez les utiliser qu’avec des clés API de test.