---
title: "Cancelar una suscripción"
method: POST
path: "/api/v1/merchants/subscriptions/{subscription_id}/cancel"
tags: ["Suscripciones"]
---

# Cancelar una suscripción

`POST /api/v1/merchants/subscriptions/{subscription_id}/cancel`

Este endpoint permite cancelar una suscripción específica utilizando su `subscription_id`.  La suscripción pasa a un estado de canceled` y puede especificarse si será al final del mes de facturación o al final del ciclo de renovación (por ejemplo, una suscripción mensual que tiene un tiempo de un año de renovaciones). Al cumplirse ese tiempo, la suscripción pasa al estado `expired` **Reglas de negocio:** - La suscripción debe estar activa. - Al merchant se le dará la opción de poder cancelar la subscripción en el proximo ciclo de renovación o al finalizar el contrato de subcripción.

## Path parameters

- `subscription_id` string, required

## Headers

- `X-API-key` string, required

## Request body

- object
  - `end_time` 'bill_date' | 'term_end' — Indica cuándo debe finalizar la suscripción.

## Response `200`

Respuesta exitosa.

- object
  - `activated_at` string, date-time — Fecha de activación.
  - `auto_renew` boolean — Indica si la suscripción se renueva automáticamente.
  - `canceled_at` string, date-time — Fecha de cancelación.
  - `created_at` string, date-time — Fecha y hora de creación.
  - `currency` string — Moneda de la suscripción.
  - `current_period_ends_at` string, date-time — Fin del periodo actual.
  - `current_period_started_at` string, date-time — Inicio del periodo actual.
  - `expires_at` string, date-time — Fecha de expiración.
  - `payer_info` object — Información del usuario asociado.
    - `email` string — Correo electrónico del usuario.
    - `user_id` string — ID único del usuario.
  - `plan_code` string — Código del plan asociado.
  - `remaining_billing_cycles` integer — Ciclos de facturación restantes.
  - `status` string — Estado inicial de la suscripción.
  - `subscription_id` string, uuid — ID único de la suscripción creada.
  - `total_billing_cycles` integer — Número total de ciclos de facturación.
  - `updated_at` string, date-time — Fecha de última actualización.

## Other responses

- `400` — Respuesta de un bad request
- `401` — Respuesta de una solicitud **sin autorización** este problema es debido a el **X-API-KEY** inválido o por el **Bearer-Auth
- `404` — Recurso no encontrado.
- `500` — Error interno del servidor.

---

[API](https://skmtc.dev/deuna/apis/user-network-api.md) · [All operations](https://skmtc.dev/deuna/apis/user-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deuna/user-network-api/revisions/df73fa00ed05/schema)