Testar o Stripe Connect
Antes de entrar no modo de produção, teste a criação de contas, a verificação de identidade e os repasses na integração do Connect.
Use os testes para garantir que a integração do Connect gerencie corretamente os diversos fluxos. Você pode usar Áreas restritas para simular o modo de produção enquanto aproveita os tokens especiais fornecidos pela Stripe para usar em seus testes. Consulte o guia de testes de pagamento para obter mais informações sobre como testar cobranças, contestações e muito mais.
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 a integração do OAuth com contas conectadas que usam um dashboard hospedado pela Stripe usando o seu client_
de teste.
Seu client_
de teste é ca_
. Essa opção pode ser encontrada nas configurações de OAuth do Connect.
O seu client_
de teste permite que você:
- Definir seu
redirect_
como um URL não HTTPSuri - Definir seu
redirect_
como localhosturi - 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_
.
Token | Tipo |
---|---|
address_ | Verificação bem-sucedida. |
address_ | Verificação malsucedida. |
address_ | 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 imagens de teste ou tokens de arquivos em vez de carregar seus próprios IDs de teste. Para saber mais, consulte Carregar um arquivo.
Testar imagens do documento
Você pode usar uma imagem de verificação bem-sucedida para que o usuário seja marcado automaticamente como verified
, ou usar uma imagem de verificação malsucedida para que ele seja marcado como unverified
.
Observação
As imagens de teste têm prioridade sobre os números de ID de teste. Se você carregar uma imagem verificada, a verificação será bem-sucedida, mesmo que você também informe um valor de ID de teste malsucedido. Da mesma forma, uma imagem não verificada é automaticamente recusada na verificação, independentemente do valor de outros objetos de teste.
Testar tokens de arquivo
Use estes tokens de arquivo para acionar determinadas condições de verificação de identidade.
Token | Tipo |
---|---|
file_ | Usa a imagem de verificação bem-sucedida e marca o requisito de documento como cumprido. |
file_ | 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_
.
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_
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_ | Cobranças e repasses estão habilitados na conta. |
address_ | 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_ | 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 estes números de ID fiscal para a company.tax_id para acionar determinadas condições de verificação. O comportamento de teste pode mudar dependendo dos países das contas conectadas e dos regulamentos nesses países. Dependendo da regulamentação do país, um documento fiscal válido pode marcar o código fiscal verificado nesses países.
Número | Tipo |
---|---|
000000000 | Verificação bem-sucedida. |
000000001 | Verificação bem-sucedida como organização sem fins lucrativos. |
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
A Stripe executa a verificação de status de diretoria ao comparar a lista de diretores do objeto Account
com uma lista recuperada dos registros locais. Se o país exigir, você pode acionar a verificação para um objeto Account
usando esses tokens para o atributo person.first_name e definindo o atributo person.relationship.director como verdadeiro.
Token | Tipo |
---|---|
mismatch_ | Verificação malsucedida do diretor devido a um nome incorreto. Isso pode acionar um erro de verificação verification_ . |
missing_ | Verificação malsucedida devido à falta de diretores na conta. Isso pode acionar um erro de verificação verification_ . |
extraneous_ | Verificação malsucedida devido a excesso de diretores na conta. Isso pode acionar um erro de verificação verification_ . |
Os erros de verificação podem ser acionados se vários diretores no objeto Account
usarem esses tokens mágicos.
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_ | Verificação malsucedida devido a nome incorreto da empresa. |
disallowed_ | Verificação malsucedida devido ao nome genérico ou amplamente conhecido da empresa. |
match_ | Verificação bem-sucedida do nome da empresa. |
match_ | 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_ . |
disallowed | Acionar um erro de verificação invalid_ . |
Acione a verificação do prefixo da descrição no extrato para um objeto Account
usando esse token para o atributo settings.card_payments.statement_descriptor_prefix
Token | Tipo |
---|---|
mismatch | Acionar um erro de verificação invalid_ . |
disallowed | Acionar um erro de verificação invalid_ . |
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. | Acionar um erro de verificação invalid_ . |
https://geoblocked. | Aciona um erro de verificação invalid_ . |
https://problem. | Acionar um erro de verificação invalid_ . |
https://missing. | Acionar um erro de verificação invalid_ . |
https://mismatch. | Acionar um erro de verificação invalid_ . |
https://passwordprotected. | Aciona um erro de verificação invalid_ . |
https://accessible. | Acionar uma validação bem-sucedida do URL. |
https://underconstruction. | Aciona um erro de verificação invalid_ . |
https://inaccessible. | Acionar um erro de verificação invalid_ . |
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_ | Acionar um erro de verificação invalid_ . |
invalid_ | Acionar um erro de verificação invalid_ . |
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_ | Acionar um erro de verificação invalid_ . |
Testar validação de número de telefone
Limpe a validação de número de telefone para um objeto Account usando esse token para os seguintes atributos:
Limpe a validação de número de telefone para um objeto Person usando esse token para o atributo phone.
Token | Tipo |
---|---|
0000000000 | Validação bem-sucedida |
Motivos da desativação da função de teste
Acione a atribuição de um requirements.disabled_reason a todos os objetos Capability
inativos de um objeto Account
usando esse token para o atributo business_profile.url da conta.
Token | Tipo |
---|---|
https://inactivity. | Defina uma conta sem atividade recente como inativa e suspenda todas as verificações dela. Defina o motivo da desativação de qualquer função inativa como paused. (rejected. para versões da API anteriores a 2024-06-20 ). |
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_ | Altera o próximo conjunto de requisitos com prazo futuro para defini-lo em atraso. |
4000000000004210 | tok_ | Aciona um bloqueio de cobrança. |
4000000000004236 | tok_ | 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].
Durante os testes, você pode simular o processo de verificação de propriedade de contas bancárias dos EUA. Use os números de conta bancária 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 | 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. |
---|---|---|
Data de nascimento e endereço verificados | Verificada | Nenhum |
Data de nascimento verificada e endereço não verificado | Não verificada | verification. |
Data de nascimento não verificada e endereço verificado | Não verificada | verification. |
Data de nascimento e endereço não verificados | Não verificada | verification. , verification. |
Adicionar fundos ao saldo da Stripe
Para testar a adição de fundos de uma conta bancária no saldo da Stripe no Dashboard, crie uma área restrita 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 os tokens de banco de teste a seguir como origem durante o teste. Cada token simula um tipo específico de evento.
Token | Tipo |
---|---|
btok_ | Bem-sucedido |
btok_ | Malsucedida com código no_ |
btok_ | Malsucedida com código account_ |
btok_ | Malsucedida com código insufficient_ |
btok_ | Malsucedida com código debit_ |
btok_ | Malsucedida com código invalid_ |
Repasses
Use os seguintes 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 durante o teste com chaves secretas de teste.
Os repasses de teste simulam um repasse no modo de produção, mas não são processados no banco. Contas de teste com acesso ao Dashboard Stripe sempre têm repasses habilitados, 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 em modo de produção. Se você inseriu os dados da sua conta bancária em uma conta no modo de produção, ainda pode usar uma área restrita, e os repasses de teste simularão um repasse no modo de produção 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.