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 com diferentes tipos de conta ou propriedades de controlador que desejar testar.
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
Use o seu client_
de teste para testar sua integração do OAuth com contas conectadas que usam um Dashboard hospedado pela Stripe.
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 | Correspondência bem-sucedida de data de nascimento. Todas as outras datas de nascimento resultam em uma não correspondência. |
1902-01-01 | Correspondência bem-sucedida e imediata da data de nascimento. 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_ | Correspondência de endereço bem-sucedida. |
address_ | Correspondência de endereço imediata e bem-sucedida. |
address_ | Endereço malsucedido corresponde com probabilidade de acionar requisitos em currently_ . |
address_ | Correspondência malsucedida de endereço com probabilidade de acionar requisitos em currently_ |
Testar números de ID pessoal
Use estes números de identificação pessoal no atributo individual.id_number em Account
ou no atributo id_number no objeto Person
para acionar determinadas condições de verificação.
Número | Tipo |
---|---|
000000000 | Correspondência bem-sucedida do número de identificação. 0000 também funciona para a verificação dos 4 últimos SSN. |
111111111 | Correspondência malsucedida de número de identificação (identidade incorreta) pode acionar requisitos em currently_ . |
222222222 | Correspondência bem-sucedida e imediata de número de ID. 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 número de identificação corresponda. Você pode usar uma imagem não verificada que cause uma incompatibilidade no número de identificação, levando a requisitos de currently_
.
Observação
As imagens de teste têm precedência sobre os números de ID de teste. Se você carregar uma imagem verificada, a correspondência do número de identificaçã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 falha automaticamente na correspondência de ID, 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 ocorre 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 requirements. |
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 requirements. |
Testar identificações fiscais de empresas
Use estes números de ID fiscal de empresa em 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 ID fiscal verificado nesses países.
Número | Tipo |
---|---|
000000000 | Correspondência bem-sucedida do número de identificação da empresa. |
000000001 | Correspondência bem-sucedida do número de identificação da empresa como organização sem fins lucrativos. |
111111111 | Correspondência malsucedida do número de identificação da empresa (identidade incorreta). |
111111112 | Correspondência malsucedida do número da empresa (ID fiscal não emitido). |
222222222 | Correspondência bem-sucedida e imediata do número de identificação da empresa. 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 no objeto Account
com uma lista recuperada de registros locais. Se o país exigir, você pode acionar a verificação para um objeto Account
usando esses tokens para o atributo first_name na Person
associada e definindo o atributo relationship.director na Person
como true.
Token | Tipo |
---|---|
mismatch_ | Correspondência malsucedida devido a nome incorreto. Isso pode acionar um erro de verificação verification_ . |
missing_ | Correspondência malsucedida devido à falta de diretores na conta. Isso pode acionar um erro de verificação verification_ . |
extraneous_ | Correspondência 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_ | Correspondência malsucedida devido a nome incorreto da empresa. |
disallowed_ | Correspondência malsucedida devido ao nome genérico ou amplamente conhecido da empresa. |
match_ | Correspondência bem-sucedida do nome da empresa. |
match_ | Correspondência malsucedida devido a 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. | Acione 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. | Acione um erro de verificação invalid_ . |
https://accessible. | Acionar uma validação bem-sucedida do URL. |
https://underconstruction. | Acione 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 nome fantasia para um objeto Account
usando este token para o atributo business_profile.name.
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 este 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 este 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 específico 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 como inativa e suspenda todas as verificações para ela. Defina o motivo da desativação de funções inativas como paused. (rejected. para API versões 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 necessários não forem fornecidos dentro do prazo, a Stripe desabilitará as cobranças ou repasses da conta conectada. Estes cartões desabilitam a conta conectada e alteram o estado de todos os requisitos pendentes para em atraso. Estes 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 à verificação de titularidade da conta bancária. Para concluir essa verificação, carregue documentos de comprovação no Connect Dashboard ou na API por meio de documents[bank_account_ownership_verification] hash.
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 |
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.