> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Iniciar la etapa de devolución de una recuperación de valores MED > Inicia la etapa de devolución de una recuperación de valores. NO MUEVE DINERO: transiciona stRecValores->4 y hace que el DICT emita solicitudes de devolución. Un id desconocido devuelve un 404 codificado. ## OpenAPI ````yaml es/openapi/v3-current/pix.yaml POST /v1/med/recoveries/{idRecValores}/devolver openapi: 3.0.3 info: title: Plugin BR Pix Directo - API completa description: > API completa para el sistema de pagos instantáneos Pix de Brasil, que incluye operaciones del diccionario de claves Pix, generación/decodificación de códigos QR, transacciones y límites transaccionales. version: 1.0.0 servers: - url: https://plugin-pix-direct.api.lerian.net - url: https://plugin-pix-direct-qrcode.api.lerian.net security: - bearerAuth: [] paths: /v1/med/recoveries/{idRecValores}/devolver: post: tags: - MED API summary: Iniciar la etapa de devolución de una recuperación de valores MED description: >- Inicia la etapa de devolución de una recuperación de valores. NO MUEVE DINERO: transiciona stRecValores->4 y hace que el DICT emita solicitudes de devolución. Un id desconocido devuelve un 404 codificado. parameters: - description: The value-recovery GUID. in: path name: idRecValores required: true schema: description: El GUID de la recuperación de valores. type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/DevolverRecoveryRequestBody' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/RecoveryView' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error components: schemas: DevolverRecoveryRequestBody: additionalProperties: false properties: idempotencyKey: description: Clave de idempotencia derivada del negocio (Chave-Idempotencia). type: string required: - idempotencyKey type: object RecoveryView: additionalProperties: false properties: breached: description: >- True cuando el plazo de devolver se ha alcanzado o superado (calculado en el momento de la lectura); false cuando no hay plazo definido. type: boolean contatoEmail: description: Correo electrónico de contacto del creador. type: string contatoTelefone: description: Teléfono de contacto del creador. type: string detalhes: description: Detalle de texto libre (obligatorio cuando tpSituacao=4 Outros). type: string devolverDeadline: description: >- Plazo de devolver de 72 h del lado del creador, desde el cierre de la etapa de Análise; null salvo que esta institución sea el pspCriador en una recuperación Analisada. type: string dtHrCriacao: description: Marca de tiempo de creación en el upstream (RFC 3339 UTC). type: string dtHrUltModificacao: description: >- Marca de tiempo de la última modificación en el upstream (RFC 3339 UTC): la marca de agua. type: string idRecValores: description: GUID de la recuperación de valores (la clave natural). type: string idTransacaoRaiz: description: EndToEndId de la transacción raíz que se está recuperando. type: string pspCriador: description: ISPB del creador de la recuperación. type: string status: description: Código de ciclo de vida stRecValores (0=Criada.. 6=Cancelada). format: int64 type: integer statusDescription: description: Etiqueta legible para humanos de stRecValores. type: string tpSituacao: description: Código de situación (0..5). format: int64 type: integer tpSituacaoDescription: description: Etiqueta legible para humanos de tpSituacao. type: string required: - idRecValores - idTransacaoRaiz - tpSituacao - tpSituacaoDescription - contatoEmail - contatoTelefone - pspCriador - status - statusDescription - dtHrCriacao - dtHrUltModificacao - breached type: object Detail: additionalProperties: false properties: code: description: >- Código de error de dominio estable y legible por máquina, acotado al servicio emisor (formato: -NNNN). type: string detail: description: >- Una explicación legible para humanos específica de esta ocurrencia del problema. type: string errors: description: Lista opcional de detalles de error individuales items: $ref: '#/components/schemas/ErrorDetail' type: array nullable: true instance: description: >- Una referencia URI que identifica la ocurrencia específica del problema. format: uri type: string status: description: Código de estado HTTP format: int64 type: integer title: description: >- Un resumen breve y legible para humanos del tipo de problema. Este valor no debería cambiar entre ocurrencias del error. type: string type: default: about:blank description: >- Una referencia URI a la documentación legible para humanos del error. format: uri type: string type: object ErrorDetail: additionalProperties: false properties: location: description: >- Dónde ocurrió el error, p. ej. 'body.items[3].tags' o 'path.thing-id' type: string message: description: Texto del mensaje de error type: string value: description: El valor en la ubicación indicada type: object securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Autenticación con token JWT Bearer. Obtén el token desde el endpoint `/v1/login/oauth/access_token` usando credenciales de cliente (`clientId` y `clientSecret`). Incluye el token en el encabezado Authorization: `Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` El token expira después de 3600 segundos (1 hora). ````