Aprove contas e subcontas no Sandbox

O Sandbox possui comportamentos específicos para aprovação, onboarding e acesso de contas e subcontas.

Dependendo do tipo de conta e da configuração utilizada, a aprovação pode ocorrer automaticamente, por um endpoint específico ou pelo fluxo de onboarding BaaS.

Antes de começar

Para evitar falhas durante a aprovação:

• preencha todos os dados comerciais obrigatórios;
• utilize valores compatíveis com cada campo;
• evite números e caracteres especiais no nome da conta;
• utilize apenas credenciais e URLs do Sandbox;
• não informe dados pessoais de terceiros.

Exemplo de nome que pode impedir a validação:

Conta Teste_01

Prefira:

Conta Teste Um

Aprove uma conta criada diretamente no Sandbox

Contas criadas diretamente no Sandbox são aprovadas automaticamente quando os dados comerciais obrigatórios são preenchidos corretamente.

Não é necessário enviar documentos reais para concluir essa validação.

Após preencher os dados:

1. aguarde a validação automática;
2. consulte o status da conta;
3. confirme se os recursos necessários estão habilitados;
4. revise os dados caso a aprovação não seja concluída.

Os dados informados não precisam pertencer a uma pessoa real, mas devem respeitar o formato esperado em cada campo.

Caso a conta não seja aprovada automaticamente ou o Pix permaneça desabilitado, revise o nome cadastrado, remova números e caracteres especiais e atualize os dados comerciais.

Aprove uma subconta

No Sandbox, as subcontas podem ser aprovadas de três formas:

Independentemente do fluxo escolhido:

• preencha todos os dados comerciais obrigatórios;
• utilize valores compatíveis com os campos;
• evite números e caracteres especiais no nome da subconta;
• armazene o ID retornado durante a criação.

Opção 1: habilite a autoaprovação

A autoaprovação permite que novas subcontas sejam aprovadas automaticamente após a criação, desde que os dados obrigatórios estejam válidos.

A configuração pode ser ativada na interface do Sandbox.

Veja como configurar sua conta no Sandbox.

Habilitar autoaprovação
        ↓
Criar subconta
        ↓
Validar os dados
        ↓
Subconta aprovada

Após criar a subconta, consulte seu status para confirmar se a aprovação foi concluída.

Opção 2: aprove pela API

Para controlar o momento da aprovação, utilize o endpoint:

POST /v3/accounts/{id}/approve

Consulte o endpoint Aprovar conta no Sandbox.

Esse fluxo pode ser utilizado quando:

• a autoaprovação não está habilitada;
• a integração precisa controlar a etapa de aprovação;
• o teste depende de uma mudança explícita no status da conta;
• é necessário simular um fluxo mais próximo do utilizado pela aplicação.

Criar subconta
        ↓
Armazenar o ID
        ↓
Enviar aprovação pela API
        ↓
Consultar o status

Após enviar a requisição, consulte novamente a subconta e confirme se a aprovação foi processada.

Opção 3: utilize o onboarding BaaS

Em operações BaaS, o usuário final pode realizar o onboarding pelo endereço retornado no campo onboardingUrl.

Esse fluxo permite homologar etapas como:

• acesso ao onboarding;
• preenchimento dos dados cadastrais;
• envio das informações solicitadas;
• acompanhamento do status da conta;
• continuidade da jornada após o preenchimento.

A aprovação no Sandbox não representa a aprovação cadastral ou regulatória da conta em Produção.

Acesse uma subconta padrão

Ao criar uma subconta padrão no Sandbox, o e-mail de redefinição de senha é enviado para o endereço da conta pai responsável pela criação.

Para acessar a subconta:

1. localize o e-mail recebido pela conta pai;
2. acesse o link de redefinição de senha;
3. defina uma senha para a subconta;
4. realize o login utilizando os dados da subconta.

Entenda os dados preenchidos automaticamente

Durante a atualização ou validação dos dados comerciais, o Sandbox pode inserir informações fictícias para permitir a continuidade dos testes.

Por exemplo, o nome pode ser preenchido com um valor genérico:

João da Silva

Na área Meu usuário, também podem aparecer dados simulados, como:

