---
title: "Listar Payment Methods con datos del Customer"
method: GET
path: "/organization/payment_methods"
tags: ["Payment Methods"]
---

# Listar Payment Methods con datos del Customer

`GET /organization/payment_methods`

## Request

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

Devuelve los Payment Methods de la organización autenticada en formato plano, con los datos del Customer y de la Subscription ya incorporados en cada elemento.

A diferencia del listado agregado de Payment Methods, cada elemento trae directamente los campos del Customer (nombre, correo, teléfono e identificador tributario), los de la tarjeta y los del mandato PAC, además de las llaves de metadata de Customer y de Subscription que la organización tenga configuradas.

No incluye los Payment Methods eliminados, ni los que tienen la inscripción en curso o fallida, ni los que están en proceso de borrado definitivo.

`page_size` se limita a 500 y, si se omite, se usan 10 elementos por página. Responde 404 cuando ningún Payment Method cumple los filtros.

## Query parameters

- `page` integer: Página a devolver, partiendo de 1.
- `page_size` integer: Cantidad de Payment Methods por página. Si se omite se usan 10 y el máximo aceptado es 500.
- `start_date` string, date: Devuelve solo los Payment Methods inscritos desde esta fecha, en formato `YYYY-MM-DD`.
- `end_date` string, date: Devuelve solo los Payment Methods inscritos antes de esta fecha, en formato `YYYY-MM-DD`. La fecha indicada queda excluida.
- `id_bulk_insertion` string: Devuelve solo los Payment Methods inscritos en esta carga masiva.
- `id_data_in_file` string: Devuelve solo los Payment Methods vinculados a este registro de un archivo cargado.

## Headers

- `x-account-key` string

## Response `200`

Successful Response

- OrganizationPaymentMethodResponse[]
  - `account_name` string: Nombre de la Account bajo la que está el Payment Method.
  - `card_bank_name` string: Banco emisor de la tarjeta inscrita.
  - `card_brand` string: Marca de la tarjeta inscrita. Llega con valor solo en medios de pago con tarjeta.
  - `card_number` string: Dígitos visibles de la tarjeta inscrita, sin los caracteres de enmascaramiento. Llega con valor solo en medios de pago con tarjeta.
  - `card_type` string: Modalidad de la tarjeta inscrita. Llega con valor solo en medios de pago con tarjeta.
  - `created_at` string, required: Fecha y hora en que se inscribió el Payment Method.
  - `customer` string: Customer dueño del Payment Method. Llega en `null` cuando el medio de pago no tiene Customer asociado.
  - `deleted_at` string: Fecha y hora de eliminación del Payment Method. En este listado siempre llega en `null`.
  - `external_id` string: Identificador del Customer en el sistema de la organización.
  - `gateway` string: Nombre legible del producto con el que se inscribió el medio de pago.
  - `government_id` string: Identificador tributario del Customer.
  - `holder_name` string: Nombre del titular del mandato PAC.
  - `id` string, required: Payment Method al que corresponde el elemento.
  - `last_payment_intent_response_code` integer: Código con que respondió el último intento de cobro. Es `null` cuando no hay un intento registrado o cuando el código fue `0`.
  - `mail` string: Correo del Customer.
  - `name` string: Nombre del Customer.
  - `pac_account_number` string: Número de cuenta inscrito en el mandato PAC.
  - `pac_account_type` string: Tipo de cuenta inscrito en el mandato PAC.
  - `pac_government_id` string: Identificador tributario del titular del mandato PAC.
  - `pac_institution_name` string: Institución donde está inscrito el mandato PAC.
  - `pac_mandate_id` string: Identificador del mandato PAC en la institución.
  - `pac_voucher_url` string: Enlace al comprobante del mandato PAC. No se incluye cuando la organización tiene los comprobantes restringidos.
  - `phone_number` string: Teléfono del Customer.
  - `product_id` string: `product_id` de la Subscription que se cobra con este Payment Method.
  - `status` string: Estado del Payment Method dentro de su ciclo de vida.
  - `token` string: Token con que el proveedor identifica el medio de pago inscrito.

## Other responses

- `401`: Faltan las credenciales o son inválidas.
- `403`: No tienes acceso a este recurso.
- `404`: Ningún Payment Method cumple los filtros enviados.
- `422`: El cuerpo de la petición no pasó la validación.
- `429`: Se superó el límite de peticiones permitidas.

## Changes

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

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/organization/payment_methods/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)