Eliminar método de pago
DELETE /api/payment-method-types/{payment_method_type_id}
Autenticación: Bearer del usuario del tenant (Authorization: Bearer <api_token>).
Elimina un método de pago que nunca se usó.
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 |
|---|---|---|---|
payment_method_type_id |
string | Sí | Código del método. |
Reglas:
- Los códigos del sistema
01a10no se eliminan (can_delete: false). - Si tiene cobros, pagos o movimientos de caja registrados no se elimina: desactívalo con Editar método de pago (
is_active: false).
Errores:
403si el usuario no es administrador.404si el código no existe (o es una condición reservada del sistema, que no se administra por la API).409si es del sistema o está en uso.401sin token o con un token inválido.
Parámetros
| Parámetro | Dónde | Obligatorio | Ejemplo | Descripción |
|---|---|---|---|---|
payment_method_type_id |
ruta | sí | 13 |
Respuestas
200 — Eliminado
{
"success": true,
"data": {
"id": "21"
},
"message": "Método de pago eliminado con éxito"
}
409 — En uso
{
"success": false,
"message": "El método de pago tiene pagos registrados y no se puede eliminar. Desactívalo en su lugar."
}
409 — Del sistema
{
"success": false,
"message": "Los métodos de pago del 01 al 10 son del sistema y no se pueden eliminar. Desactívalo en su lugar."
}
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.