Medios de pago
POST
Actualizar método de pago
POST /api/payment-methods/update-payment-method
Descripción
Actualiza un método de pago existente.
Detalles
Actualiza el nombre, ícono, color, orden, cuenta destino y opciones de cobro del método de pago. No permite cambiar el tipo ni el código. En métodos del sistema solo se actualizan nombre, ícono y color; el resto del payload se ignora. La cuenta destino es obligatoria salvo para efectivo, cupón, crédito y anticipo del cliente. La descripción pública se muestra al cliente en el menú digital.
Permisos requeridos
admin.module
Request
| Nombre | Tipo | Requerido | Reglas |
|---|---|---|---|
| paymentMethodId | int | Sí |
min_value:1
|
| name | string | Sí |
min:1
max:100
|
| targetAccountId | int | No |
min_value:1
|
| iconFontAwesome | string | No |
max:100
|
| color | string | No |
min:7
max:7
|
| publicDescription | string | No | — |
| requiresReference | bool | Sí | — |
| followsCashSession | bool | Sí | — |
| requiresDeclaration | bool | Sí | — |
| sortOrder | int | No |
min_value:0
|
Ejemplo de request
curl -X POST https://app.restofy.co/api/payment-methods/update-payment-method \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <accessToken>" \
-d '{
"paymentMethodId": 1,
"name": "string",
"requiresReference": true,
"followsCashSession": true,
"requiresDeclaration": true
}'
Los valores son demo: reemplázalos por datos reales del negocio.
Ejemplo de respuesta
Actualizado: 2026-07-15T13:20:48Z
HTTP 200
Request
{
"paymentMethodId": 13,
"name": "Method renombrado",
"requiresReference": true,
"followsCashSession": false,
"requiresDeclaration": false
}
Response
{
"success": true,
"message": "Método de pago actualizado",
"data": {
"paymentMethodId": 13
}
}