`UpdateBeneficiaryRequest`

Cuerpo de `PUT /v1/beneficiaries/{id}`. Acepta envoltorio JSON:API `{ data: { attributes: {...} } }` o un objeto plano. Todos los campos son opcionales — solo se actualizan los presentes. Si el cuerpo no contiene ningún campo editable, el servidor responde `422 no_valid_fields`. Tres rutas de actualización: - Solo `label`: se sanea y persiste. - `account_number` nuevo: re-deriva `account_type`, `bank_code` y `bank_name` con las mismas reglas que `POST /v1/beneficiaries`. - Solo `bank_code`: válido únicamente cuando el beneficiario existente es de tipo `phone`; para CLABE/card se ignora silenciosamente. Dispara el evento de auditoría `beneficiary.phone_bank_updated` cuando el código cambia.

Propiedades

Campo	Tipo	Descripción
`label`	`string`	Etiqueta opcional libre. Saneada con `strip_tags` + `trim`.
`account_number`	`string`	Nuevo número de cuenta. Reemplaza el existente y dispara la re-derivación de `account_type`, `bank_code` y `bank_name`. Para tipo `phone`, `bank_code` debe acompañar la petición.
`bank_code`	`string`	Código Banxico SPEI de 5 dígitos. Para beneficiarios de tipo `phone`, puede enviarse aislado para reasignar el banco DiMo del receptor. Para CLABE/card el campo se ignora.

Usado en operaciones

PUT /v1/beneficiaries/{id}