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 México 🇲🇽. Ú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": "MXN",
    "subtotalIva0": 500,
    "subtotalIva": 0,
    "iva": 0,
    "ice": 0
  },
  "card_holder_name": "Juan García",
  "card_type": "credit",
  "last_four_digit_code": "4242",
  "contact_details_object": {
    "email": "user@example.com",
    "firstName": "Juan",
    "lastName": "García"
  },
  "bin_info_object": {
    "bank": "BANORTE",
    "bin": "521892",
    "brand": "MASTERCARD",
    "info": {
      "country": {
        "alpha3": "MEX",
        "name": "Mexico"
      },
      "type": "credit"
    }
  },
  "merchant_code": "20000000103802320000",
  "merchant_country_name": "Mexico",
  "create_timestamp": 1760313600,
  "start_timestamp": 1760313600,
  "last_charge_timestamp": 1760313600,
  "transactions": [
    {
      "_id": "491915787351730000",
      "approved_transaction_amount": 500,
      "currency_code": "MXN",
      "response_code": "000",
      "response_description": "Transacción aprobada",
      "card_holder_name": "Juan García",
      "card_type": "credit",
      "card_country_code": "MX",
      "card_country_name": "Mexico",
      "payment_brand_name": "Mastercard",
      "payment_method_type": "CARD",
      "processor_name": "MC Processor",
      "subscription_trigger_type": "onDemand",
      "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 — `monthly`, `weekly`, `annual`, `custom`
`amount_object`	Monto y moneda del cargo de la suscripción
`card_holder_name`	Nombre del tarjetahabiente de la suscripción
`card_type`	`credit` o `debit`
`last_four_digit_code`	Últimos 4 dígitos de la tarjeta
`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 MXN
`currency_code`	`MXN`
`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` o `debit`
`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`, `automatic`
`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#