Como esse processo funciona
A tentativa de pagamento possui estados próprios: intenção, autorização, captura, confirmação e eventual reversão. Conciliação vincula o fato financeiro à evidência.
Mapa de referência: demonstra a lógica do negócio. A execução automática de cada etapa depende dos módulos contratados, permissões, parametrização e versão instalada.
De onde vêm os dados?
- Cobrança legítima
- Meio de pagamento habilitado
- Provedor externo autorizado
O que esse processo entrega?
- Pagamento confirmado
- Conciliação bancária
- Estorno e auditoria
Etapas explicadas
- Criar intençãoDefinir valor, referência de origem e chave de idempotência.
- Solicitar autorizaçãoSubmeter operação ao provedor quando necessário.
- CapturarCapturar valor após autorização, conforme modalidade e provedor.
- Verificar retornoValidar webhook, evento ou comprovante antes de marcar como confirmado.
- ConciliarConferir valores, taxas, contas e referências.
- Tratar reversãoProcessar estorno, reembolso ou disputa de forma auditável.
Cuidados e situações especiais
- Autorizado não significa capturado.
- Webhook deve ser autenticado, validado e idempotente.
- Reembolso não apaga a captura original.
- Credenciais de provedores nunca vão para o navegador ou manuais.
Regra importanteChamadas a provedores de pagamento são externas e não equivalem a HTTP entre módulos internos.
Campos que ajudam a entender o fluxo
Esses identificadores são propostas de documentação para integração futura com Shift+F1. A publicação desta página não altera campos ou atalhos no ERP.
| Campo e chave | O que significa | De onde vem | O que afeta |
|---|---|---|---|
| Valor da intençãoFIELD.PAY.INTENT.AMOUNT | Quantia solicitada ao provedor. | Pedido, título ou operação aprovada. | Base de autorização e captura. |
| Referência externaFIELD.PAY.INTENT.EXTERNAL_REFERENCE | Identificador da operação no provedor. | Retorno do provedor. | Permite conciliação e suporte. |
| Estado da transaçãoFIELD.PAY.TRANSACTION.STATE | Situação real do processamento. | Eventos externos verificados. | Distingue tentativa de liquidação. |
| Motivo do reembolsoFIELD.PAY.REFUND.REASON | Justificativa do estorno ou restituição. | Solicitação autorizada. | Sustenta auditoria e contabilização. |