{"v":{"area":"admin","slug":"payments","path":"/home/tiixcom/public_html/sistema/docs/readme/admin/payments.md","relative_path":"docs/readme/admin/payments.md","title":"Payments","html":"<h1>Payments</h1><h2>O que e</h2><p>A pagina Payments e a mesa de acompanhamento dos pagamentos registrados no admin.</p><h2>Para que serve</h2><p>Use esta tela para consultar cobrancas, acompanhar situacoes por provedor e metodo, abrir a fatura vinculada e executar acoes administrativas controladas.</p><h2>Blocos da tela</h2><ul><li>Hero Matdash: apresenta o contexto financeiro e KPIs de total, pagos, falhas e valor consolidado.</li><li>Leitura consolidada: descreve o recorte carregado e a origem dos dados.</li><li>Tabela principal: lista pagamentos em DataTable com status, provedor, metodo, valor, fatura e acoes.</li><li>Offcanvas de filtros: agrupa status, provedor, metodo e fatura sem reduzir a area da grade.</li></ul><h2>Botoes e acoes</h2><ul><li>Filtrar: abre o offcanvas de filtros financeiros.</li><li>Atualizar: recarrega a listagem com os filtros atuais.</li><li>Fatura: abre a fatura relacionada quando houver identificador disponivel.</li><li>Pagar: marca o pagamento como pago pelo endpoint administrativo.</li><li>Falhar: registra falha manual do pagamento.</li><li>Cancelar: cancela o pagamento quando a API permitir.</li><li>Reembolsar: solicita reembolso administrativo quando aplicavel.</li></ul><h2>Filtros</h2><ul><li>Status: restringe a grade por situacao do pagamento.</li><li>Provedor: filtra por gateway ou origem de cobranca.</li><li>Metodo: filtra por cartao, boleto, pix ou outro metodo retornado pela API.</li><li>Fatura: localiza pagamentos por <code>invoice_id</code>.</li></ul><h2>Observacoes operacionais</h2><ul><li>A listagem usa <code>/adm/api/Payments/list</code>.</li><li>As acoes chamam endpoints administrativos de <code>markPaid</code>, <code>markFailed</code>, <code>cancel</code> e <code>refund</code>.</li><li>As confirmacoes usam SweetAlert quando disponivel e fallback nativo quando nao houver bundle carregado.</li></ul>"},"exp":1780849830}