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. 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_
do modo de teste.
Seu client_
do modo de teste é ca_
. Esse recurso está disponível nas configurações do Connect OAuth.
Seu client_
do modo de teste permite:
- 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 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_ . |
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_ . |
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].
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 | Triggers the bank account ownership verification process after a short delay and requests for document upload |
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 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_ | 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 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.