# Ambientes da API

A Easypay disponibiliza dois ambientes distintos para desenvolver e executar a sua integração de pagamentos.

## Ambiente de Teste

**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


### Credenciais de Teste


```
AccountId: 2b0f63e2-9fb5-4e52-aca0-b4bf0339bbe6
ApiKey: eae4aa59-8e5b-4ec2-887d-b02768481a92
```

**Nota**: Estas credenciais apenas funcionam no ambiente de teste.

### Métodos de Pagamento 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


## Ambiente de Produção

**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


### Credenciais de Produção

As credenciais de produção devem ser geradas através da sua conta Easypay. Siga [este guia](https://www.easypay.pt/blog/como-gerar-chaves-de-autenticacao/) 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


## Alternar Entre Ambientes

Para alternar entre ambientes, simplesmente altere a URL base nas suas chamadas à API:

**Solicitação de Teste**:


```bash
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**:


```bash
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 '{ ... }'
```

## Boas Práticas

1. **Comece Sempre com Teste**: Desenvolva e teste a sua integração primeiro no ambiente de teste
2. **Use Variáveis de Ambiente**: Armazene configuração específica do ambiente (URLs, credenciais) em variáveis de ambiente
3. **Configurações Separadas**: Mantenha as configurações de teste e produção completamente separadas
4. **Monitorize Ambos os Ambientes**: Configure monitorização e alertas para teste e produção
5. **Teste Antes de Implantar**: Teste sempre alterações no ambiente de teste antes de implantar em produção


## Diferenças Entre Ambientes

| 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 |


## Próximos Passos

- [Autenticação](/docs/authentication) - Aprenda como autenticar as suas solicitações
- [Início Rápido](/docs/quickstart) - Faça a sua primeira chamada à API
- [Tratamento de Erros](/docs/error-handling) - Trate erros em ambos os ambientes