Ambientes

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:

Produção
Sandbox

const API_URL = 'https://api.econpay.com.br';
const ACCESS_TOKEN = 'seu_token_producao';

Obtenha em: Dashboard Produção

const API_URL = 'https://sandbox-api.econpay.com.br';
const ACCESS_TOKEN = 'seu_token_sandbox';

Obtenha em: Dashboard Sandbox

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úmero	Bandeira	Resultado
4000000000000010	Visa	Aprovado
5555555555554444	Mastercard	Aprovado
4000000000000002	Visa	Negado
4000000000000069	Visa	Expirado

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:

Teste completamente em sandbox

Valide todos os fluxos: pagamentos, reembolsos, webhooks

Obtenha credenciais de produção

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

Atualize variáveis de ambiente

Troque URLs e tokens para produção

Configure webhooks de produção

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

Faça um pagamento de teste real

Processe uma transação pequena para validar

Monitore os primeiros pagamentos

Acompanhe de perto as primeiras transações

Diferenças entre Ambientes

Recurso	Produção	Sandbox
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ções	Normal	Ilimitado

Início

Guias

Visão Geral

Produção

Sandbox

Ambiente de Produção

URL Base

Características

Quando Usar

Ambiente Sandbox

URL Base

Características

Quando Usar

Credenciais por Ambiente

Configuração Recomendada

Dados de Teste (Sandbox)

Cartões de Teste

CVV e Validade

CPF/CNPJ de Teste

PIX em Sandbox

Testando Webhooks

ngrok

webhook.site

Exemplo com ngrok

Migração para Produção

Diferenças entre Ambientes

Próximos Passos

Criar Pagamento

Webhooks

​Visão Geral

Produção

Sandbox

​Ambiente de Produção

​URL Base

​Características

​Quando Usar

​Ambiente Sandbox

​URL Base

​Características

​Quando Usar

​Credenciais por Ambiente

​Configuração Recomendada

​Dados de Teste (Sandbox)

​Cartões de Teste

​CVV e Validade

​CPF/CNPJ de Teste

​PIX em Sandbox

​Testando Webhooks

ngrok

webhook.site

​Exemplo com ngrok

​Migração para Produção

​Diferenças entre Ambientes

​Próximos Passos

Criar Pagamento

Webhooks

Visão Geral

Ambiente de Produção

URL Base

Características

Quando Usar

Ambiente Sandbox

URL Base

Características

Quando Usar

Credenciais por Ambiente

Configuração Recomendada

Dados de Teste (Sandbox)

Cartões de Teste

CVV e Validade

CPF/CNPJ de Teste

PIX em Sandbox

Testando Webhooks

Exemplo com ngrok

Migração para Produção

Diferenças entre Ambientes

Próximos Passos