Pular para o conteúdo
Criar conta
ou
Entrar
O logotipo da documentação da Stripe
/
Pergunte à IA
Criar conta
Login
Comece já
Pagamentos
Receita
Plataformas e marketplaces
Gestão de valores
Recursos para desenvolvedores
Visão geral
Comece a usar o Connect
Princípios básicos de integração
    Fazer chamadas de API para contas conectadas
    Recomendações de integração
    Escutar atualizações
    Testes
    Visão geral da API Accounts v2
Exemplos de integrações
Gerenciamento de contas
Fazer onboarding de contas
Configurar Dashboards da conta
Trabalhe com tipos de contas conectadas
Processamento de pagamentos
Receba pagamentos
Repassar para contas
Administração de plataforma
Gerencie sua plataforma do Connect
Informes fiscais para sua plataforma Connect
Página inicialPlataformas e marketplacesIntegration fundamentals

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_id de teste para testar sua integração do OAuth com contas conectadas que usam um Dashboard hospedado pela Stripe.

Seu client_id de teste é ca_FkyHCg7X8mlvCUdMDao4mMxagUfhIwXb. Essa opção pode ser encontrada nas configurações de OAuth do Connect.

O seu client_id de teste permite que você:

  • 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

Guia de verificação de testes

A verificação é um componente crucial para o onboarding de contas. Use o nosso guia dedicado para testes de verificação.

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 nascimentoTipo
1901-01-01Correspondência bem-sucedida de data de nascimento. Todas as outras datas de nascimento resultam em uma não correspondência.
1902-01-01Correspondê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-01Esta 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.

TokenTipo
address_full_match​Correspondência de endereço bem-sucedida.
address_full_match_sync​Correspondência de endereço imediata e bem-sucedida.
address_no_matchEndereço malsucedido corresponde com probabilidade de acionar requisitos em currently_due.
address_line1_no_matchCorrespondência malsucedida de endereço com probabilidade de acionar requisitos em currently_due

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úmeroTipo
000000000Correspondência bem-sucedida do número de identificação. 0000 também funciona para a verificação dos 4 últimos SSN.
111111111Correspondência malsucedida de número de identificação (identidade incorreta) pode acionar requisitos em currently_due.
222222222Correspondê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_due.

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.

TokenTipo
file_identity_document_successUsa a imagem de verificação bem-sucedida e marca o requisito de documento como cumprido.
file_identity_document_failureUsa 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 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_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.

TokenTipo
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 requirements.
address_line1_no_matchCobranç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úmeroTipo
000000000Correspondência bem-sucedida do número de identificação da empresa.
000000001Correspondência bem-sucedida do número de identificação da empresa como organização sem fins lucrativos.
111111111Correspondência malsucedida do número de identificação da empresa (identidade incorreta).
111111112Correspondência malsucedida do número da empresa (ID fiscal não emitido).
222222222Correspondê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.

TokenTipo
mismatch_directorCorrespondência malsucedida devido a nome incorreto. Isso pode acionar um erro de verificação verification_directors_mismatch.
missing_directorCorrespondência malsucedida devido à falta de diretores na conta. Isso pode acionar um erro de verificação verification_missing_directors.
extraneous_directorCorrespondência malsucedida devido a excesso de diretores na conta. Isso pode acionar um erro de verificação verification_extraneous_directors.

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.

TokenTipo
mismatch_business_nameCorrespondência malsucedida devido a nome incorreto da empresa.
disallowed_nameCorrespondência malsucedida devido ao nome genérico ou amplamente conhecido da empresa.
match_name_relationshipsCorrespondência bem-sucedida do nome da empresa.
match_name_onlyCorrespondê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.

TokenTipo
mismatchAcionar um erro de verificação invalid_statement_descriptor_business_mismatch.
disallowedAcionar um erro de verificação invalid_statement_descriptor_denylisted.

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.

