Eliminar suscripción
DELETE /api/subscriptions/{subscription_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Elimina una suscripción registrada por error, con sus órdenes sin pagar.
Quién puede usarlo: solo usuarios de tipo administrador (type = admin). Con el token de un vendedor responde 403.
Formato de respuesta: estándar {success, data, message?} (registro único). En el éxito data es {id}.
Parámetros de la ruta:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
subscription_id |
integer | Sí | Id de la suscripción. |
Reglas:
- Si tiene alguna orden pagada (cobros con comprobante) no se elimina: cancélala con Cambiar estado de la suscripción.
Errores:
403si el usuario no es administrador.404si el registro no existe.409si tiene órdenes pagadas.401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
subscription_id |
ruta | sí | 48 |
Respuestas
200 — Eliminada
{
"success": true,
"data": {
"id": 48
},
"message": "Suscripción eliminada con éxito"
}
409 — Con pagos
{
"success": false,
"message": "La suscripción tiene órdenes pagadas y no se puede eliminar. Cancélala en su lugar."
}
403 — Usuario no administrador
{
"success": false,
"message": "Solo un administrador puede gestionar este recurso."
}
Pruébalo
Prueba este endpoint con tu empresa y tu token: elige la URL en Servers, pega el token en Authorize y haz clic en Try it out.