Subscription Transactions - Kushki Developer Portal

El endpoint Subscription Transactions te permite consultar todo el historial de transacciones cobradas bajo una suscripción específica en Chile 🇨🇱. Úsalo para conciliación, soporte y auditorías de facturación — sin necesidad de entrar a la Kushki Console.

ℹ️ Este endpoint está disponible para los modelos de integración Adquirencia y Agregador.

Inicio rápido

GET /data/v1/subscription/{subscriptionId}?start=2026-05-01&end=2026-05-31&size=50

Parámetro	En	Obligatorio	Descripción
`subscriptionId`	path	✅	Identificador único de la suscripción — se devuelve al crear una suscripción
`start`	query	Opcional	Fecha inicial — `YYYY-MM-DD`. Por defecto, 5 días antes de la solicitud
`end`	query	Opcional	Fecha final — `YYYY-MM-DD`. Por defecto, el momento en que se hace la solicitud
`size`	query	Opcional	Máximo de transacciones a devolver. Por defecto: `100`

Estructura de la respuesta

Una respuesta exitosa devuelve el detalle de la suscripción y un array transactions con todos los cargos del rango de fechas solicitado.

{
  "active_indicator": true,
  "subscription_code": "1725484000756000",
  "plan_name": "Plan mensual",
  "periodicity_type": "custom",
  "amount_object": {
    "currency": "CLP",
    "subtotalIva0": 10000,
    "subtotalIva": 0,
    "iva": 0,
    "ice": 0
  },
  "card_holder_name": "Catalina Fuentes",
  "card_type": "credit",
  "last_four_digit_code": "9969",
  "expiry_month": "06",
  "expiry_year": "27",
  "contact_details_object": {
    "email": "user@example.com",
    "firstName": "Catalina",
    "lastName": "Fuentes"
  },
  "bin_info_object": {
    "bank": "BANCO SANTANDER CHILE",
    "bin": "521892",
    "brand": "MASTERCARD",
    "info": {
      "country": {
        "alpha3": "CHL",
        "name": "Chile"
      },
      "type": "credit"
    }
  },
  "merchant_code": "20000000109815430000",
  "merchant_country_name": "Chile",
  "create_timestamp": 1760313600,
  "start_timestamp": 1760313600,
  "last_charge_timestamp": 1760313600,
  "transactions": [
    {
      "_id": "491915787351730000",
      "approved_transaction_amount": 10000,
      "currency_code": "CLP",
      "response_code": "000",
      "response_description": "Transacción aprobada",
      "card_holder_name": "Catalina Fuentes",
      "card_type": "credit",
      "card_country_code": "CL",
      "card_country_name": "Chile",
      "payment_brand_name": "Mastercard",
      "payment_method_type": "CARD",
      "processor_name": "MC Processor",
      "subscription_trigger_type": "onDemand",
      "transaction_status_type": "APPROVED",
      "transaction_type": "SALE",
      "create_timestamp": 1774459991000
    }
  ]
}

Campos de la suscripción

Campo	Descripción
`active_indicator`	`true` si la suscripción está activa
`subscription_code`	Identificador único de la suscripción
`plan_name`	Nombre del plan de suscripción
`periodicity_type`	Ciclo de facturación — `daily`, `weekly`, `biweekly`, `monthly`, `threefortnights`, `bimonthly`, `quarterly`, `fourmonths`, `halfyearly`, `yearly` o `custom` (on demand)
`amount_object`	Monto y moneda del cargo de la suscripción
`card_holder_name`	Nombre del tarjetahabiente de la suscripción
`card_type`	`credit`, `debit` o `prepaid`
`last_four_digit_code`	Últimos 4 dígitos de la tarjeta
`expiry_month` / `expiry_year`	Mes (`MM`) / año (`YY`) de expiración de la tarjeta registrada
`contact_details_object`	Datos de contacto del cliente (email, nombre)
`bin_info_object`	Metadata del BIN de la tarjeta — banco, marca, tipo de tarjeta, país emisor
`create_timestamp`	Unix timestamp (segundos) en el que se creó la suscripción
`start_timestamp`	Unix timestamp en el que se hizo el primer cargo
`last_charge_timestamp`	Unix timestamp del cargo más reciente
`day_of_month`	Día del mes en el que cobra la suscripción (si es mensual)
`metadata_object`	Metadata personalizada asociada a la suscripción

Campos de la transacción

Cada elemento del array transactions representa un cargo:

Campo	Descripción
`_id`	ID interno de la transacción
`approved_transaction_amount`	Monto cobrado en CLP
`currency_code`	`CLP`
`response_code`	Código de respuesta del procesador (`000` = aprobada)
`response_description`	Mensaje de respuesta legible
`card_holder_name`	Nombre del tarjetahabiente como aparece en la transacción
`card_type`	`credit`, `debit` o `prepaid`
`card_country_code`	Código ISO 3166-1 alpha-2 del país emisor de la tarjeta
`payment_brand_name`	Marca de la tarjeta (Mastercard, Visa, etc.)
`payment_method_type`	`CARD`
`processor_name`	Nombre del procesador adquirente
`approval_code`	Código de autorización del banco
`subscription_trigger_type`	Cómo se disparó el cargo — `onDemand` (un solo clic) o `scheduled` (recurrente automático)
`transaction_status_type`	Estado final de la transacción — `APPROVED`, `DECLINED`, `INITIALIZED`, `VOIDED` o `REFUNDED`
`transaction_type`	`SALE`, `PREAUTHORIZATION`, `CAPTURE`, `VOID` o `REFUND`
`create_timestamp`	Unix timestamp (milisegundos) de la transacción
`merchant_name`	Nombre del comercio del cargo
`metadata_object`	Metadata personalizada asociada a la transacción

Autenticación

Uso de la API

🟢 Producción

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Endpoints disponibles

Consultar transacciones de suscripción

Obtén el detalle y el historial completo de transacciones de una suscripción, filtrado por rango de fechas.

¿Tienes una sugerencia sobre esta documentación? Contáctanos.

Transacciones de suscripción

Inicio rápido#

Estructura de la respuesta#

Campos de la suscripción#

Campos de la transacción#

Autenticación#

Uso de la API#