← Volver al índice de esquemas

`UpdateBeneficiaryResponse`

Respuesta de `PUT /v1/beneficiaries/{id}` con el beneficiario actualizado.

Propiedades

Campo	Tipo	Descripción
`data`	`object`	Payload principal de la respuesta. La forma varía según el endpoint (objeto, array, o envelope JSON:API con `type`, `id`, `attributes`).
`type`*	`string`	Tipo de recurso JSON:API. Siempre `beneficiary`.
`id`*	`string`	Identificador numérico del beneficiario en el sistema.
`attributes`*	`object`	Atributos canónicos del beneficiario (datos de la cuenta y metadatos del registro).
`account_number`*	`string`	Número de cuenta almacenado: CLABE (18 dígitos), tarjeta (16 dígitos) o celular/DiMo (10 dígitos). Use `account_type` para desambiguar el tipo exacto.
`account_type`*	`string`	Tipo de cuenta: `clabe` (18 dígitos), `card` (16 dígitos) o `phone` (10 dígitos).
`bank_code`*	`string`	Código SPEI (5 dígitos) del banco resuelto.
`bank_name`*	`string`	Nombre oficial del banco resuelto, derivado de su `bank_code`.
`label`	`string \| null`	Etiqueta descriptiva libre del usuario. `null` si no fue asignada.
`status`*	`string`	Estado del beneficiario. `inactive` si el beneficiario fue archivado o dado de baja. `active` si está en uso.
`created_at`*	`string (date-time)`	Marca temporal UTC de creación.
`meta`	`object`	Metadatos de la respuesta, incluyendo versión de la API, prefijo de ruta, identificador único de la petición y marca temporal del servidor en UTC.
`version`	`string`	Versión de la API que procesó la petición.
`api_version`	`string`	Versión del prefijo de ruta de la API (ej. `v1`).
`request_id`	`string`	Identificador único de la petición (hex).
`datetime`	`object`	Descriptor compañero presente en el bloque `meta` de cada respuesta (y en el `meta` del cuerpo de los webhooks salientes). Permite a los clientes afirmar el contrato de zona horaria sin releer el spec.
`timezone`*	`string`	Siempre `UTC` — la zona canónica para cada campo datetime del cuerpo.
`format`*	`string`	Siempre `ISO 8601` — sufijo `Z` explícito en cada datetime.
`links`	`object`	Enlaces de paginación o relacionados, presentes solo cuando el endpoint devuelve una colección paginada.

Usado en operaciones

PUT /v1/beneficiaries/{id}