> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devmob.app.br/llms.txt
> Use this file to discover all available pages before exploring further.

# payment.cash_settlement_linked

> Evento emitido após vínculo de Payment com CashSettlement

`payment.cash_settlement_linked` é emitido depois que um [Payment](/data-modelling/billing/payment) em dinheiro é vinculado a um [CashSettlement](/data-modelling/billing/cash-settlement) 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

```json theme={null}
{
  "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"
  }
}
```