7. Pagos
Instrucciones, comprobaciones y pasos de esta sección del manual.
Abre el laboratorio estilo Postman, indica la URL de tu panel y envía la petición. Recuerda activar la API en Ajustes → Gestión de personal.
POST /payments registra el pago con el mismo procesador del panel: marca la factura y reactiva el servicio si corresponde.
GET /payments
Filtros: customer_id, invoice_id. Permiso: finanzas.transacciones.menu.
POST /payments
Permiso: finanzas.registrar-pago.pagar.
{
"invoice_id": 100,
"amount": 30,
"method": "transferencia",
"reference": "48313958199",
"description": "Pago API",
"paid_at": "2026-08-15 09:22:00"
}
POST /payment-promises
Permiso: finanzas.registrar-pago.promesa.
Crea una promesa de pago sobre una factura de servicios sin pagar. No cobra la factura: deja el servicio hasta la fecha máxima, igual que en el panel. deadline va en formato Y-m-d, entre mañana y 20 días. Si el cliente ya tiene una promesa activa, responde 422 promise_active.
{
"customer_id": 12,
"invoice_id": 100,
"deadline": "2026-10-20",
"description": "NetisPay"
}
Respuesta 201: data.id, data.customer_id, data.invoice_id, data.created_on, data.deadline, data.description y data.status (active).
GET /payments/{id}
PUT /payments/{id}
Campos: method, reference, description. Permiso: finanzas.transacciones.editar.
DELETE /payments/{id}
Borra la operación; no recalcula sola la factura. Permiso: finanzas.transacciones.eliminar.