Testar o Stripe Connect
Use os testes para garantir que a integração do Connect gerencie corretamente os diversos fluxos. Use o modo de teste para simular o modo de produção usando os tokens especiais fornecidos pela Stripe. Consulte o guia de testes de pagamento para saber mais sobre como testar cobranças, contestações e assim por diante.
Criar contas de teste
Você pode criar várias contas de teste e usar qualquer tipo de conta ou propriedades de controlador que possam ser necessárias (por exemplo, representando vários países).
Você pode criar contas de teste usando a API Accounts ou no Stripe Dashboard.
Use 000-000
como o código SMS quando solicitado para contas de teste.
Testar o fluxo do OAuth
Você pode testar sua integração do OAuth com contas conectadas que usam um Dashboard hospedado pela Stripe utilizando seu client_id
do modo de teste.
Seu client_id
do modo de teste é ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb
. Esse recurso está disponível nas configurações do Connect OAuth.
Seu client_id
do modo de teste permite:
- Definir seu
redirect_uri
como um URL não HTTPS - Definir seu
redirect_uri
como localhost - Ignorar o formulário de conta em vez de preencher um pedido de abertura de conta completo (somente contas Stripe Dashboard)
- Obter tokens de acesso de teste para contas conectadas
Para testar o fluxo do OAuth, crie uma conta depois de clicar no link do OAuth. Também é possível testar a conexão de uma conta Stripe existente (somente se o e-mail for diferente da conta da sua plataforma).
Verificação de identidade
Depois de criar uma conta conectada de teste, você pode usar tokens para testar diversos status de verificação e garantir que está processando os diferentes requisitos e estados da conta. Os tokens a seguir podem ser usados para testar a verificação em contas de teste.
Testar datas de nascimento
Use estas datas de nascimento para acionar determinadas condições de verificação.
Data de nascimento | Tipo |
---|---|
1901-01-01 | Verificação bem-sucedida. Todas as outras datas de nascimento falham na verificação. |
1902-01-01 | Verificação bem-sucedida e imediata. O resultado da verificação é devolvido diretamente na resposta e não como parte de um evento de webhook. |
1900-01-01 | Esta data de nascimento aciona um alerta da Agência de Controle de Ativos Estrangeiros (OFAC). |
Testar endereços
Use estes endereços no argumento line1
para acionar determinadas condições de verificação. Você deve informar valores legítimos para os argumentos city
, state
e postal_code
.
Token | Tipo |
---|---|
address_full_match | Verificação bem-sucedida. |
address_no_match | Verificação malsucedida. |
address_line1_no_match | Verificação malsucedida de correspondência parcial de endereço. |
Testar números de ID pessoal
Use estes números de identificação pessoal no atributo individual.id_number ou id_number do objeto Person
para acionar determinadas condições de verificação.
Número | Tipo |
---|---|
000000000 | Verificação bem-sucedida. 0000 também funciona para a verificação dos últimos 4 SSN. |
111111111 | Verificação malsucedida (identidade incorreta). |
222222222 | Verificação bem-sucedida e imediata. O resultado da verificação é devolvido diretamente na resposta e não como parte de um evento de webhook. |
Testar documentos de identidade
Para testar, use tokens de arquivos em vez de carregar seus próprios IDs de teste. Para saber mais, consulte Carregar um arquivo.
Testar tokens de arquivo
Use estes tokens de arquivo para acionar determinadas condições de verificação de identidade.
Token | Tipo |
---|---|
file_identity_document_success | Usa a imagem de verificação bem-sucedida e marca o requisito de documento como cumprido. |
file_identity_document_failure | Usa a imagem de verificação malsucedida e marca o requisito de documento como não cumprido. |
Verificação de dados comerciais
Validação de endereço comercial
Em alguns países, o endereço comercial associado a uma conta conectada deve ser validado antes da habilitação de cobranças, repasses ou ambos na conta conectada.
Testar endereços comerciais
Use estes endereços no argumento line1
para acionar determinadas condições de validação. Você deve informar valores legítimos para os argumentos city
, state
e postal_code
.
Comece usando um token de endereço com a condição de validação menos permissiva que você quer testar. Isso é necessário porque não é possível usar um token de endereço com condição de validação mais restritiva que o token anterior. Por exemplo, se você especificou address_full_match
para habilitar cobranças e repasses, não pode desabilitá-las depois substituindo o token por um inválido. Essa situação pode ser contornada criando uma conta com o token relevante.
Token | Tipo |
---|---|
address_full_match | Cobranças e repasses estão habilitados na conta. |
address_no_match | Somente cobranças estão habilitadas na conta. Como a validação falhou no atributo line1 , ela é incluída novamente no hash de requisitos. |
address_line1_no_match | Cobranças e repasses não estão habilitados na conta. Como a validação falhou, os atributos de endereço são incluídos novamente no hash de requisitos. |
Testar identificações fiscais de empresas
Use estas identificações fiscais de empresa em company.tax_id para acionar determinadas condições de verificação.
Número | Tipo |
---|---|
000000000 | Verificação bem-sucedida. |
000000001 | Verificação bem-sucedida como organização sem fins lucrativos. |
100000002 | Verificação bem-sucedida como instituição de caridade registrada no Canadá. |
111111111 | Verificação malsucedida (identidade incorreta). |
111111112 | Verificação malsucedida (ID fiscal não emitido). |
222222222 | Verificação bem-sucedida e imediata. O resultado da verificação é devolvido diretamente na resposta e não como parte de um evento de webhook. |
Testar verificação de status de diretoria (somente no Canadá)
Acione a verificação de diretor para um objeto Account
usando este token para o atributo individual.first_name. e configurando o atributo individual.relationship.director como verdadeiro.
Token | Tipo |
---|---|
mismatch_director | Verificação malsucedida deste diretor. |
Teste a verificação do nome da empresa
Acione a verificação do nome da empresa para um objeto Account
usando este token para o atributo company.name.
Token | Tipo |
---|---|
mismatch_business_name | Verificação malsucedida devido a nome incorreto da empresa. |
disallowed_name | Verificação malsucedida devido ao nome genérico ou amplamente conhecido da empresa. |
match_name_relationships | Verificação bem-sucedida do nome da empresa. |
match_name_only | Verificação malsucedida devido à discrepância no nome da empresa. |
Verificação da descrição do extrato de teste
Acione a verificação da descrição no extrato para um objeto Account
usando esse token para o atributo settings.payments.statement_descriptor.
Token | Tipo |
---|---|
mismatch | Acionar um erro de verificação invalid_statement_descriptor_business_mismatch . |
disallowed | Acionar um erro de verificação invalid_statement_descriptor_denylisted . |
Acione a verificação da descrição do prefixo no extrato para um objeto Account
usando esse token para o atributo settings.payments.statement_descriptor_prefix.
Token | Tipo |
---|---|
mismatch | Acionar um erro de verificação invalid_statement_descriptor_prefix_mismatch . |
disallowed | Acionar um erro de verificação invalid_statement_descriptor_prefix_denylisted . |
Testar verificação de URL da empresa
Acione a verificação de URL para um objeto Account
usando esse token para o atributo business_profile.url.
Token | Tipo |
---|---|
https://disallowed.stripe.com | Acionar um erro de verificação invalid_url_denylisted . |
https://problem.stripe.com | Acionar um erro de verificação invalid_url_website_other . |
https://missing.stripe.com | Acionar um erro de verificação invalid_url_website_incomplete . |
https://mismatch.stripe.com | Acionar um erro de verificação invalid_url_website_business_information_mismatch . |
https://accessible.stripe.com | Acionar uma validação bem-sucedida do URL. |
https://inaccessible.stripe.com | Acionar um erro de verificação invalid_url_website_inaccessible . |
Teste a verificação do nome fantasia (DBA)
Acione a verificação de DBA para um objeto Account
usando esse token para o atributo business_profile.namel.
Token | Tipo |
---|---|
disallowed_dba | Acionar um erro de verificação invalid_business_profile_name_denylisted . |
invalid_dba | Acionar um erro de verificação invalid_business_profile_name . |
Verificação da descrição do produto de teste
Acione a verificação de descrição de produto para um objeto Account
usando esse token para o atributo business_profile.product_description.
Token | Tipo |
---|---|
require_url | Acionar um erro de verificação invalid_url_web_presence_detected . |
Acionar ou antecipar verificação
Cartões de acionamento
Use estes números de cartão para acionar várias condições nos testes de requisitos e de verificação em camadas. Para que os acionamentos funcionem, use esses cartões com uma cobrança do Connect definindo on_behalf_of
ou criando a cobrança diretamente na conta conectada.
Número | Token | Tipo |
---|---|---|
4000000000004202 | tok_visa_triggerNextRequirements | Altera o próximo conjunto de requisitos com prazo futuro para defini-lo em atraso. |
4000000000004210 | tok_visa_triggerChargeBlock | Aciona um bloqueio de cobrança. |
4000000000004236 | tok_visa_triggerPayoutBlock | Aciona um bloqueio de repasse. |
Acionar próximos requisitos
O modo de produção pode exigir dados de verificação adicionais quando uma conta conectada processa um determinado volume. Este cartão define que todos os dados de verificação adicionais são exigidos imediatamente. Se nenhum dado adicional é necessário, nada é exibido.
Acionar bloqueio de cobrança ou repasse
Se os dados adicionais não são fornecidos dentro do prazo, a Stripe desabilita as cobranças ou repasses da conta conectada. Os cartões desabilitam a conta conectada e alteram o estado de todos os requisitos pendentes para em atraso. Os cartões não têm efeito até que uma conta forneça os dados iniciais necessários para habilitar cobranças e repasses.
Acionar verificação de titularidade da conta bancária
Contas conectadas nos Estados Unidos e na Índia estão sujeitas a verificação de titularidade da conta bancária. Essa verificação pode ser realizada carregando documentos de comprovação no Dashboard ou na API do Connect, com o hash documents[bank_account_ownership_verification].
No modo de teste, você pode simular o processo de verificação de propriedade de contas bancárias dos EUA. Use os números de contas bancárias de teste abaixo para acionar o processo de verificação. Um número presume que a verificação foi bem-sucedida e o outro solicita que você carregue imagens de teste ou tokens de arquivo para concluir o processo de verificação. Estas contas de teste só estão disponíveis para contas dos EUA.
Routing | Conta | Tipo |
---|---|---|
110000000 | 000999999991 | Aciona e conclui o processo de verificação de propriedade de conta bancária após uma breve espera |
110000000 | 000999999992 | Beta Aciona o processo de verificação de propriedade de conta bancária após uma breve espera e solicita o envio de documento |
Simular requisitos
Se sua plataforma tem (ou pretende ter) contas conectadas em países diferentes, pode ser necessário verificar o endereço e a identidade de uma pessoa (dependendo do país). A Stripe oferece exemplos de data de nascimento (DOB) e endereços para testar esse requisito.
Dados fornecidos | Status de verificação da pessoa | requirements.currently_due |
---|---|---|
Data de nascimento e endereço verificados | Verificada | Nenhum |
Data de nascimento verificada e endereço não verificado | Não verificada | verification.additional_document |
Data de nascimento não verificada e endereço verificado | Não verificada | verification.document |
Data de nascimento e endereço não verificados | Não verificada | verification.additional_document , verification.document |
Adicionar fundos ao saldo da Stripe
Para testar a adição de fundos de uma conta bancária ao saldo da Stripe no Dashboard, habilite o modo de teste e selecione a conta bancária de teste desejada no menu suspenso do diálogo Adicionar ao saldo. Você pode simular sucesso ou falha por fundos insuficientes.
Para testar a adição de fundos na API, use estes tokens de banco de teste como origem no modo de teste. Cada token simula um tipo específico de evento.
Token | Tipo |
---|---|
btok_us_verified | Bem-sucedido |
btok_us_verified_noAccount | Malsucedida com código no_account |
btok_us_verified_accountClosed | Malsucedida com código account_closed |
btok_us_verified_insufficientFunds | Malsucedida com código insufficient_funds |
btok_us_verified_debitNotAuthorized | Malsucedida com código debit_not_authorized |
btok_us_verified_invalidCurrency | Malsucedida com código invalid_currency |
Repasses
Use estes números de banco e cartão de débito de teste para acionar determinados eventos durantes os testes de repasse. Você só pode usar esses valores no modo de teste com chaves secretas de teste.
Os repasses no modo de teste simulam um repasse no modo de produção, mas não são processados no banco. Contas em modo de teste com acesso ao Stripe Dashboard sempre têm repasses ativados (desde que usem dados bancários externos válidos e cumpram outras condições relevantes) e nunca exigem uma verificação de identidade real.
Observação
Não é possível usar números de banco e cartão de débito de teste no Stripe Dashboard em uma conta conectada no modo de produção. Se você inseriu os dados da sua conta bancária em uma conta em modo de produção, ainda é possível usar o modo de teste. Os repasses do modo de teste simulam um repasse de tempo real sem processar dinheiro real.
Números de banco
Use estes números de conta bancária de teste para testar repasses. Eles só podem ser usados com chaves secretas de teste.
Números de cartão de débito
Use estes números de cartão de débito para testar repasses para um cartão de débito. Eles só podem ser usados com chaves secretas de teste.