payment.cash_settlement_linked - Documentação DEVMOB

payment.cash_settlement_linked é emitido depois que um Payment em dinheiro é vinculado a um CashSettlement confirmado. Handlers usam este evento para executar efeitos assíncronos fora do fluxo síncrono.

Detalhes do Evento

Propriedade	Valor
Tipo	`payment.cash_settlement_linked`
Origem	Confirmação de CashSettlement
Publicação	Após commit do Payment
Quando	OPS confirma a prestação de contas e o vínculo 1:1 é preenchido.

Payload

Campo	Tipo	Descrição
`identifier`	`UUID`	Chave de idempotência do evento
`data`	`Payment`	Entidade Payment vinculada ao CashSettlement

Regras dos handlers

Handlers não rodam na transação que publicou o Payment.
Falha em handler não desfaz o Payment.
Cada handler deve ser idempotente.
Novos handlers podem ser adicionados sem mudar o fluxo síncrono.

Exemplo

{
  "type": "payment.cash_settlement_linked",
  "identifier": "0197a816-281b-72e7-8f50-286fbfc5c08d",
  "data": {
    "paymentId": "0197a816-281b-72e7-8f50-286fbfc5c08d",
    "orderId": "0197a813-0fb9-7d42-9c81-50c0f6d9ae5a",
    "cashSettlementId": "0197a822-2d2e-7efe-b456-e39c9dc77f51",
    "method": "CASH",
    "channel": "DRIVER_APP",
    "amount": 11400,
    "status": "PAID"
  }
}