---
title: "Listar pagos"
method: GET
path: "/api/v4/integration/cash-in/payments"
---

# Listar pagos

`GET /api/v4/integration/cash-in/payments`

## Request

- Base URL: `https://api-sandbox.atratopago.com`
- URL: `https://api-sandbox.atratopago.com/api/v4/integration/cash-in/payments`
- Auth: API key in header `x-auth-token`
- TypeScript: <https://skmtc.dev/atratopago/apis/api-partners/docs/api/v4/integration/cash-in/payments/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `paymentId` integer
- `minDate` string, date
- `maxDate` string, date
- `minAmount` number
- `maxAmount` number
- `stores` string
- `status` 'success' | 'pending_conciliation'
- `page` integer
- `limit` integer
- `orderBy` 'paymentDate' | 'paymentAmount' | 'paymentId'
- `orderDirection` 'ASC' | 'DESC'

## Response `200`

Lista de pagos.

- object
  - `totalPayments` integer, required: Total de pagos según el filtro.
  - `totalAmount` number, required: Monto total según el filtro.
  - `data` object[], required
    - `globalPaymentId` integer, required
    - `status` 'success' | 'pending_conciliation', required
    - `totalAmount` number, required
    - `paymentDate` string, date-time, required: En hora de México (ISO 8601 con offset).
    - `storeName` string, required

## Other responses

- `400`: Parámetros incorrectos.
- `401`: Token faltante, inválido o vencido, o la cuenta no tiene acceso a la integración.

## Changes

- **2026-11-03** `0d08bf95374b`: 5 breaking, 3 info
  - for the `query` request parameter `limit`, default value was changed from `10` to `10`
  - for the `query` request parameter `page`, default value was changed from `0` to `0`
  - removed the enum value `cancelled` from the `query` request parameter `status`
  - for the `query` request parameter `paymentId`, the type changed from `string` to `integer`
  - …4 more

[Operation history](https://skmtc.dev/atratopago/apis/api-partners/changes/api/v4/integration/cash-in/payments/get.md)

---

[API](https://skmtc.dev/atratopago/apis/api-partners.md) - [All operations](https://skmtc.dev/atratopago/apis/api-partners/llms.txt) - [OpenAPI document](https://skmtc.dev/atratopago/apis/api-partners/revisions/0d08bf95374b?raw)