Pular para o conteúdo principal

Eventos de Webhook

operation.created​

Disparado quando uma operacao e criada (e, quando aplicavel, aguarda aprovacao do Backoffice).

{
  "event_type": "operation.created",
  "data": {
    "operation_id": "...",
    "display_number": "OP-A1B2C3D4-E5F6G7H8",
    "opr_liquid_value": "9424.66",
    "lifecycle_status": "WAITING_APPROVAL"
  }
}

operation.approved​

Disparado quando a operacao e aprovada (pelo Backoffice ou automaticamente).

{
  "event_type": "operation.approved",
  "data": {
    "operation_id": "...",
    "display_number": "OP-A1B2C3D4-E5F6G7H8",
    "lifecycle_status": "APPROVED_DIRECT",
    "approved_at": "2026-06-01T15:00:00Z"
  }
}

operation.contract_signed​

Todos os signatarios assinaram o contrato via ZapSign.

{
  "event_type": "operation.contract_signed",
  "data": {
    "operation_id": "...",
    "contract_id": "...",
    "signed_at": "2026-06-01T14:00:00Z"
  }
}

operation.paid​

Pagamento PIX enviado ao cedente.

{
  "event_type": "operation.paid",
  "data": {
    "operation_id": "...",
    "display_number": "OP-A1B2C3D4-E5F6G7H8",
    "opr_liquid_value": "9424.66",
    "payment_sent_at": "2026-06-01T15:30:00Z"
  }
}

operation.denied​

Operacao negada pelo Backoffice.

{
  "event_type": "operation.denied",
  "data": {
    "operation_id": "...",
    "reason": "Motivo da negacao"
  }
}

operation.cancelled​

Operacao cancelada pelo originador.

{
  "event_type": "operation.cancelled",
  "data": {
    "operation_id": "...",
    "cancelled_at": "2026-06-01T12:00:00Z"
  }
}

title.paid​

Titulo individual totalmente liquidado.

{
  "event_type": "title.paid",
  "data": {
    "title_id": "...",
    "operation_id": "...",
    "face_value": "10000.00",
    "total_returned_value": "10000.00",
    "fully_returned_at": "2026-08-15T10:00:00Z"
  }
}

title.partially_paid​

Pagamento parcial recebido em um titulo.

{
  "event_type": "title.partially_paid",
  "data": {
    "title_id": "...",
    "operation_id": "...",
    "payment_amount_brl": "5000.00",
    "outstanding_brl": "5000.00"
  }
}

operation.overdue​

Um ou mais titulos da operacao venceram sem pagamento total.

{
  "event_type": "operation.overdue",
  "data": {
    "operation_id": "...",
    "overdue_titles_count": 2,
    "total_outstanding_brl": "5000.00"
  }
}

stock.item_registered​

Recebivel registrado no estoque.

{
  "event_type": "stock.item_registered",
  "data": {
    "stock_item_id": "...",
    "external_id": "NF-2026-001",
    "face_value": "10000.00"
  }
}