TRtrytoku
Subscriptions

Listar Subscriptions de un Customer

Changed on

Devuelve todas las Subscriptions de un Customer.

Se usa para revisar los cobros recurrentes y puntuales asociados a un Customer específico dentro de la organización autenticada.

Límite de tasa: 20 solicitudes por segundo. Al superarlo, la API responde 429. Ver Límites de tasa.

get/subscriptions/customer/{customer_id}

Request

  • Base URL
    https://api.trytoku.com
  • URL
    https://api.trytoku.com/subscriptions/customer/{customer_id}
  • Auth
    API key in header x-api-key

Path parameters

customer_idstring required

Identificador público del Customer (cus_...) cuyas Subscriptions se listan.

Example:cus_ejC08yLqOWoFhVx4Fx42E3IR9X50tNx2

Headers

x-account-keystring

Llave de API de una Account, para operar sobre esa Account en lugar de la principal.

x-api-versionstring date

Versión del API para esta petición, como cualquier fecha YYYY-MM-DD. Fija el contrato de la respuesta; si se omite, se deriva de la fecha de creación de la organización.

Example:2026-10-08

Response

Subscriptions que pertenecen al Customer.

amountnumber

Monto de las deudas generadas por la suscripción, expresado en la moneda indicada por currency_code.

currency_code'CLP' | 'CLF' | 'MXN' | 'BRL' | 'USD'

Moneda, en código ISO 4217. Cubre las monedas de los países donde Toku opera —CLP (peso chileno), MXN (peso mexicano) y BRL (real)— más USD y CLF, la Unidad de Fomento chilena. La moneda determina cuántos decimales admiten los montos: CLP no admite decimales, MXN, BRL y USD admiten dos, y CLF cuatro.

customerstring required

Identificador público del cliente dueño de la suscripción.

due_dayinteger

Día de vencimiento de las deudas. Para las frecuencias mensual y anual es el día del mes (1–31); para la semanal, el día de la semana (1 = lunes).

idstring required

Identificador público de la suscripción.

id_accountstring required

Identificador público de la cuenta a la que pertenece la suscripción.

is_recurringboolean

Indica si la suscripción es recurrente, es decir, si genera deudas de forma periódica y automática.

metadataobject

Campos adicionales definidos por la organización para la suscripción.

pac_mandate_idstring

Identificador del mandato PAC asociado a la suscripción.

product_idstring required

Identificador del producto de la organización asociado a la suscripción.

receipt_product_codestring

Código de producto usado al emitir el documento tributario de la suscripción.

Example response

[
  {
    "customer": "cus_ejC08yLqOWoFhVx4Fx42E3IR9X50tNx2",
    "id": "sub_Y_EgOXMloD5-IJn6d9S2IxkNvp9p0iiP",
    "id_account": "acc_gzD0XoUTFxbUFcItpWOCqN686noSd9HQ"
  }
]

Changes