PaymentMethod
Un método de pago es la forma en que se mueve el dinero en caja, por ejemplo transferencia o efectivo. Su campo payment_settings decide en qué tipos de movimiento y con qué tipos de cuenta se puede usar, y qué campos muestra y exige el formulario de movimientos de caja.
| Modelo | App\Models\PaymentMethod |
| Tabla | payment_methods |
El objeto PaymentMethod
Sección titulada «El objeto PaymentMethod»Atributos
Sección titulada «Atributos»idintegerIdentificador del método de pago.
namestringNombre del método de pago.
descriptionstringDescripción del método de pago.
is_for_account_virtualbooleanIndicador heredado de uso con cuentas virtuales. Por defecto, verdadero en la base de datos.
is_for_account_physicalbooleanIndicador heredado de uso con cuentas físicas. Por defecto, verdadero.
is_for_incomebooleanIndicador heredado de uso en ingresos. Por defecto, verdadero.
is_for_expensebooleanIndicador heredado de uso en egresos. Por defecto, verdadero.
include_commissionbooleanIndicador heredado de comisión. Por defecto, falso.
payment_settingsobjectConfiguración en JSON del método de pago. Estructura en la sección siguiente.
statusstringEstado del registro (ModelStatusEnum). Se asigna activo al crear.
previous_statusstringEstado anterior. Lo llena el sistema al eliminar, restaurar o cambiar el estado.
status_update_commentstringComentario del último cambio de estado.
status_update_datedatetimeFecha del último cambio de estado.
status_update_user_idintegerUsuario que hizo el último cambio de estado.
create_user_idintegerUsuario que creó el registro. Se asigna automáticamente.
update_user_idintegerUsuario que hizo la última modificación.
delete_user_idintegerUsuario que eliminó el registro.
restore_user_idintegerUsuario que restauró el registro.
restored_atdatetimeFecha de la última restauración.
created_atdatetimeFecha de creación.
updated_atdatetimeFecha de la última modificación.
deleted_atdatetimeFecha de eliminación lógica.
{ "id": 1, "name": "Transferencia", "description": "Transferencia bancaria", "is_for_account_virtual": true, "is_for_account_physical": true, "is_for_income": true, "is_for_expense": true, "include_commission": false, "payment_settings": { "egreso": { "enable": true, "inputs": { "commission": { "show": false, "required": false }, "operationNumber": { "show": true, "required": true } } }, "ingreso": { "enable": true, "inputs": { "commission": { "show": true, "required": false }, "operationNumber": { "show": true, "required": true } } }, "account": { "fisica": { "enable": true }, "virtual": { "enable": true } }, "forCollection": true, "forDisbursement": true, "requiresAccount": true, "requiresReference": false }, "status": "activo", "previous_status": null, "status_update_comment": null, "status_update_date": null, "status_update_user_id": null, "create_user_id": 1, "update_user_id": null, "delete_user_id": null, "restore_user_id": null, "restored_at": null, "created_at": "2026-11-19T10:40:15.000000Z", "updated_at": "2026-11-19T10:40:15.000000Z", "deleted_at": null}Estructura de payment_settings
Sección titulada «Estructura de payment_settings»StoreCashboxMovementRequest lee payment_settings para validar cada movimiento de caja. La clave egreso o ingreso se elige según el tipo del movimiento.
{ "egreso": { "enable": true, "inputs": { "commission": { "show": false, "required": false }, "operationNumber": { "show": true, "required": true } } }, "ingreso": { "enable": true, "inputs": { "commission": { "show": true, "required": false }, "operationNumber": { "show": true, "required": true } } }, "account": { "fisica": { "enable": true }, "virtual": { "enable": true } }, "forCollection": true, "forDisbursement": true, "requiresAccount": true, "requiresReference": false}| Clave | Efecto en un movimiento de caja |
|---|---|
egreso.enable o ingreso.enable |
Si no es verdadero, el movimiento se rechaza con El método de pago no está configurado para realizar un movimiento de tipo egreso. o ... de tipo ingreso. |
inputs.operationNumber.show |
Si es verdadero, el campo opcode se valida: obligatorio si required es verdadero y opcional en caso contrario. |
inputs.commission.show |
Si es verdadero, se valida include_commission: debe ser verdadero y aceptado si required es verdadero, y opcional en caso contrario. |
account.fisica.enable |
Si no es verdadero y la cuenta no es virtual, se rechaza con El método de pago no está configurado para usar cuentas físicas. |
account.virtual.enable |
Si no es verdadero y la cuenta es virtual, se rechaza con El método de pago no está configurado para usar cuentas virtuales. |
Si include_commission es verdadero, el movimiento exige además commission_type_id, commission_amount y admite commission_opcode. Las claves forCollection, forDisbursement, requiresAccount y requiresReference son obligatorias al guardar el método, pero StoreCashboxMovementRequest no las lee.
Ver Crear un movimiento.
Campos permitidos para ordenar: id, name, description, status, created_at, updated_at.
Búsqueda
Sección titulada «Búsqueda»La búsqueda de texto (search) compara con la columna name.
Estados
Sección titulada «Estados»El estado usa ModelStatusEnum. Un método nuevo queda en activo; al eliminarlo pasa a eliminado.
