Proteste Payment API

A ponte confiável e extremamente rápida entre nossas interfaces e os sistemas de processamento financeiro.

🎯 Visão do Produto

No fluxo de vendas e assinaturas da PROTESTE, a experiência do usuário e a confiabilidade na hora do pagamento são fundamentais.

A API atua orquestrando a comunicação com a API externa de pagamentos para assinaturas (planos Essencial ou Superior). Ao isolar isso em um serviço dedicado, garantimos melhor manutenção, tolerância a falhas e conversões mais rápidas.

⚡ Integração e Geração de XML (Qute Templates)

A comunicação com sistemas legados exige envios em XML. Utilizamos a engine Qute do Quarkus para processar o template base (modelo.xml) com extrema performance.

📩 Payload Frontend (JSON)

O que a API recebe e injeta no template:

  • Dados Pessoais: {item.firstName}, {item.lastName}, {item.nationalIdentificationNumber}
  • Endereço: {item.street}, {item.postalCode}, etc.
  • Cartão de Crédito: {item.accountNumber}, {item.accountDigit}
  • Plano (Enum): Resolve dinamicamente {item.tipo.promotion}, {item.tipo.unitprice}, etc.

⚙️ Gerados pela API (Backend)

O PaymentService gera dados de auditoria que complementam o XML:

  • Data Atual: {item.creationdatetime} (Fuso de SP)
  • Estáticos: {item.birthDate} (ex: 01/01/1990)
  • IDs de Sessão (Únicos): {item.sessionId}, {item.paymentId}, {item.billingAddressId}