OIKVRA
OIKVRA · Documentação · Português

Pagamentos e conciliação

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.

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.

Mapa de Pagamentos e conciliação, das origens às etapas e resultados
Diagrama do fluxo PAY-01 · Abrir SVG · Abrir PNG

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

  1. Criar intençãoDefinir valor, referência de origem e chave de idempotência.
  2. Solicitar autorizaçãoSubmeter operação ao provedor quando necessário.
  3. CapturarCapturar valor após autorização, conforme modalidade e provedor.
  4. Verificar retornoValidar webhook, evento ou comprovante antes de marcar como confirmado.
  5. ConciliarConferir valores, taxas, contas e referências.
  6. Tratar reversãoProcessar estorno, reembolso ou disputa de forma auditável.

Cuidados e situações especiais

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 chaveO que significaDe onde vemO que afeta
Valor da intençãoFIELD.PAY.INTENT.AMOUNTQuantia solicitada ao provedor.Pedido, título ou operação aprovada.Base de autorização e captura.
Referência externaFIELD.PAY.INTENT.EXTERNAL_REFERENCEIdentificador da operação no provedor.Retorno do provedor.Permite conciliação e suporte.
Estado da transaçãoFIELD.PAY.TRANSACTION.STATESituação real do processamento.Eventos externos verificados.Distingue tentativa de liquidação.
Motivo do reembolsoFIELD.PAY.REFUND.REASONJustificativa do estorno ou restituição.Solicitação autorizada.Sustenta auditoria e contabilização.

Onde consultar mais detalhes

Ver relação com o inventário técnico dos 92 componentes.