DiscordStatus
Guias / Guides

Como testar funcionalidades em sandbox

Teste funcionalidades no Sandbox

O Sandbox permite validar os principais fluxos da API sem movimentar valores reais.

Algumas funcionalidades possuem procedimentos específicos de teste, como confirmação manual de operações, simulação de eventos ou configurações exclusivas desse ambiente.

📘

Use esta página para encontrar as instruções de teste de cada funcionalidade e organizar a homologação da sua integração.

Antes de começar

Antes de testar uma funcionalidade:

  1. Crie e configure sua conta Sandbox.
  2. Gere uma chave de API desse ambiente.
  3. Confirme se o recurso está disponível para testes.
  4. Configure os Webhooks necessários.
  5. Utilize somente dados destinados à homologação.

Consulte O que pode ou não pode ser testado para conhecer a cobertura e as limitações do Sandbox.

Fluxo de homologação

Uma jornada de teste normalmente segue estas etapas:

Configurar o Sandbox
        ↓
Criar os recursos de teste
        ↓
Executar a operação
        ↓
Simular o evento
        ↓
Receber o Webhook
        ↓
Validar o processamento
        ↓
Homologar o fluxo

Além do retorno da requisição, valide também:

  • alterações de status;
  • eventos de Webhook;
  • cenários de erro;
  • retentativas e reprocessamentos;
  • comportamento da sua aplicação após cada evento.

Escolha o fluxo que deseja testar

Movimentações financeiras

Cartão de crédito

Assinaturas

Segurança

Solução de problemas

Teste chamadas pela documentação

Também é possível executar requisições diretamente pela referência da API utilizando uma chave de Sandbox.

Esse recurso pode ajudar a:

  • validar parâmetros e payloads;
  • consultar o formato das respostas;
  • reproduzir erros;
  • testar um endpoint antes de implementá-lo na aplicação.

Veja como testar chamadas na documentação.

⚠️

Os testes executados pela documentação utilizam o Sandbox.

Não informe uma chave de Produção.

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

Considere que:

  • algumas operações são simuladas manualmente;
  • determinadas validações podem ser simplificadas;
  • alguns recursos dependem de configurações específicas;
  • integrações externas podem apresentar comportamentos diferentes;
  • um recurso disponível no Sandbox pode depender de habilitação em Produção.
🚧

A homologação no Sandbox não substitui liberações comerciais, requisitos regulatórios ou configurações necessárias em Produção.

Checklist de homologação

Antes de considerar um fluxo homologado, confirme se:

  • os cenários de sucesso foram testados;
  • os principais erros foram tratados;
  • os Webhooks foram recebidos e processados;
  • o processamento é idempotente;
  • os logs permitem identificar falhas;
  • as diferenças entre Sandbox e Produção foram consideradas;
  • nenhuma credencial ou informação fictícia será levada para Produção.

Próximos passos

Updated 4 days ago

Did this page help you?