Skip to content

A16: pagamentos, gateway, chaves e webhook no painel - #149

Merged
tecrodrigocastro merged 7 commits into
mainfrom
feat/a16-pagamentos
Nov 19, 2026
Merged

tecrodrigocastro merged 7 commits into
mainfrom
feat/a16-pagamentos

Conversation

@tecrodrigocastro

@tecrodrigocastro tecrodrigocastro commented Nov 19, 2026 •

Copy link
Copy Markdown
Member

Closes #64

O que muda

Tela /pagamentos no painel, só para a organização (a API já restringia o gateway a payments.gateway; o menu mostrava o item ao financeiro e agora não mostra).

  • Conectar ou trocar o gateway: Asaas ou Mercado Pago, sandbox ou produção. Chave de API, segredo do webhook e chave pública (quando o gateway pede) em campos de senha; depois de salvas, só aparecem os 4 últimos caracteres e só podem ser substituídas.
  • Titular: CPF ou CNPJ, nome exibido no checkout e documento (mostrado mascarado), com a orientação fiscal de cada caso (CPF: rendimento de quem é titular, carnê-leão, conta separada, contador; CNPJ de alguém da organização: faturamento da empresa dele).
  • Prévia do recebedor: como quem paga vê o nome, o tipo de titular, os métodos e o parcelamento, com aviso quando é sandbox.
  • Pronto para vender?: três etapas (chaves salvas, conexão testada, evento de teste recebido), botão Testar conexão com o erro do gateway na tela, endereço do webhook para copiar, último evento recebido e aviso de eventos recusados por assinatura.
  • Trocar de conta com pedidos pagos: o formulário avisa que pedidos e reembolsos antigos ficam na conta anterior, e a API pede confirmação quando já há pedidos pagos; a tela mostra a mensagem e reenvia com confirm.
  • Eventos do gateway: lista com filtro por situação, tentativas, resultado e Reprocessar nos que falharam ou foram ignorados.
  • Editar recebimento: nome exibido, métodos, parcelamento máximo e validade do Pix.
  • Contas anteriores: só consulta.

A regra "vendas só abrem com conexão testada e evento de teste recebido" já existia no backend (SalesReadinessGuard).

Backend

  • PaymentAccountResource ganha last_event_at (último evento assinado da conta ativa). Teste novo em PaymentAccountsTest.

Documentação

  • docs/arquitetura: print da tela na página 18 (a grade de telas passou a 3 colunas com recorte fixo, para caber mais telas), retrato e roadmap atualizados.
  • backend/CLAUDE.md e front-admin/CLAUDE.md atualizados.

Verificação

  • Backend: composer check (pint, phpstan nível 8, rector, pest: 1070 testes, 1068 passaram, 2 pulados).
  • Front: lint, typecheck, Vitest (365 testes) e Playwright (93 cenários, 5 novos em e2e/payments.spec.ts; 7 pulados são as capturas).

Comparação com o protótipo de design

As telas foram comparadas com Pagamentos, Pedidos e Reembolso do protótipo e ajustadas:

  • Pagamentos: cartões "Gateway da comunidade" (com selo Não testado / Falta o evento de teste / Pronto para vender), "Métodos aceitos" e "Webhook" (Copiar, "Nenhum evento recebido" ou último evento), gateway escolhido por chips no formulário, "Últimos eventos do gateway" com o resultado numa coluna.
  • Pedidos (A15): números no topo (pagos, aguardando com quantos vencem hoje, reembolsos, taxa do gateway e % do bruto), filtro por chips, coluna Itens ("2× Estudante"), botão Abrir e "Mostrando X de Y pedidos". Para os números, a lista ganhou meta.summary no backend (com teste).
  • Reembolso (A15): título "Reembolsar pedido #N", resumo do pedido e aviso de que quem comprou recebe e-mail.

Diferenças que ficaram de propósito:

  • Protótipo de Pedidos tem coluna "Pagamento" (Pix/cartão) e filtro "Recusados": a lista não traz o método, e cartão recusado continua como pedido aguardando. O método aparece no detalhe.
  • O detalhe do pedido é uma gaveta com histórico e reembolsos, mais completo que o cartão do protótipo.
  • O reembolso mantém a etapa de confirmação explícita pedida na issue; "Avisar por e-mail" não é opção porque o backend sempre manda o e-mail.
  • O protótipo de Pagamentos não mostra titular, orientação de CPF/CNPJ, prévia do recebedor e troca de conta, que a issue pede; ficaram no cartão do gateway.

Tipos da API

api-types.d.ts regenerado a partir do OpenAPI atual (diff grande porque o arquivo estava desatualizado desde os primeiros módulos). Typecheck passa.

Não verificado

  • Teste de conexão contra os sandboxes reais do Asaas e Mercado Pago (a tela usa a mesma rota que já tem teste de contrato).

A conta ativa passa a trazer last_event_at, a data do último evento
assinado que o gateway mandou para ela, para o painel indicar se o
webhook continua chegando depois do primeiro teste.
Conectar ou trocar o gateway (Asaas, Mercado Pago) com chaves em campo
de senha, titular CPF ou CNPJ com orientação fiscal e prévia de como
quem paga vê o recebedor. Etapas para abrir as vendas com Testar
conexão, endereço do webhook para copiar e último evento recebido.
Eventos do gateway com filtro e reprocessar. Trocar de conta com
pedidos pagos pede confirmação. O menu deixa de mostrar Pagamentos
para o financeiro, que a API já não deixava ver o gateway.
O arquivo estava desatualizado desde os primeiros módulos: agora cobre
todas as rotas, incluindo pedidos, reembolsos e pagamentos.
meta.summary com pagos, aguardando (e quantos vencem até o fim do dia),
reembolsos e taxa do gateway sobre o bruto, para os números do topo da
tela de pedidos. Não segue o filtro da lista.
Pedidos: números da edição no topo, filtro por chips, coluna de itens,
botão Abrir e contador de pedidos. Reembolso: título e resumo do pedido
como no protótipo e aviso de que quem comprou recebe e-mail.
Pagamentos: cartões Gateway da comunidade, Métodos aceitos e Webhook,
gateway escolhido por chips e eventos com o resultado numa coluna.
Tipos da API regenerados com o resumo novo.
@tecrodrigocastro
tecrodrigocastro merged commit 4af93e9 into main Nov 19, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

A16 · Pagamentos: gateway, chaves e webhook

1 participant