Skip to main content
transfer.updated é emitido depois que uma Transfer é atualizada por billing. Handlers usam este evento para executar efeitos assíncronos fora do fluxo síncrono.

​
Detalhes do Evento

PropriedadeValor
Tipotransfer.updated
OrigemWebhook de billing
PublicaçãoApós commit da Transfer
QuandoBilling informa mudança na transferência.

​
Handlers

HandlerResponsabilidadeDados usadosExecução
run-transfer-update-side-effectsExecuta efeitos da transferência atualizada.dataAssíncrona.

​
Payload

CampoTipoDescrição
dataTransferEntidade Transfer atualizada

​
Regras dos handlers

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

​
Exemplo

{
  "type": "transfer.updated",
  "data": {
    "transferId": "0197a818-6bdc-7d65-9096-1987a5382aa1",
    "organizationId": "0197a801-1690-7590-b3cf-19599b9be3e4",
    "companyId": "0197a801-6a42-79aa-9e56-d3c85148c0fa",
    "bankAccountId": "0197a817-f0e7-7c45-bcf2-5b6e967c2b2a",
    "externalProvider": "billing_interface",
    "externalProviderId": "trf_3c35a871",
    "amount": 500000,
    "status": "PAID",
    "transferredAt": "2026-07-05T10:05:00.000Z",
    "createdBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
    "createdAt": "2026-07-05T10:00:00.000Z",
    "updatedBy": "0197a805-0910-7eb2-bae7-90a13df2a9b2",
    "updatedAt": "2026-07-05T10:05:00.000Z"
  }
}