# Loan payment received

Fires when an installment payment is recorded for the loan. Includes the amount
paid, payment date, and corresponding installment number. Use it to update the
outstanding balance in your system and notify the customer about the payment confirmation.

Endpoint: POST loan.payment_received
Version: 2026-03-01
Security: bearerAuth

## Request fields (application/json):

  - `type` (string, required)
    Event type identifier
    Enum: "loan.payment_received"

  - `timestamp` (string, required)
    When the event occurred

  - `data` (object, required)

  - `data.id` (string, required)

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

  - `data.payment` (object, required)

  - `data.payment.amount` (string, required)
    Decimal encoded as a string with exactly 2 decimal places (BRL).

  - `data.payment.paid_at` (string, required)

  - `data.payment.installment_number` (integer, required)


## Response 200 fields