*API REST › Objetos › Finanzas*

# Pago

> Un cobro o un pago registrado en tesorería.

Un cobro o un pago registrado en una cuenta de tesorería, con su sentido (`in` o `out`), importe, moneda, fecha y tipo. Un pago puede vincularse a varios documentos, que lista `linkedDocuments`. Lista los pagos de una factura con [`GET /api/v1/invoices/{invoiceId}/payments`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/list-the-payments-of-an-invoice). Los pagos se crean y se corrigen desde fuera, y las cuentas de tesorería por las que pasan no.

Esquemas: `PaymentDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador del pago. |
| `direction` | string | in cuando entra dinero (un cobro) y out cuando sale (un pago). |
| `amount` | string | Importe del pago como cadena decimal, en la moneda indicada. |
| `currency` | string | Moneda del pago, como código ISO 4217. |
| `date` | string<date-time> | Fecha del pago en ISO 8601 UTC. |
| `type` | string | normal, o deposit cuando es un pago anticipado. |
| `treasuryAccountId` | string | Cuenta de tesorería por la que pasa el pago. |
| `contactId` | string | Cliente o proveedor del pago; null si no se ha declarado. |
| `reference` | string | Referencia externa del pago; null si no tiene. |
| `linkedDocuments` | object[] | Documentos a los que está asignado el pago; vacío si no está vinculado a ninguno. |
| `linkedDocuments.type` | string | Tipo del documento vinculado. `invoice`, `creditNote`, `supplierInvoice`, `quote`, `proforma`, `salesReceipt`, `simpleCreditNote`, `purchaseOrder` |
| `linkedDocuments.id` | string | Identificador del documento vinculado. |
| `linkedDocuments.amount` | string | Importe de este pago asignado al documento, como cadena decimal. |
| `createdAt` | string<date-time> | Fecha de creación en ISO 8601 UTC. |
| `updatedAt` | string<date-time> | Fecha de la última modificación en ISO 8601 UTC. |

## Ejemplo

*Payment · Generado a partir del esquema*

```json
{
  "id": "id_8f2a1c",
  "direction": "string",
  "amount": "1234.50",
  "currency": "EUR",
  "date": "2026-09-01T08:00:00Z",
  "type": "string",
  "treasuryAccountId": "string",
  "contactId": "string",
  "reference": "string",
  "linkedDocuments": [
    {
      "type": "invoice",
      "id": "id_8f2a1c",
      "amount": "1234.50"
    }
  ],
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Lo devuelven

- [`GET /api/v1/invoices/{invoiceId}/payments`](https://docs.filmo.io/es/rest-api/endpoint-reference/invoices/list-the-payments-of-an-invoice) — Listar los pagos de una factura
- [`GET /api/v1/treasury/payments`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/list-treasury-payments) — Listar pagos de tesorería
- [`GET /api/v1/treasury/payments/{paymentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/get-a-payment) — Obtener un pago

## Lo modifican

- [`POST /api/v1/treasury/payments`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/record-an-incoming-or-outgoing-payment) — Registrar un pago entrante o saliente
- [`PATCH /api/v1/treasury/payments/{paymentId}`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/update-a-payment) — Actualizar un pago
- [`POST /api/v1/treasury/payments/{paymentId}/links`](https://docs.filmo.io/es/rest-api/endpoint-reference/treasury/link-a-payment-to-a-document) — Vincular un pago a un documento

---

URL canónica: https://docs.filmo.io/es/rest-api/objects/payment  
Última actualización: 2026-10-25