# Pagamento recebido

Pagamento de parcela recebido

Endpoint: POST loan.payment_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.payment_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 do pagamento recebido

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

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

  - `data.payment` (object, required)

  - `data.payment.amount` (number, required)
    Valor monetário em BRL
    Example: 25000

  - `data.payment.paid_at` (integer, required)
    Epoch Unix em segundos de quando o pagamento foi recebido

  - `data.payment.installment_number` (integer, required)
    Número da parcela paga

## 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