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

# Listar payment intents

> Obtiene una lista paginada de payment intents (intentos de pago) de tu compañía

### Query Parameters

<ParamField query="filter[id]" type="string">
  ID único del payment intent
</ParamField>

<ParamField query="filter[status]" type="string">
  Filtra por estado. Valores posibles: created, paid, processing, failed, refunded, disputed.
</ParamField>

<ParamField query="filter[external_id]" type="string">
  Identificador externo definido por tu sistema para correlacionar transacciones.
</ParamField>

<ParamField query="sort" type="string">
  Ordena los resultados. Valores: created\_at | -created\_at | paid\_at | -paid\_at
</ParamField>

<ParamField query="page" type="number">
  Página a consultar (paginación base 1). Por defecto: 1
</ParamField>

### Response

<ResponseField name="data" type="array">
  Lista de payment intents

  <Expandable title="Ver objeto">
    <ResponseField name="id" type="string">Identificador único (UUID)</ResponseField>
    <ResponseField name="description" type="string">Descripción del cobro</ResponseField>
    <ResponseField name="amount" type="number">Monto del cobro en unidades monetarias (no centavos)</ResponseField>
    <ResponseField name="amount_label" type="string">Monto formateado con moneda</ResponseField>
    <ResponseField name="currency" type="string">Moneda. Ej: COP</ResponseField>
    <ResponseField name="status" type="string">Estado actual</ResponseField>
    <ResponseField name="payment_method_type" type="string">Tipo del método de pago (CreditCard, Account, Wallet, etc.)</ResponseField>
    <ResponseField name="payment_method_id" type="string">ID del método de pago</ResponseField>
    <ResponseField name="source" type="object">Origen del cobro (Link, Payment, Plan, Subscription). Puede variar según el caso.</ResponseField>
    <ResponseField name="created_at" type="string">Fecha de creación (ISO 8601)</ResponseField>
    <ResponseField name="paid_at" type="string|null">Fecha de pago si aplica</ResponseField>
    <ResponseField name="remarks" type="object|null">Observaciones o marcas internas</ResponseField>
    <ResponseField name="is_test" type="boolean">Indica si pertenece al entorno de pruebas</ResponseField>
    <ResponseField name="network_id" type="string|null">ID de la red/proveedor si aplica</ResponseField>
    <ResponseField name="external_id" type="string|null">ID externo proporcionado por tu sistema</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="current_page" type="number">Página actual</ResponseField>
<ResponseField name="from" type="number|null">Índice inicial del listado</ResponseField>
<ResponseField name="last_page" type="number">Número total de páginas</ResponseField>
<ResponseField name="per_page" type="number">Tamaño de página (por defecto 20)</ResponseField>
<ResponseField name="to" type="number|null">Índice final del listado</ResponseField>
<ResponseField name="total" type="number">Total de registros</ResponseField>

### Response Example

<ResponseExample>
  ```json 200 theme={null}
  {
    "current_page": 1,
    "from": 1,
    "last_page": 3,
    "per_page": 20,
    "to": 20,
    "total": 50,
    "data": [
      {
        "id": "a1b2c3d4-1111-2222-3333-444455556666",
        "description": "Cargo suscripción Premium",
        "amount": 63040,
        "amount_label": "$63.040",
        "currency": "COP",
        "status": "processing",
        "payment_method_type": "CreditCard",
        "payment_method_id": "3f8b7a21-1d4a-4d2e-8f1a-17e2f1e6b9ab",
        "source": {
          "type": "Link",
          "id": "9b7e45b5-05e2-4b4e-bb1c-3d8a6a3c15e2"
        },
        "created_at": "2024-11-02T16:47:09.000000Z",
        "paid_at": null,
        "remarks": null,
        "is_test": true,
        "network_id": null,
        "external_id": null
      },
      {
        "id": "7777c3d4-8888-9999-aaaa-bbbbccccdddd",
        "description": "Pago factura 001-2024",
        "amount": 250000,
        "amount_label": "$250.000",
        "currency": "COP",
        "status": "paid",
        "payment_method_type": "Account",
        "payment_method_id": "8d3fe7c0-6f0c-4de0-99d2-4c86f4f0a9f0",
        "source": {
          "type": "Payment",
          "id": "12e34567-89ab-4cde-f012-3456789abcde"
        },
        "created_at": "2024-10-20T12:00:00.000000Z",
        "paid_at": "2024-10-20T12:10:10.000000Z",
        "remarks": null,
        "is_test": true,
        "network_id": "prov-123",
        "external_id": "EXT-12345"
      }
    ]
  }
  ```
</ResponseExample>