Sandbox

Visão Geral

A Flare Payments oferece um ambiente Sandbox para que você possa testar sua integração de forma segura, sem gerar transações reais ou movimentar saldo. O Sandbox replica o comportamento da API de produção com algumas diferenças importantes:

Característica	Produção	Sandbox
Base URL	`api.flarepayments.com/v1`	`sandbox.flarepayments.com/v1`
Prefixo da Secret Key	`sk_live_`	`sk_live_test_`
Transações reais	Sim	Não
Webhooks	Sim	Sim
Rate limits	120 req/min	60 req/min

Base URL

https://sandbox.flarepayments.com/v1

Autenticação

Use sua API Key de teste — disponível em Dashboard > Configurações > API Keys > Ambiente de Teste.

Authorization: Bearer YOUR_API_KEY

Chaves de teste (sk_live_test_) são rejeitadas em produção. Chaves de produção (sk_live_) são rejeitadas no Sandbox.

Simulando Pagamentos

No Sandbox, cobranças PIX são automaticamente confirmadas após um intervalo configurável para facilitar os testes.

Comportamento padrão

Cenário	Comportamento
Cobrança criada	Status `pending` por 10 segundos, depois `paid`
`amount: 1` (R$ 0,01)	Simula pagamento instantâneo
`amount: 99999` (R$ 999,99)	Simula cobrança que expira
`amount: 66600` (R$ 666,00)	Simula falha no processamento

Exemplo

curl -X POST https://sandbox.flarepayments.com/v1/charges \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1,
    "description": "Teste instantâneo"
  }'

const response = await fetch('https://sandbox.flarepayments.com/v1/charges', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    amount: 1,
    description: 'Teste instantâneo'
  })
});

const charge = await response.json();
// Status será "paid" quase imediatamente

Webhooks no Sandbox

Webhooks funcionam normalmente no Sandbox. Configure sua URL de teste em Dashboard > Configurações > Webhooks e selecione o ambiente Teste. Os eventos disparados são idênticos aos de produção:

charge.paid — após confirmação simulada
charge.expired — para cobranças com valor R$ 999,99
charge.failed — para cobranças com valor R$ 666,00
transfer.completed — saques simulados
transfer.failed — saques com dados inválidos

Use ferramentas como webhook.site ou ngrok para testar webhooks localmente.

Limites do Sandbox

Dados são resetados semanalmente (domingos à meia-noite UTC)
Máximo de 1.000 transações por dia
Webhooks possuem timeout de 10 segundos
QR Codes gerados são não-funcionais — não tente escaneá-los

Checklist de Integração

Antes de migrar para produção, verifique:

Cobranças criadas e pagamentos confirmados via webhook
Polling de status funcionando (GET /charges/{id}/status)
Saques processados e callbacks recebidos
Tratamento de erros implementado (4xx e 5xx)
Retentativas de webhook tratadas corretamente

Quando estiver pronto, troque a Base URL e a API Key para produção. Nenhuma outra alteração no código é necessária.

Início

Conceitos

Visão Geral

Base URL

Autenticação

Simulando Pagamentos

Comportamento padrão

Exemplo

Webhooks no Sandbox

Limites do Sandbox

Checklist de Integração

​Visão Geral

​Base URL

​Autenticação

​Simulando Pagamentos

​Comportamento padrão

​Exemplo

​Webhooks no Sandbox

​Limites do Sandbox

​Checklist de Integração

Visão Geral

Base URL

Autenticação

Simulando Pagamentos

Comportamento padrão

Exemplo

Webhooks no Sandbox

Limites do Sandbox

Checklist de Integração