Subscription Transactions - Kushki Developer Portal

El endpoint de transacciones de suscripción devuelve toda la información asociada a una suscripción (datos de la tarjeta, configuración de periodicidad, desglose del monto) junto con la lista completa de cargos que se han procesado bajo ella.

Usa este endpoint para consultas de soporte al cliente, auditorías de suscripciones o para construir una vista del historial de transacciones en tu portal.

Cómo funciona

Llama a GET /data/v1/subscription/{subscriptionId} con el subscriptionId que se devolvió al crear la suscripción. La respuesta incluye tanto la configuración de la suscripción como un array paginado de transacciones individuales.

Estructura de la respuesta

Campos de la suscripción

Campo	Descripción
`subscription_code`	Identificador único de la suscripción.
`active_indicator`	`true` si la suscripción está activa en este momento.
`periodicity_type`	Frecuencia del cargo: `daily`, `weekly`, `biweekly`, `monthly`, `quarterly`, `halfyearly`, `yearly` o `custom`.
`plan_name`	Nombre del plan asociado a la suscripción.
`card_holder_name`	Nombre completo del tarjetahabiente.
`card_type`	`credit`, `debit` o `prepaid`.
`last_four_digit_code`	Últimos 4 dígitos de la tarjeta registrada.
`expiry_month` / `expiry_year`	Vencimiento de la tarjeta (MM / YY).
`amount_object`	Desglose del monto del cargo recurrente (ver abajo).
`contact_details_object`	Información de contacto del suscriptor.
`bin_info_object`	Metadatos del BIN de la tarjeta registrada.
`create_timestamp`	Unix timestamp de la creación de la suscripción.
`start_timestamp`	Unix timestamp del inicio de la facturación.
`last_charge_timestamp`	Unix timestamp del cargo más reciente.
`merchant_code`	Identificador del comercio.
`merchant_country_name`	País del comercio (`Peru`).
`provider_name`	Proveedor de pago.
`metadata_object`	Metadatos personalizados clave-valor adjuntos a la suscripción.
`transactions`	Array de objetos de transacción individuales (ver abajo).

Desglose del monto (`amount_object`)

{
  "currency": "PEN",
  "subtotalIva": 0,
  "subtotalIva0": 600,
  "iva": 0,
  "ice": 0
}

Campos por transacción (`transactions[]`)

Campo	Descripción
`approval_code`	Código de aprobación del procesador.
`approved_transaction_amount`	Monto cobrado con éxito.
`currency_code`	Moneda de la transacción (`PEN` o `USD`).
`transaction_status_type`	`APPROVED`, `DECLINED`, `INITIALIZED`, `VOIDED` o `REFUNDED`.
`transaction_type`	`SALE`, `PREAUTHORIZATION`, `CAPTURE`, `VOID` o `REFUND`.
`subscription_trigger_type`	`onDemand` (cargo manual) o `scheduled` (automático).
`ticket_code`	Número de ticket de la transacción.
`create_timestamp`	Timestamp de la transacción.
`last_four_digit_code`	Últimos 4 dígitos de la tarjeta usada en este cargo.
`card_type`	`credit`, `debit` o `prepaid`.

Autenticación

Uso de la API

🟢 Producción

🧪 Sandbox (UAT)

https://api.kushkipagos.com/

Endpoints disponibles

Consultar transacciones de suscripción

Obtén los detalles completos y el historial de transacciones de una suscripción por su ID.

¿Tienes una sugerencia sobre esta documentación? Escríbenos.

Transacciones de suscripción

Cómo funciona#

Estructura de la respuesta#

Campos de la suscripción#

Desglose del monto (amount_object)#

Campos por transacción (transactions[])#

Autenticación#

Uso de la API#

Endpoints disponibles#