Como configurar sua conta no Sandbox
Configure os recursos da sua conta Sandbox
As configurações do Sandbox permitem habilitar recursos e simular cenários específicos durante o desenvolvimento da integração.
Essas alterações afetam somente a conta Sandbox e não movimentam valores reais.
Ao concluir este guia, você saberá acessar as configurações do Sandbox e habilitar os recursos necessários para seus testes.
Recursos habilitados no Sandbox não são ativados automaticamente em Produção.
Para confirmar a disponibilidade em Produção, fale com seu gerente de contas pelo WhatsApp 0800 009 0037 ou envie um e-mail para [email protected].
Quando utilizar
Use essas configurações para:
- testar recursos que dependem de habilitação;
- reproduzir cenários específicos;
- homologar fluxos de subcontas;
- validar tokenização e cobranças recorrentes;
- testar integrações antes do go-live.
1. Acesse as configurações
Na interface do Sandbox, acesse:
Menu do usuário → Minha conta → Configurações → Sandbox
2. Habilite os recursos necessários
As configurações podem ser ativadas ou desativadas a qualquer momento.
| Estado | Comportamento |
|---|---|
| Habilitado | O recurso fica disponível para novos testes |
| Desabilitado | O comportamento padrão do Sandbox é mantido |
As alterações afetam somente a conta em que foram realizadas.
Recursos disponíveis
BaaS para subcontas
Permite testar a criação e a utilização de subcontas em uma operação BaaS.
Utilize essa configuração para homologar fluxos em que sua plataforma cria e gerencia contas de clientes pela API.
Saiba mais sobre o período de avaliação de subcontas BaaS.
Tokenização de cartão
Permite testar a geração e a utilização de tokens de cartão em cobranças futuras.
Esse recurso pode ser utilizado em fluxos como:
- assinaturas;
- cobranças recorrentes;
- novos pagamentos com um cartão já tokenizado.
Pagadores estrangeiros
Permite criar clientes internacionais e validar fluxos com pagadores de outros países.
A utilização desse recurso em Produção depende de liberação para a conta.
Limites de cobrança
Permite configurar limites utilizados nos testes, como:
- valor mínimo;
- valor máximo;
- restrições de emissão.
Os valores configurados servem somente para homologação.
Autoaprovação de subcontas
Permite simular a aprovação automática das subcontas criadas no Sandbox.
Essa opção facilita o teste completo da integração sem depender de uma análise manual.
A autoaprovação é uma simulação do Sandbox e não representa o processo de aprovação aplicado em Produção.
3. Valide o fluxo completo
Para homologar uma integração com subcontas BaaS:
- Habilite o BaaS.
- Ative a autoaprovação de subcontas.
- Crie uma subconta pela API.
- Armazene a chave de API retornada.
- Realize operações na subconta.
- Valide o recebimento dos Webhooks.
- Confira se sua aplicação processou os eventos corretamente.
Habilitar BaaS
↓
Ativar autoaprovação
↓
Criar subconta
↓
Obter a chave de API
↓
Executar operações
↓
Validar WebhooksA ativação de uma configuração não conclui a homologação.
Teste também as requisições, respostas, erros, alterações de status e Webhooks relacionados ao fluxo.
Diferenças entre Sandbox e Produção
| Recurso | Sandbox | Produção |
|---|---|---|
| Configurações de teste | Podem ser ativadas pela interface | Podem depender de habilitação |
| Movimentação financeira | Não utiliza valores reais | Utiliza valores reais |
| BaaS | Permite simular o fluxo | Depende da estrutura da operação |
| Tokenização | Disponível para homologação | Pode depender de habilitação |
| Pagadores estrangeiros | Disponível para testes | Depende de liberação |
| Autoaprovação de subcontas | Pode ser simulada | Não representa o fluxo real |
Antes de ir para Produção
Confirme:
- quais recursos precisam de habilitação;
- se os fluxos críticos foram homologados;
- se os Webhooks estão configurados;
- se a aplicação trata erros e mudanças de status;
- se as credenciais de Sandbox foram substituídas;
- se nenhum dado fictício permanece na configuração;
- se as diferenças entre os ambientes foram consideradas.
Próximos passos
Updated 18 days ago