Rechazar orden
POST /api/subscriptions/orders/{subscription_order_id}/reject
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Marca la orden como rechazada (pago fallido) y suma un rechazo. La orden se puede volver a cobrar después.
Quién puede usarlo: cualquier usuario autenticado (administrador o vendedor). Los registros de suscripciones son de toda la empresa: un vendedor ve y gestiona los mismos que el administrador.
Formato de respuesta: estándar {success, data, message?} (registro único).
Parámetros de la ruta:
| Campo | Tipo | Obligatorio | Descripción / valores permitidos |
|---|---|---|---|
subscription_order_id |
integer | Sí | Id de la orden de cobro. |
Errores:
404si el registro no existe.409si la orden está pagada o cancelada.401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
subscription_order_id |
ruta | sí | 311 |
Respuestas
200 — Rechazada
{
"success": true,
"data": {
"id": 311,
"number": "SO-0311",
"status": "rejected",
"status_description": "Rechazado",
"amount": 118.0,
"currency_type_id": "PEN",
"date_of_issue": "2026-12-14",
"date_of_due": "2026-12-14",
"date_of_payment": null,
"subscription_id": 48,
"plan_id": 3,
"plan_name": "Plan Mensual Gold",
"customer_id": 1520,
"customer_name": "MARÍA FERNANDA QUISPE ROJAS",
"customer_number": "45879632",
"count_notification": 1,
"date_notification": "2026-12-14 09:00:04",
"count_rejected_payments": 1,
"payment_url": "https://empresa.dominio/full-suscription/pending-payments/order/482913",
"document": null
},
"message": "Orden rechazada"
}
409 — Pagada
{
"success": false,
"message": "La orden ya está pagada y no se puede rechazar."
}
404 — No existe
{
"success": false,
"message": "Registro no encontrado."
}
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.