Ir al contenido

Crear un método de pago

POST/api/payment-method

Crea un método de pago. El servidor guarda el registro con estado activo y asigna al usuario autenticado como creador. Devuelve el modelo creado.

namestringobligatorio

Nombre del método de pago. Máximo 50 caracteres y único.

descriptionstring

Descripción. Máximo 500 caracteres.

payment_settingsobjectobligatorio

Configuración del método de pago. Define qué muestra y exige el formulario de movimientos de caja. Ver la estructura en el Resumen.

payment_settings.egreso.enablebooleanobligatorio

Si el método puede usarse en egresos.

payment_settings.egreso.inputs.operationNumber.showbooleanobligatorio

Si el egreso admite el código de operación (opcode).

payment_settings.egreso.inputs.operationNumber.requiredbooleanobligatorio

Si el código de operación es obligatorio en egresos.

payment_settings.egreso.inputs.commission.showbooleanobligatorio

Si el egreso admite comisión.

payment_settings.egreso.inputs.commission.requiredbooleanobligatorio

Si la comisión es obligatoria en egresos.

payment_settings.ingreso.enablebooleanobligatorio

Si el método puede usarse en ingresos.

payment_settings.ingreso.inputs.operationNumber.showbooleanobligatorio

Si el ingreso admite el código de operación.

payment_settings.ingreso.inputs.operationNumber.requiredbooleanobligatorio

Si el código de operación es obligatorio en ingresos.

payment_settings.ingreso.inputs.commission.showbooleanobligatorio

Si el ingreso admite comisión.

payment_settings.ingreso.inputs.commission.requiredbooleanobligatorio

Si la comisión es obligatoria en ingresos.

payment_settings.account.fisica.enablebooleanobligatorio

Si el método admite cuentas físicas.

payment_settings.account.virtual.enablebooleanobligatorio

Si el método admite cuentas virtuales.

payment_settings.forCollectionbooleanobligatorio

Indicador de método para cobros.

payment_settings.forDisbursementbooleanobligatorio

Indicador de método para desembolsos.

payment_settings.requiresAccountbooleanobligatorio

Indicador de que el método requiere cuenta.

payment_settings.requiresReferencebooleanobligatorio

Indicador de que el método requiere referencia.

cashbox.configuration.create, que se valida en PaymentMethodPolicy::create. Ver Permisos y políticas.

Ventana de terminal
curl -X POST \
"https://servererp.allendostmen.app/api/payment-method" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Transferencia",
"description": "Transferencia bancaria",
"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
}
}'
PaymentMethod creado201
{
"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
}
Sin permiso403
{
"message": "This action is unauthorized."
}
Datos no válidos422
{
"message": "El nombre del método de pago ya existe. Verifique o restaure el registro si fue eliminado anteriormente.",
"errors": {
"name": [
"El nombre del método de pago ya existe. Verifique o restaure el registro si fue eliminado anteriormente."
]
}
}