> ## 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. # Crear una recuperación de valores MED > Abre una recuperación de valores como PSP creador. El ISPB creador se deriva de la configuración. grafoRastreamento.vlrMinTransacaoCents es un umbral de FILTRO para el recorrido del grafo, nunca un monto de contabilización. ## OpenAPI ````yaml es/openapi/v3-current/pix.yaml POST /v1/med/recoveries 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: post: tags: - MED API summary: Crear una recuperación de valores MED description: >- Abre una recuperación de valores como PSP creador. El ISPB creador se deriva de la configuración. grafoRastreamento.vlrMinTransacaoCents es un umbral de FILTRO para el recorrido del grafo, nunca un monto de contabilización. requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateRecoveryRequestBody' required: true responses: '202': content: application/json: schema: $ref: '#/components/schemas/RecoveryView' description: Aceptado default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error components: schemas: CreateRecoveryRequestBody: additionalProperties: false properties: contatoEmail: description: Correo electrónico de contacto del creador (obligatorio). type: string contatoTelefone: description: Teléfono de contacto del creador (obligatorio). type: string detalhes: description: Detalle de texto libre; obligatorio cuando tpSituacao=4 (Outros). type: string grafoRastreamento: $ref: '#/components/schemas/GrafoRastreamentoBody' idTransacaoRaiz: description: EndToEndId de la transacción raíz que se está recuperando. type: string idempotencyKey: description: Clave de idempotencia derivada del negocio (Chave-Idempotencia). type: string tpSituacao: description: >- Código de situación (0=Golpe, 1=Nao autorizada, 2=Coercao, 3=Acesso fraudulento, 4=Outros, 5=Desconhecida). format: int64 type: integer required: - idTransacaoRaiz - tpSituacao - contatoEmail - contatoTelefone - 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 GrafoRastreamentoBody: additionalProperties: false properties: janelaTempo: description: Ventana temporal del recorrido (duración ISO-8601, máx. PT2H). type: string maxProfundidade: description: Profundidad máxima del recorrido (máx. 10). format: int64 type: integer maxTransacoes: description: Máximo de transacciones a rastrear (máx. 5). format: int64 type: integer vlrMinTransacaoCents: description: >- Piso del recorrido (rastrea solo las transacciones descendentes >= este valor), en centavos. Un umbral de FILTRO, nunca un monto de contabilización. format: int64 type: integer required: - vlrMinTransacaoCents - maxTransacoes - janelaTempo - maxProfundidade 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). ````