Pruebas de Stripe Connect

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.

Crea cuentas de prueba

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.

Use 000-000 as the SMS code when prompted for test accounts.

Test the OAuth flow

You can test your OAuth integration with connected accounts that use a Stripe-hosted Dashboard using your test client_id.

Your test client_id is ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb. You can find this in your Connect OAuth settings.

Your test client_id allows you to:

• Definir tu redirect_uri en una URL que no es HTTPS
• Definiri tu redirect_uri en localhost
• Force-skip the account form instead of having to fill out an entire account application (Stripe Dashboard accounts only)
• Obtén tokens de acceso de prueba para cuentas conectadas

To test the OAuth flow, create a new account after clicking the OAuth link. You can also test connecting an existing Stripe account only if the email is different from your platform account.

Identity verification

After creating a test connected account, you can use tokens to test different verification statuses to make sure you’re handling different requirements and account states. You can use the following tokens to test verification with test accounts.

Prueba de fechas de nacimiento

Usa estas fechas de nacimiento para activar ciertas condiciones de verificación.

Prueba de direcciones

Usa esta direcciones para line1 para activar las condiciones de ciertas verificaciones. Debes especificar valores legítimos para los argumentos city, state y postal_code.

Prueba de números de ID personales

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.

Test government-issued ID documents

For testing, use test images or file tokens instead of uploading your own test IDs. For details, refer to Uploading a file.

Prueba de imágenes de documentos

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_due requirements.

Prueba de tokens de archivo

Usa estos tokens de archivo para activar ciertas condiciones de verificación de identidad.

Business information verification

Validación de la dirección comercial

En algunos países, la dirección comercial asociada con tu cuenta conectada debe validarse antes de que se habiliten los cargos, las transferencias o ambos en la cuenta conectada.

Prueba de direcciones comerciales

Usa esta direcciones para line1 para activar las condiciones de ciertas verificaciones. Debes especificar valores legítimos para los argumentos city, state y postal_code.

Make sure you start with an address token that has the least permissive validation condition you want to test for. This is because you can’t use an address token that has a more restrictive validation condition than the previous token used. For example, if you provided address_full_match to have both charges and payouts enabled, you can’t disable payouts or charges afterward by changing the token to an invalid one. You can work around this by creating a new account with the relevant token.

Prueba de las ID fiscales de la empresa

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.

Test directorship verification

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.

The verification errors can trigger if multiple directors on the Account object use these magic tokens.

Test company name verification

Trigger company name verification for an Account object by using this token for the company.name attribute.

Test statement descriptor verification

Trigger statement descriptor verification for an Account object by using this token for the settings.payments.statement_descriptor attribute.

Trigger statement descriptor prefix verification for an Account object by using this token for the settings.card_payments.statement_descriptor_prefix attribute.

Test business URL verification

Trigger URL verification for an Account object by using this token for the business_profile.url attribute.

Test capability disabled reasons

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.

Test Doing Business As (DBA) verification

Trigger DBA verification for an Account object by using this token for the business_profile.name attribute.

Test product description verification

Trigger product description verification for an Account object by using this token for the business_profile.product_description attribute.

Test phone number validation

Clear phone number validation for an Account object by using this token for the following attributes:

• business_profile.support_phone
• company.phone
• individual.phone

Clear phone number validation for a Person object by using this token for the phone attribute.

Trigger or advance verification

Activar tarjetas

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.

Trigger next requirements

El modo activo puede exigir información de verificación adicional cuando una cuenta conectada procesa un determinado volumen. Esta tarjeta establece la información de verificación adicional que se debe solicitar de inmediato. Si no se requiere información adicional, no aparece nada.

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.

Agregar fondos al saldo de 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.

Transferencias

Utiliza los siguientes números de tarjetas de débito y de banco de pruebas para activar determinados eventos al probar las transferencias. Solo puedes utilizar estos valores mientras realizas pruebas con claves API de prueba.

Las transferencias de prueba simulan un pago real, pero no se procesan con el banco. Las cuentas de prueba con acceso al Dashboard de Stripe siempre tienen habilitadas las transferencias, mientras se cumplan los requisitos de información bancaria externa válida y otras condiciones relevantes, y nunca requieren verificación de identidad real.

Números de bancos

Utiliza estos números de cuenta bancaria de prueba para probar transferencias. Solo puedes utilizarlos con claves API de prueba.

Números de tarjetas de débito

Utiliza estos números de tarjetas de débito de prueba para probar transferencias a una tarjeta de débito. Solo puedes usarlos con las claves API de prueba.