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

# Pagos

> Reporta pagos verificados, consulta su aplicación y completa conversiones certificadas

<div className="cobrix-category">
  <strong>Una entrada financiera controlada, no una simple actualización de estado.</strong>
  <p>Los montos usan unidades menores. Cobrix valida documentos, saldo, moneda e idempotencia antes de aplicar el pago al ledger.</p>
</div>

<div className="cobrix-scope-line">
  <span className="cobrix-scope">verified\_payments:write</span>
  <span className="cobrix-scope">payments:read</span>
  <span className="cobrix-scope">certified\_rates:write</span>
</div>

## Operaciones

| Permiso del drawer         | Scope                     | Método y ruta                                                                   |
| -------------------------- | ------------------------- | ------------------------------------------------------------------------------- |
| Listar y consultar pagos   | `payments:read`           | `GET /integrations/v1/{companyId}/payments`                                     |
| Listar y consultar pagos   | `payments:read`           | `GET /integrations/v1/{companyId}/payments/{externalPaymentId}`                 |
| Reportar pagos verificados | `verified_payments:write` | `POST /integrations/v1/{companyId}/verified-payments`                           |
| Cargar tasas certificadas  | `certified_rates:write`   | `POST /integrations/v1/{companyId}/payments/{externalPaymentId}/certified-rate` |

<Tabs>
  <Tab title="Reportar">
    Envía `source`, `externalPaymentId`, cliente, `amountMinor`, moneda, `verifiedAt` y los documentos a aplicar. El header `Idempotency-Key` es obligatorio.
  </Tab>

  <Tab title="Consultar">
    Filtra por estado, estado operativo, pago externo, cliente, source, proveedor, moneda, rango de pago o `updatedSince`.
  </Tab>

  <Tab title="Certificar tasa">
    Si el pago queda en `needs_certified_rate`, envía moneda y monto de referencia, `exchangeRateUsed`, fecha efectiva y distribución entre documentos.
  </Tab>
</Tabs>

## Estados operativos

| Estado                 | Qué significa                            | Próxima acción                           |
| ---------------------- | ---------------------------------------- | ---------------------------------------- |
| `applied`              | Pago aplicado completamente              | Ninguna                                  |
| `partially_applied`    | Solo parte pudo aplicarse                | Consulta el detalle y saldo restante     |
| `credited`             | Existe remanente registrado como crédito | Revisa `creditCreatedMinor`              |
| `needs_certified_rate` | Falta una tasa aprobada                  | Envía la tasa certificada                |
| `no_open_documents`    | No había documentos aplicables           | Corrige la selección antes de reintentar |
| `already_processed`    | La intención ya fue procesada            | Reutiliza la respuesta existente         |
| `failed`               | La aplicación no terminó                 | Busca `requestId` y detalle en Auditoría |

<Warning>
  No inventes una tasa ni reenvíes el pago con otro identificador para superar un conflicto. Consulta primero el pago existente; duplicar la intención puede producir una doble aplicación.
</Warning>

<Columns cols={2}>
  <Card title="Reportar pago" icon="circle-check" href="/api-reference/pagos/reportar-pago-verificado" cta="Ver contrato" arrow>
    Revisa distribución, moneda, timestamp y respuestas financieras.
  </Card>

  <Card title="Consultar pagos" icon="magnifying-glass" href="/api-reference/pagos/listar-pagos" cta="Ver filtros" arrow>
    Confirma el resultado operativo antes de ejecutar acciones posteriores.
  </Card>
</Columns>