Ambientes
URLs de staging e produção e como promover a integração com segurança.
A API de Integração tem dois ambientes. Valide tudo em staging antes de ir para produção.
URLs base
| Ambiente | URL base |
|---|---|
| Staging (homologação) | https://api-staging.principia.services/api-integracao |
| Produção | https://api.principia.services/api-integracao |
Staging e produção seguem o mesmo padrão de URL, só troca o domínio: as rotas ficam sob /api-integracao nos dois ambientes (ex.: .../api-integracao/v1/parcela).
Chaves por ambiente
Cada ambiente tem sua própria chave institucional. Nunca use a chave de produção em staging (ou vice-versa).
Dados de teste em staging
Produção cobra de verdade
Em produção, um pagamento com cartão é uma transação real: passa pelo banco emissor, sensibiliza o limite do portador e pode ser marcada como suspeita de fraude se você repetir tentativas. Não use produção para testar. Cartões "de teste" reprovam em produção, e a recusa fica registrada no emissor.
Em staging o processador roda em modo de teste e nenhuma cobrança real acontece. Use:
| Bandeira | Número | Validade | CVV |
|---|---|---|---|
| Visa | 4111 1111 1111 1111 | qualquer data futura | qualquer 3 dígitos |
| Mastercard | 5555 5555 5555 4444 | qualquer data futura | qualquer 3 dígitos |
O responsável financeiro precisa de e-mail válido
O pagamento com cartão é recusado na validação, antes de tocar no cartão, se o responsável financeiro não tiver um e-mail válido cadastrado. Se você criou a massa de teste sem email no responsavelFinanceiro, o cadastro recebe um preenchimento automático que o processador recusa, e a tela mostra uma recusa genérica. Sintoma típico: nenhum cartão passa, por mais que você troque de cartão. Cadastre um e-mail no responsável financeiro e tente de novo.
Roteiro de promoção para produção
- Rode o fluxo completo em staging com dados de teste.
- Valide o tratamento de erros e o reprocessamento de lotes.
- Troque a URL base e a chave para produção.
- Faça um teste controlado com um volume pequeno antes de escalar.