> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finup.ar/llms.txt
> Use this file to discover all available pages before exploring further.

# Flujo: pagos

> Registrar un pago (total o parcial) y leer los movimientos de un crédito.

# Flujo: pagos

Los pagos se registran **sobre una cuota**. Requiere una clave de
**acceso total**.

## 1. Ubicar la cuota

```bash theme={null}
curl "https://api.finup.ar/api/credits/$CREDIT_ID/installments" \
  -H "Authorization: Bearer $FINUP_API_KEY"
```

Cada cuota trae `id`, `number`, `amount`, `due_date` y `status`
(`pending` | `partial` | `paid`).

## 2. Registrar el pago

```bash theme={null}
curl --request POST \
  --url "https://api.finup.ar/api/installments/$INSTALLMENT_ID/payments" \
  --header "Authorization: Bearer $FINUP_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "amount": 58500 }'
```

Al registrar el pago, la API:

* crea el movimiento de tipo `payment`,
* recalcula el estado de la cuota y del crédito,

y devuelve el pago junto con las cuotas actualizadas:

```json theme={null}
{
  "payment": {
    "id": "…", "installment_id": "…", "type": "payment",
    "amount": 58500, "created_at": "2026-02-08T14:30:00.000Z"
  },
  "installments": [
    { "number": 1, "amount": 58500, "status": "paid" },
    { "number": 2, "amount": 58500, "status": "pending" }
  ]
}
```

## 3. Pagos parciales

Enviá un `amount` menor al de la cuota. La cuota queda en `partial` y el saldo
sigue pendiente. Podés registrar varios pagos parciales sobre la misma cuota.

## 4. Ver los movimientos

El **ledger** de un crédito lista cuotas, punitorios y pagos:

```bash theme={null}
curl "https://api.finup.ar/api/credits/$CREDIT_ID/ledger" \
  -H "Authorization: Bearer $FINUP_API_KEY"
```

| `type` | Qué representa |
| - | - |
| `installment` | El cargo original de la cuota. |
| `punitory` | Recargo diario por atraso (mora). |
| `payment` | Un pago registrado. |

<Warning>
  Registrar un pago **no es idempotente**: reintentar el mismo request crea otro
  pago. Si tu integración reintenta, verificá antes con el ledger.
</Warning>