Uma integração de faturas é uma máquina de estados. Sua função é manter registros consistentes mesmo com retentativas ou notificações fora de ordem.
01 / Mantenha credenciais no servidor
Crie a fatura em um backend confiável com credenciais de escopo restrito. Valide pedido e valor no servidor, sem confiar nos valores enviados pelo navegador.
02 / Persista o vínculo
Armazene o identificador da fatura com a referência interna do pedido. Escolha uma estratégia de retentativas que evite cobranças conflitantes. Registre identificadores operacionais sem segredos.
03 / Processe eventos com cuidado
Autentique callbacks conforme o provedor. Torne o processamento idempotente e verifique transições permitidas. Não entregue um pedido apenas porque o cliente retornou a uma URL de sucesso.
04 / Concilie de forma independente
Use conciliação periódica para identificar notificações ausentes ou atrasadas. Compare o estado oficial da fatura aos pedidos e encaminhe casos ambíguos para revisão.
Guia de planejamento. Confirme os procedimentos na documentação da sua versão e procure suporte qualificado para o seu ambiente. Revisado em 31 de outubro de 2026.