Como configurar sua conta no Sandbox

A seção de configurações do Sandbox permite simular cenários específicos durante o desenvolvimento e homologação da integração.

Essas configurações fornecem autonomia para reproduzir comportamentos que normalmente dependem de liberações ou processos operacionais no ambiente de produção, permitindo validar fluxos antes da implantação.

🚧

Importante

As configurações ativadas em Sandbox são utilizadas exclusivamente para testes.

A habilitação de uma funcionalidade em Sandbox não significa que ela estará automaticamente disponível em produção.

Caso sua integração dependa desses recursos em ambiente produtivo, consulte seu gerente de conta.

Quando utilizar

As configurações do Sandbox são recomendadas para:

• validar fluxos antes da implantação em produção;
• reproduzir cenários específicos durante o desenvolvimento;
• testar recursos que dependem de liberações comerciais ou operacionais;
• homologar integrações sem impactar operações reais;
• antecipar comportamentos esperados do ambiente produtivo.

Como funcionam as configurações do Sandbox

As opções disponíveis permitem alterar o comportamento do ambiente de testes sem afetar a conta de produção.

As configurações podem ser ativadas e desativadas a qualquer momento e possuem efeito apenas sobre a conta Sandbox.

📘

Importante

Algumas funcionalidades exigem habilitação específica em produção, mesmo que estejam disponíveis para testes em Sandbox.

O que acontece ao ativar uma configuração

As configurações disponíveis nessa tela funcionam como recursos de homologação e alteram o comportamento da conta Sandbox imediatamente após a ativação.

Em geral, cada configuração possui apenas dois estados:

Ao ativar uma configuração, os novos testes executados na conta passam a considerar a funcionalidade habilitada.

📘

Importante

Essas alterações afetam apenas a conta Sandbox em que a configuração foi realizada e não produzem qualquer efeito em contas de produção.

Funcionalidades disponíveis

Habilitar BaaS para subcontas

Permite simular a criação e utilização de subcontas em cenários de Banking as a Service.

Essa configuração é útil para validar integrações que operam com estruturas White Label ou múltiplas contas.

Saiba mais sobre subcontas BaaS

📘

Importante

A disponibilidade em produção depende das regras comerciais e regulatórias aplicáveis.

Habilitar tokenização de cartão

Permite testar o armazenamento seguro dos dados do cartão e a utilização de tokens em cobranças futuras.

Essa configuração é especialmente útil para:

• assinaturas;
• recorrências;
• pagamentos sem necessidade de informar novamente os dados do cartão.

Saiba mais sobre tokenização

📘

Importante

O comportamento em Sandbox tem finalidade exclusivamente de homologação e não substitui os requisitos de habilitação em produção.

Permitir criação de pagadores estrangeiros

Permite criar clientes internacionais e validar fluxos que envolvem pagadores estrangeiros.

Esse recurso é recomendado para integrações que operam com clientes fora do Brasil.

⚠️

Importante

A utilização em produção depende de liberação específica da conta.

Configurar limites relacionados às cobranças

Permite definir limites utilizados durante os testes.

Essa configuração facilita a validação de comportamentos relacionados a:

• valor mínimo;
• valor máximo;
• restrições de emissão.

Esses limites possuem finalidade exclusivamente de homologação.

Habilitar autoaprovação de subcontas

Permite simular cenários em que as subcontas são aprovadas automaticamente.

Esse recurso é útil para validar o fluxo completo de criação e utilização de subcontas sem depender de processos manuais.

📘

Importante

A aprovação automática em Sandbox não representa o comportamento real do ambiente produtivo.

Exemplo de fluxo de homologação

Uma plataforma White Label pode utilizar as configurações do Sandbox para:

1. Habilitar BaaS.
2. Ativar autoaprovação de subcontas.
3. Criar uma subconta via API.
4. Testar cobranças e recebimentos.
5. Validar webhooks.
6. Simular o comportamento completo da integração antes da implantação em produção.

Exemplo prático

Considere uma plataforma White Label que deseja validar o fluxo completo de criação de subcontas.

Nesse cenário, a configuração pode ser utilizada da seguinte forma:

1. Acessar as configurações do Sandbox.
2. Habilitar BaaS para subcontas.
3. Ativar a autoaprovação de subcontas.
4. Criar uma subconta utilizando o endpoint de criação de contas.
5. Utilizar a API Key retornada para realizar operações na subconta.
6. Criar clientes, cobranças e testar webhooks.
7. Validar o comportamento esperado da integração.

Fluxo simplificado:

Habilitar BaaS
        ↓
Ativar autoaprovação
        ↓
Criar subconta
        ↓
Receber API Key
        ↓
Executar testes
        ↓
Validar integração

Esse processo permite homologar toda a jornada da subconta antes da utilização do ambiente produtivo.

Onde acessar

Para configurar sua conta, acesse:

Menu do Usuário → Minha Conta → Configurações → Sandbox

Boas práticas

📘

Recomendado

• Realize toda a homologação em Sandbox antes de utilizar produção.
• Não assuma que recursos disponíveis em Sandbox estarão automaticamente habilitados em produção.
• Valide o comportamento dos webhooks e das respostas da API durante os testes.
• Utilize dados fictícios sempre que possível.
• Considere que alguns fluxos produtivos podem exigir liberações adicionais.

Diferenças entre Sandbox e Produção

Impactos operacionais

As configurações do Sandbox têm como objetivo facilitar a homologação da integração, mas não substituem as validações, habilitações e processos existentes em produção.

Por esse motivo, recomenda-se validar os requisitos necessários antes da entrada em operação.

Próximos passos

Após configurar sua conta em Sandbox, recomendamos consultar:

• Criação de subcontas.
• Tokenização de cartão.
• Configuração de Webhooks.
• Pix Automático.
• Cobranças via cartão de crédito.
• Guia de homologação da API.