`CreateBeneficiaryRequest`

Cuerpo de `POST /v1/beneficiaries`. Acepta dos formas: un objeto plano con los atributos en la raíz, o el envoltorio JSON:API `{ data: { attributes: {...} } }`. El servidor prueba primero `data.attributes` y, si está ausente, toma el objeto raíz. El tipo de cuenta (`clabe`, `card`, `phone`) se autodetecta por la longitud de los dígitos: 18 = CLABE, 13–19 (≠18) = tarjeta, 10 = celular (DiMo). Cuando el tipo detectado es `phone`, `bank_code` es **obligatorio**; para CLABE y tarjeta el `bank_code` enviado por el cliente se ignora y se deriva del prefijo CLABE o del BIN.

Propiedades

Campo	Tipo	Descripción
`account_number` *	`string`	Número de cuenta. Se acepta CLABE de 18 dígitos, tarjeta de 13–19 dígitos (excepto 18, reservado a CLABE) o celular DiMo de 10 dígitos. Los separadores (espacios, guiones) se eliminan antes de validar.
`bank_code`	`string`	Código Banxico SPEI de 5 dígitos. Obligatorio cuando el tipo detectado es `phone`; ignorado para CLABE y tarjeta (se deriva del prefijo o BIN). Cuando aplica, el código se valida contra el catálogo actual de participantes SPEI.
`label`	`string`	Etiqueta opcional libre. Saneada con `strip_tags` y `trim` antes de persistirse.

Usado en operaciones

POST /v1/beneficiaries