# Módulo de pagos

El módulos de **Pagos (Payments)** permiten acceder a los movimientos financieros asociados a reservas. Comparten la misma estructura de autenticación y respuesta que los módulos anteriores.

#### **Obtener listado paginado de pagos**

**Función:** obtener una lista paginada de pagos, permitiendo filtrar por fechas, reserva, moneda, método de pago, pagador o IDs específicos.

[![image.png](https://v4.docs.airvi.com.co/uploads/images/gallery/2025-11/scaled-1680-/2I0G9tJA3chCI9tn-image.png)](https://v4.docs.airvi.com.co/uploads/images/gallery/2025-11/2I0G9tJA3chCI9tn-image.png)

---

**Parámetros disponibles**

<div class="_tableContainer_1rjym_1" id="bkmrk-par%C3%A1metro-descripci%C3%B3"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="1566" data-start="861" style="width: 90.3571%; height: 294px;"><thead data-end="888" data-start="861"><tr data-end="888" data-start="861" style="height: 38.7969px;"><th data-col-size="sm" data-end="873" data-start="861" style="width: 50.0596%; height: 38.7969px;">Parámetro</th><th data-col-size="md" data-end="888" data-start="873" style="width: 50.0596%; height: 38.7969px;">Descripción</th></tr></thead><tbody data-end="1566" data-start="916"><tr data-end="978" data-start="916" style="height: 35.7969px;"><td class="align-left" data-col-size="sm" data-end="927" data-start="916" style="width: 50.0596%; height: 35.7969px;">**take**</td><td class="align-left" data-col-size="md" data-end="978" data-start="927" style="width: 50.0596%; height: 35.7969px;">Cantidad de registros a retornar (obligatorio).</td></tr><tr data-end="1025" data-start="979" style="height: 29.7969px;"><td data-col-size="sm" data-end="990" data-start="979" style="width: 50.0596%; height: 29.7969px;">**skip**</td><td data-col-size="md" data-end="1025" data-start="990" style="width: 50.0596%; height: 29.7969px;">Cantidad de registros a omitir.</td></tr><tr data-end="1101" data-start="1026" style="height: 29.7969px;"><td data-col-size="sm" data-end="1053" data-start="1026" style="width: 50.0596%; height: 29.7969px;">**filters\[payment\_ids\]**</td><td data-col-size="md" data-end="1101" data-start="1053" style="width: 50.0596%; height: 29.7969px;">IDs de pagos separados por comas (opcional).</td></tr><tr data-end="1173" data-start="1102" style="height: 29.7969px;"><td data-col-size="sm" data-end="1132" data-start="1102" style="width: 50.0596%; height: 29.7969px;">**filters\[reservation\_id\]**</td><td data-col-size="md" data-end="1173" data-start="1132" style="width: 50.0596%; height: 29.7969px;">ID de la reserva asociada (opcional).</td></tr><tr data-end="1254" data-start="1174" style="height: 29.7969px;"><td data-col-size="sm" data-end="1199" data-start="1174" style="width: 50.0596%; height: 29.7969px;">**filters\[date\_from\]**</td><td data-col-size="md" data-end="1254" data-start="1199" style="width: 50.0596%; height: 29.7969px;">Fecha inicial del rango de pago (Y-m-d) (opcional).</td></tr><tr data-end="1331" data-start="1255" style="height: 29.7969px;"><td data-col-size="sm" data-end="1278" data-start="1255" style="width: 50.0596%; height: 29.7969px;">**filters\[date\_to\]**</td><td data-col-size="md" data-end="1331" data-start="1278" style="width: 50.0596%; height: 29.7969px;">Fecha final del rango de pago (Y-m-d) (opcional).</td></tr><tr data-end="1411" data-start="1332" style="height: 29.7969px;"><td data-col-size="sm" data-end="1361" data-start="1332" style="width: 50.0596%; height: 29.7969px;">**filters\[currency\_code\]**</td><td data-col-size="md" data-end="1411" data-start="1361" style="width: 50.0596%; height: 29.7969px;">Código de moneda del pago, ej: USD (opcional).</td></tr><tr data-end="1487" data-start="1412" style="height: 29.7969px;"><td data-col-size="sm" data-end="1434" data-start="1412" style="width: 50.0596%; height: 29.7969px;">**filters\[method\]**</td><td data-col-size="md" data-end="1487" data-start="1434" style="width: 50.0596%; height: 29.7969px;">Slug del método de pago, ej: efectivo (opcional).</td></tr><tr data-end="1566" data-start="1488" style="height: 29.7969px;"><td data-col-size="sm" data-end="1524" data-start="1488" style="width: 50.0596%; height: 29.7969px;">**filters\[payer\_identification\]**</td><td data-col-size="md" data-end="1566" data-start="1524" style="width: 50.0596%; height: 29.7969px;">Identificación del pagador (opcional).</td></tr></tbody></table>

</div></div>---

**Pasos para ejecutar la consulta**

1. Ingrese a `{BASE_URL}/api/public/v1/payments`
2. Busque la sección **payments→ Listado paginado de pagos**.
3. En el campo **take**, indique cuántos registros desea obtener (por ejemplo, 10).
4. Si lo necesita, agregue filtros como:
    
    
    - `date_from` y `date_to` para un rango de fechas.
    - `reservation_id` si quiere pagos de una reserva específica.
    - `currency_code`, `method` o `payer_identification`.
5. Pulse **“Enviar petición”**.
6. Verifique la respuesta: si la solicitud es correcta, recibirá un **código 200 OK** con los datos paginados.

#### **Consultar Información de un pago en especifico por ID**

**Función:** obtener la información básica y detallada de un pago identificado por su `{id}`.

[![image.png](https://v4.docs.airvi.com.co/uploads/images/gallery/2025-11/scaled-1680-/82Hz0JBBDvqTlCtp-image.png)](https://v4.docs.airvi.com.co/uploads/images/gallery/2025-11/82Hz0JBBDvqTlCtp-image.png)

**Parámetros disponibles**

<div class="_tableContainer_1rjym_1" id="bkmrk-par%C3%A1metro-tipo-descr"><div class="group _tableWrapper_1rjym_13 flex w-fit flex-col-reverse" tabindex="-1"><table class="w-fit min-w-(--thread-content-width)" data-end="919" data-start="766"><thead data-end="800" data-start="766"><tr data-end="800" data-start="766"><th data-col-size="sm" data-end="778" data-start="766">Parámetro</th><th data-col-size="sm" data-end="785" data-start="778">Tipo</th><th data-col-size="md" data-end="800" data-start="785">Descripción</th></tr></thead><tbody data-end="919" data-start="836"><tr data-end="919" data-start="836"><td data-col-size="sm" data-end="845" data-start="836">**id**</td><td data-col-size="sm" data-end="855" data-start="845">integer</td><td data-col-size="md" data-end="919" data-start="855">Identificador del pago que se desea consultar (obligatorio).</td></tr></tbody></table>

</div></div>**Ejemplo:** `87`

---

**Pasos para ejecutar la consulta**

1. Ingrese a `{BASE_URL}/api/public/v1/payments`
2. Busque la sección **payments → Consultar información de un pago por ID**.
3. En el campo **id**, escriba el identificador del pago que desea consultar.
4. Pulse **“Enviar petición”**.
5. Si el registro existe, recibirá un **código 200 OK** con toda la información del pago.
6. Si el pago no se encuentra, el sistema responderá con **404 NOT\_FOUND**.
7. Ante errores inesperados, retornará **500 INTERNAL\_ERROR**.