• CPF;
• endereço;
• data de nascimento;
• outras informações cadastrais.

Esses dados são utilizados exclusivamente para o funcionamento interno do Sandbox e não representam informações reais.

Caso a conta não seja aprovada

Verifique se:

• todos os campos obrigatórios foram preenchidos;
• o nome não contém números ou caracteres especiais;
• os valores informados são compatíveis com os campos;
• a conta ou subconta pertence ao Sandbox;
• a autoaprovação está habilitada, quando aplicável;
• o endpoint de aprovação foi executado para o ID correto;
• a URL e a chave de API pertencem ao mesmo ambiente.

Caso o Pix permaneça desabilitado:

1. revise os dados comerciais;
2. atualize o nome da conta;
3. remova números e caracteres especiais;
4. aguarde uma nova validação;
5. consulte novamente o status da conta.

Se o problema persistir, entre em contato com o time de Sucesso de Integrações.

Verifique a URL e a chave de API

Utilize a URL correspondente ao ambiente:

Adicione saldo quando necessário

A aprovação da conta não adiciona saldo automaticamente.

Alguns fluxos exigem recursos disponíveis, como:

• transferências;
• pagamentos de contas;
• antecipações;
• outras movimentações financeiras.

Para gerar saldo no Sandbox:

1. crie um cliente de teste;
2. crie uma cobrança por Pix ou boleto;
3. confirme o pagamento;
4. utilize o saldo disponibilizado nos demais testes.

Consulte Adicione saldo à sua conta Sandbox.

Teste notificações com segurança

As notificações por e-mail e SMS podem ser enviadas normalmente no Sandbox.

Para evitar disparos indevidos:

• utilize apenas e-mails e telefones próprios;
• não cadastre dados de terceiros;
• evite contatos aleatórios ou inválidos;
• revise as configurações de notificação antes dos testes.

Considere as limitações do Sandbox

Embora o Sandbox reproduza grande parte da jornada da plataforma, alguns fluxos possuem comportamentos específicos, como:

• aprovações automáticas;
• confirmações manuais;
• dados cadastrais simulados;
• onboarding simplificado;
• controles disponíveis apenas para homologação;
• integrações externas que não são executadas integralmente.

Antes de considerar um fluxo homologado, confirme se:

• a funcionalidade está disponível no Sandbox;
• existem restrições ou pré-requisitos;
• há alguma configuração adicional;
• o comportamento depende de serviços disponíveis somente em Produção;
• os cenários de sucesso e erro foram testados.

Consulte O que pode ser testado no Sandbox.

Diferenças em relação à Produção

Antes de ir para Produção

Confirme se:

• a URL foi alterada para o ambiente de Produção;
• a chave de API utilizada pertence à conta de Produção;
• os recursos necessários estão habilitados;
• as permissões da chave de API estão corretas;
• os fluxos críticos foram homologados;
• sua aplicação trata respostas de erro;
• os Webhooks são processados de forma idempotente;
• os dados fictícios foram removidos;
• as diferenças entre Sandbox e Produção foram consideradas;
• os requisitos cadastrais, regulatórios e operacionais foram validados.

Fluxo recomendado de homologação

Após preparar e aprovar sua conta Sandbox:

1. gere uma chave de API de Sandbox;
2. configure a URL de Sandbox na aplicação;
3. crie um cliente fictício;
4. emita uma cobrança de teste;
5. confirme o pagamento para adicionar saldo;
6. teste os fluxos específicos da integração;
7. valide o recebimento dos Webhooks;
8. consulte as limitações de cada funcionalidade;
9. migre para Produção somente após concluir a homologação.

Criar e aprovar a conta
        ↓
Gerar a chave de API
        ↓
Criar recursos de teste
        ↓
Adicionar saldo
        ↓
Executar as operações
        ↓
Validar respostas e Webhooks
        ↓
Revisar diferenças de Produção

Conteúdos relacionados

• Configure sua conta no Sandbox
• Aprove uma conta no Sandbox
• Adicione saldo à conta Sandbox
• Teste funcionalidades no Sandbox
• Veja o que pode ser testado
• Entre em contato

Para suporte técnico relacionado à integração: