Arquitetura
Divisao de dominios
A arquitetura foi separada por dominio funcional para manter a Client Api previsivel, consistente e preparada para crescer com novos gateways e novas capacidades.
Client Api
Camada de integracao por chave (`public_key` e `secret_key`) usada pelo merchant para criar pagamentos, customers, assinaturas, transfers e consultar eventos financeiros.
Integrations Gateway
Drivers e contracts isolam o comportamento de cada provider, permitindo implementar providers reais sem contaminar controllers e resources com detalhes especificos de um gateway.
Capacidades por provider
Cada conta de gateway pode suportar um conjunto diferente de funcionalidades. A API filtra capacidades, evita operacoes invalidas e adapta o fluxo conforme o provider.
Roteamento e fallback
O merchant pode selecionar conta ou provider manualmente, ou deixar o sistema decidir com base em regra, score, fallback e compatibilidade.