TokenTipo
mismatchAcionar um erro de verificação invalid_statement_descriptor_prefix_mismatch.
disallowedAcionar 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.

TokenTipo
https://disallowed.stripe.comAcionar um erro de verificação invalid_url_denylisted.
https://geoblocked.stripe.comAcione um erro de verificação invalid_url_website_inaccessible_geoblocked.
https://problem.stripe.comAcionar um erro de verificação invalid_url_website_other.
https://missing.stripe.comAcionar um erro de verificação invalid_url_website_incomplete.
https://mismatch.stripe.comAcionar um erro de verificação invalid_url_website_business_information_mismatch.
https://passwordprotected.stripe.comAcione um erro de verificação invalid_url_website_inaccessible_password_protected.
https://accessible.stripe.comAcionar uma validação bem-sucedida do URL.
https://underconstruction.stripe.comAcione um erro de verificação invalid_url_website_incomplete_under_construction.
https://inaccessible.stripe.comAcionar um erro de verificação invalid_url_website_inaccessible.

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.

TokenTipo
disallowed_dbaAcionar um erro de verificação invalid_business_profile_name_denylisted.
invalid_dbaAcionar 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 este token para o atributo business_profile.product_description.

TokenTipo
require_urlAcionar um erro de verificação invalid_url_web_presence_detected.

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:

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

Limpe a validação de número de telefone para um objeto Person usando este token para o atributo phone.

TokenTipo
0000000000Validaçã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.

TokenTipo
https://inactivity.stripe.comDefina uma conta como inativa e suspenda todas as verificações para ela. Defina o motivo da desativação de funções inativas como paused.inactivity (rejected.other 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úmeroTokenTipo
4000000000004202tok_visa_triggerNextRequirementsAltera o próximo conjunto de requisitos com prazo futuro para defini-lo em atraso.
4000000000004210tok_visa_triggerChargeBlockAciona um bloqueio de cobrança.
4000000000004236tok_visa_triggerPayoutBlockAciona 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.

RoutingContaTipo
110000000000999999991Aciona e conclui o processo de verificação de propriedade de conta bancária após uma breve espera
110000000000999999992Aciona 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.

TokenTipo
btok_us_verifiedBem-sucedido
btok_us_verified_noAccountMalsucedida com código no_account
btok_us_verified_accountClosedMalsucedida com código account_closed
btok_us_verified_insufficientFundsMalsucedida com código insufficient_funds
btok_us_verified_debitNotAuthorizedMalsucedida com código debit_not_authorized
btok_us_verified_invalidCurrencyMalsucedida com código invalid_currency

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.

RoutingContaType
110000000000123456789Repasse bem-sucedido.
110000000000111111116Repasse falha com código no_account.
110000000000111111113Repasse falha com código account_closed.
110000000000222222227Repasse falha com código insufficient_funds.
110000000000333333335Repasse falha com código debit_not_authorized.
110000000000444444440Repasse falha com código invalid_currency.
110000000000888888883O repasse falha se method é instant. A conta bancária não se qualifica ao Instant Payouts.

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.

NúmeroTokenTipo
4000056655665556tok_visa_debit_us_transferSuccessDébito Visa. Repasse bem-sucedido.
4000056655665572tok_visa_debit_us_transferFailDébito Visa. Repasse falha com código could_not_process.
4000056755665555tok_visa_debit_us_instantPayoutUnsupportedDébito Visa. O cartão não está qualificado para Instant Payouts.
5200828282828210tok_mastercard_debit_us_transferSuccessDébito Mastercard. Payout bem-sucedido.
6011981111111113tok_discover_debit_us_transferSuccessDébito Discover. Repasse bem-sucedido.
Esta página foi útil?
SimNão
Precisa de ajuda? Fale com o suporte.
Participe do nosso programa de acesso antecipado.
Confira nosso changelog.
Dúvidas? Fale com a equipe de vendas.
LLM? Read llms.txt.
Powered by Markdoc