Crear un método de pago
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.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»namestringobligatorioNombre del método de pago. Máximo 50 caracteres y único.
descriptionstringDescripción. Máximo 500 caracteres.
payment_settingsobjectobligatorioConfiguració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.enablebooleanobligatorioSi el método puede usarse en egresos.
payment_settings.egreso.inputs.operationNumber.showbooleanobligatorioSi el egreso admite el código de operación (opcode).
payment_settings.egreso.inputs.operationNumber.requiredbooleanobligatorioSi el código de operación es obligatorio en egresos.
payment_settings.egreso.inputs.commission.showbooleanobligatorioSi el egreso admite comisión.
payment_settings.egreso.inputs.commission.requiredbooleanobligatorioSi la comisión es obligatoria en egresos.
payment_settings.ingreso.enablebooleanobligatorioSi el método puede usarse en ingresos.
payment_settings.ingreso.inputs.operationNumber.showbooleanobligatorioSi el ingreso admite el código de operación.
payment_settings.ingreso.inputs.operationNumber.requiredbooleanobligatorioSi el código de operación es obligatorio en ingresos.
payment_settings.ingreso.inputs.commission.showbooleanobligatorioSi el ingreso admite comisión.
payment_settings.ingreso.inputs.commission.requiredbooleanobligatorioSi la comisión es obligatoria en ingresos.
payment_settings.account.fisica.enablebooleanobligatorioSi el método admite cuentas físicas.
payment_settings.account.virtual.enablebooleanobligatorioSi el método admite cuentas virtuales.
payment_settings.forCollectionbooleanobligatorioIndicador de método para cobros.
payment_settings.forDisbursementbooleanobligatorioIndicador de método para desembolsos.
payment_settings.requiresAccountbooleanobligatorioIndicador de que el método requiere cuenta.
payment_settings.requiresReferencebooleanobligatorioIndicador de que el método requiere referencia.
Permiso
Sección titulada «Permiso»cashbox.configuration.create, que se valida en PaymentMethodPolicy::create. Ver Permisos y políticas.
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 }}'const response = await fetch( "https://servererp.allendostmen.app/api/payment-method", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ "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 } }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/payment-method', [ '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, ], ]);{ "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}{ "message": "This action is unauthorized."}{ "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." ] }}