---
title: "Listar Payments"
method: GET
path: "/organization/payments"
tags: ["Payments"]
---

# Listar Payments

`GET /organization/payments`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/organization/payments`
- Auth: API key in header `x-api-key`

Devuelve los Payments de la organización autenticada, paginados y ordenados por fecha.

Cada elemento trae el detalle del cobro junto con la Invoice, el Customer y el medio de pago asociados, de modo que no hace falta consultar esas entidades por separado.

La paginación se recorre incrementando `page` hasta que la respuesta sea `404`, que es la forma en que esta operación indica que no quedan Payments para los filtros usados.

**Límite de tasa:** 20 solicitudes por hora. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa).

## Query parameters

- `page` integer, required: Número de página a consultar. Comienza en 1.
- `start_date` string, date: Fecha desde la que se incluyen Payments, según su fecha de creación, en formato `YYYY-MM-DD`.
- `end_date` string, date: Fecha hasta la que se incluyen Payments, según su fecha de creación, en formato `YYYY-MM-DD`. El día indicado queda incluido.
- `page_size` integer: Cantidad de Payments por página.

## Response `200`

Successful Response

- APIPaymentResponse[]
  - `amount_paid` number: Monto efectivamente pagado. Puede diferir de `payment_amount` cuando el pago se hizo con un cupón de pago y el Customer pagó un monto distinto al emitido.
  - `authorization_code` string: Código de autorización que entregó el medio de pago al aprobar la transacción.
  - `buy_order` string: Número de orden de compra que el medio de pago asignó a la transacción.
  - `card_number` string: Últimos dígitos de la tarjeta usada en el cobro. Es `null` si el cobro no fue con tarjeta.
  - `card_type` string: Marca de la tarjeta usada en el cobro. Es `null` si el cobro no fue con tarjeta.
  - `created_at` string, required: Fecha y hora en que se registró el Payment, en formato ISO 8601.
  - `customer` string, required: Identificador público del Customer que realizó el Payment. Queda vacío si no hay Customer asociado.
  - `deleted_at` string: Fecha y hora en que el Payment fue eliminado, en formato ISO 8601. Es `null` si sigue vigente.
  - `due_date` string: Fecha de vencimiento de la Invoice que el Payment salda.
  - `government_id` string: Identificador tributario del Customer (RUT en Chile, CPF/CNPJ en Brasil).
  - `id` string, required: Identificador público del Payment.
  - `invoice` string, required: Identificador público de la Invoice que el Payment salda. Queda vacío si el Payment no tiene Invoice asociada.
  - `mc_order_id` string: Identificador de la orden en el proveedor de recaudación que procesó el cobro.
  - `name` string: Nombre del Customer que realizó el Payment.
  - `payment_amount` number: Monto cobrado en la transacción, en la moneda de la Invoice.
  - `payment_method` string: Nombre del medio de pago con que se cobró (por ejemplo la tarjeta o el proveedor de recaudación).
  - `payment_type` string: Modalidad de la tarjeta con que se cobró: `Credit`, `Debit` o `Prepaid`.
  - `processed_by_toku` boolean, required: Indica si el cobro fue procesado por Toku. Es `false` cuando la organización registró un pago conciliado fuera de la plataforma.
  - `product_id` string: Identificador del producto o servicio que la organización cobra en la Invoice.
  - `transaction_date` string: Fecha y hora en que la transacción fue procesada por el medio de pago, en formato ISO 8601.

## Other responses

- `400`: El parámetro `page` es menor que 1.
- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: No existen Payments que cumplan los filtros indicados.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se alcanzó el límite de consultas permitido para la organización.

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/organization/payments/get.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)