A Easypay disponibiliza dois ambientes distintos para desenvolver e executar a sua integração de pagamentos.
URL Base: https://api.test.easypay.pt/2.0
O ambiente de teste foi concebido para:
- Desenvolvimento e testes de integração
- Experimentação com funcionalidades da API
- Teste de fluxos de pagamento sem dinheiro real
- Validação da sua implementação antes de entrar em produção
AccountId: 2b0f63e2-9fb5-4e52-aca0-b4bf0339bbe6
ApiKey: eae4aa59-8e5b-4ec2-887d-b02768481a92Nota: Estas credenciais apenas funcionam no ambiente de teste.
No ambiente de teste, pode simular diferentes cenários de pagamento:
- Use números de cartão de crédito de teste para simular transações bem-sucedidas e falhadas
- Teste pagamentos MB WAY sem requerer confirmações telefónicas reais
- Gere referências Multibanco que podem ser marcadas como pagas através do backoffice
URL Base: https://api.prod.easypay.pt/2.0
O ambiente de produção destina-se a:
- Processamento de pagamentos ao vivo com dinheiro real
- Servir clientes reais
- Operações de nível de produção
As credenciais de produção devem ser geradas através da sua conta Easypay. Siga este guia para criar as suas chaves API de produção.
Notas Importantes de Segurança:
- Nunca use credenciais de teste em produção
- Mantenha as credenciais de produção seguras e privadas
- Rode as chaves de produção regularmente
- Monitorize o uso da API de produção para anomalias
Para alternar entre ambientes, simplesmente altere a URL base nas suas chamadas à API:
Solicitação de Teste:
curl -L -X POST 'https://api.test.easypay.pt/2.0/single' \
-H 'AccountId: <TEST_ACCOUNT_ID>' \
-H 'ApiKey: <TEST_API_KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{ ... }'Solicitação de Produção:
curl -L -X POST 'https://api.prod.easypay.pt/2.0/single' \
-H 'AccountId: <PROD_ACCOUNT_ID>' \
-H 'ApiKey: <PROD_API_KEY>' \
-H 'Content-Type: application/json' \
--data-raw '{ ... }'- Comece Sempre com Teste: Desenvolva e teste a sua integração primeiro no ambiente de teste
- Use Variáveis de Ambiente: Armazene configuração específica do ambiente (URLs, credenciais) em variáveis de ambiente
- Configurações Separadas: Mantenha as configurações de teste e produção completamente separadas
- Monitorize Ambos os Ambientes: Configure monitorização e alertas para teste e produção
- Teste Antes de Implantar: Teste sempre alterações no ambiente de teste antes de implantar em produção
| Funcionalidade | Ambiente de Teste | Ambiente de Produção |
|---|---|---|
| Dinheiro Real | Não | Sim |
| Credenciais de Teste Disponíveis | Sim | Não |
| Limitação de Taxa | Relaxada | Aplicada |
| Persistência de Dados | Pode ser reiniciada | Permanente |
| SLA de Suporte | Melhor esforço | SLA de Produção |
- Autenticação - Aprenda como autenticar as suas solicitações
- Início Rápido - Faça a sua primeira chamada à API
- Tratamento de Erros - Trate erros em ambos os ambientes