Skip to main content

​
Visão Geral

A EconPay oferece dois ambientes para você desenvolver e testar suas integrações:

Produção

Transações reais com dinheiro real

Sandbox

Ambiente de testes sem transações reais

​
Ambiente de Produção

Use o ambiente de produção quando sua integração estiver pronta e testada.

​
URL Base

https://api.econpay.com.br

​
Características

  • ✅ Transações reais processadas
  • ✅ Dinheiro real movimentado
  • ✅ Webhooks enviados para URLs de produção
  • ✅ Taxas aplicadas normalmente

​
Quando Usar

  • Aplicação em produção
  • Transações de clientes reais
  • Após testes completos em sandbox

​
Ambiente Sandbox

Use o sandbox para desenvolver e testar sua integração sem processar transações reais.

​
URL Base

https://sandbox-api.econpay.com.br

​
Características

  • ✅ Sem transações reais
  • ✅ Sem movimentação de dinheiro
  • ✅ Dados de teste
  • ✅ Webhooks enviados normalmente
  • ❌ Sem taxas aplicadas

​
Quando Usar

  • Desenvolvimento inicial
  • Testes de integração
  • Validação de fluxos
  • Testes de webhooks
Importante: Nunca use credenciais de produção em sandbox e vice-versa.

​
Credenciais por Ambiente

Você precisa de credenciais diferentes para cada ambiente: 
const API_URL = 'https://api.econpay.com.br';
const ACCESS_TOKEN = 'seu_token_producao';
Obtenha em: Dashboard Produção

​
Configuração Recomendada

Use variáveis de ambiente para alternar facilmente entre ambientes:
.env.production
API_URL=https://api.econpay.com.br
ACCESS_TOKEN=seu_token_producao
JWT_EMAIL=email@producao.com
JWT_PASSWORD=senha_producao
.env.development
API_URL=https://sandbox-api.econpay.com.br
ACCESS_TOKEN=seu_token_sandbox
JWT_EMAIL=email@sandbox.com
JWT_PASSWORD=senha_sandbox
config.js
const config = {
  apiUrl: process.env.API_URL,
  accessToken: process.env.ACCESS_TOKEN,
  jwtEmail: process.env.JWT_EMAIL,
  jwtPassword: process.env.JWT_PASSWORD
};

export default config;

​
Dados de Teste (Sandbox)

​
Cartões de Teste

Use estes cartões para simular diferentes cenários em sandbox:
NúmeroBandeiraResultado
4000000000000010VisaAprovado
5555555555554444MastercardAprovado
4000000000000002VisaNegado
4000000000000069VisaExpirado

​
CVV e Validade

  • CVV: Qualquer 3 dígitos (ex: 123)
  • Validade: Qualquer data futura (ex: 12/2025)

​
CPF/CNPJ de Teste

  • CPF: 12345678900
  • CNPJ: 12345678000190

​
PIX em Sandbox

  • QR Codes são gerados normalmente
  • Pagamentos são aprovados automaticamente após 30 segundos
  • Ou use o endpoint de simulação para aprovar instantaneamente

​
Testando Webhooks

Em sandbox, webhooks são enviados normalmente. Use ferramentas como:

ngrok

Exponha localhost para receber webhooks

webhook.site

Inspecione payloads de webhook

​
Exemplo com ngrok

# 1. Instale o ngrok
npm install -g ngrok

# 2. Exponha sua porta local
ngrok http 3000

# 3. Use a URL gerada no dashboard
https://abc123.ngrok.io/webhooks

​
Migração para Produção

Quando estiver pronto para produção:
1

Teste completamente em sandbox

Valide todos os fluxos: pagamentos, reembolsos, webhooks
2

Obtenha credenciais de produção

Acesse o dashboard de produção e gere seu access_token
3

Atualize variáveis de ambiente

Troque URLs e tokens para produção
4

Configure webhooks de produção

Use URLs de produção (não localhost ou ngrok)
5

Faça um pagamento de teste real

Processe uma transação pequena para validar
6

Monitore os primeiros pagamentos

Acompanhe de perto as primeiras transações

​
Diferenças entre Ambientes

RecursoProduçãoSandbox
Transações reais✅ Sim❌ Não
Taxas cobradas✅ Sim❌ Não
Webhooks✅ Sim✅ Sim
Dados de teste❌ Não✅ Sim
Aprovação automática❌ Não✅ Sim (PIX)
Limite de requisiçõesNormalIlimitado

​
Próximos Passos

Criar Pagamento

Teste seu primeiro pagamento

Webhooks

Configure notificações