# Assinatura recebida

Um signatário concluiu sua assinatura

Endpoint: POST loan.signature_received
Version: 2026-03-01
Security: webhookSignature

## Security:

  - `webhookSignature` (unknown)
    apiKey in header webhook-signature

## Header parameters:

  - `webhook-id` (string, required)
    ID único da entrega. Use como chave de idempotência para deduplicar eventos

  - `webhook-timestamp` (integer, required)
    Timestamp Unix da tentativa de entrega. Rejeite se anterior a 5 minutos (proteção contra replay)

  - `webhook-signature` (string, required)
    Assinatura(s) HMAC-SHA256 para verificação conforme spec Standard Webhooks

## Request fields (application/json):

  - `id` (string, required)
    Identificador único do evento de webhook
    Example: evt_550e8400e29b41d4a716446655440000

  - `type` (string, required)
    Tipo do evento
    Enum: "loan.signature_received"

  - `api_version` (string, required)
    Versão da API
    Example: 2026-03-01

  - `created_at` (integer, required)
    Epoch Unix em segundos

  - `delivery_id` (string, required)
    ID único da entrega

  - `timestamp` (integer, required)
    Epoch Unix em segundos

  - `data` (object)
    Dados da assinatura recebida

  - `data.id` (string, required)
    Identificador único do empréstimo
    Example: ln_550e8400e29b41d4a716446655440000

  - `data.status` (string, required)
    Enum: "awaiting_signatures"

  - `data.signer` (object, required)

  - `data.signer.name` (string, required)
    Nome do signatário

  - `data.signer.cpf` (string, required)
    CPF do signatário

  - `data.signer.signed_at` (integer, required)
    Epoch Unix em segundos de quando a assinatura foi capturada

  - `data.signatures_received` (integer, required)
    Número de assinaturas coletadas até o momento

  - `data.signatures_required` (integer, required)
    Número total de assinaturas necessárias

## Response 200:

  - `200` (unknown)
    Entrega confirmada

## Response 410:

  - `410` (unknown)
    Endpoint desativado permanentemente

## Response 429:

  - `429` (unknown)
    Rate-limiting, taxa de envio reduzida

## Response 502:

  - `502` (unknown)
    Sobrecarga do servidor, taxa reduzida antes de retentar

## Response 504:

  - `504` (unknown)
    Timeout do gateway, taxa reduzida antes de retentar

## Response 4XX:

  - `4XX` (unknown)
    Erro de cliente, falha dispara retentativa

## Response 5XX:

  - `5XX` (unknown)
    Erro de servidor, falha dispara retentativa