> ## 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. # Actualizar un QR Pix dinámico inmediato > Actualiza un QR Pix dinámico inmediato existente: el monto del cobro, la conciliación, la expiración, el pagador opcional y el estado del cobro (0=Active, 1=Concluded, 2=Removed by recipient, 3=Removed by PSP). El nombre + la ciudad del beneficiario se obtienen del CRM (nunca del cuerpo). El servicio vuelve a hospedar el JWS firmado actualizado para que el QR siga siendo resoluble de extremo a extremo; la respuesta lleva la revisión del upstream y la URL de payload resoluble. ## OpenAPI ````yaml es/openapi/v3-current/pix.yaml PUT /v1/qrcodes/dynamic/{documentId} 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/qrcodes/dynamic/{documentId}: put: tags: - QR Codes API summary: Actualizar un QR Pix dinámico inmediato description: >- Actualiza un QR Pix dinámico inmediato existente: el monto del cobro, la conciliación, la expiración, el pagador opcional y el estado del cobro (0=Active, 1=Concluded, 2=Removed by recipient, 3=Removed by PSP). El nombre + la ciudad del beneficiario se obtienen del CRM (nunca del cuerpo). El servicio vuelve a hospedar el JWS firmado actualizado para que el QR siga siendo resoluble de extremo a extremo; la respuesta lleva la revisión del upstream y la URL de payload resoluble. parameters: - description: The existing charge GUID to update. in: path name: documentId required: true schema: description: El GUID del cobro existente que se va a actualizar. type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateDynamicQRBody' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/UpdateDynamicQRResponse' description: OK default: content: application/problem+json: schema: $ref: '#/components/schemas/Detail' description: Error components: schemas: UpdateDynamicQRBody: additionalProperties: false properties: accountId: description: El id de cuenta del CRM del beneficiario (aporta nombre + ciudad). type: string amount: description: Monto en reales (un número JSON). format: double type: number description: description: Entradas de datos adicionales opcionales (dadosAdicionais). items: $ref: '#/components/schemas/AdditionalDataBody' type: array nullable: true expirationTime: description: Expiración del QR en segundos. format: int64 type: integer key: description: La clave Pix del beneficiario a la que paga el QR dinámico. type: string payer: $ref: '#/components/schemas/PayerBody' recipientConciliationId: description: Id de conciliación (idConciliacaoRecebedor). type: string status: description: >- Estado del cobro: 0=Active, 1=Concluded, 2=Removed by recipient, 3=Removed by PSP. format: int64 type: integer zipCode: description: Código postal del beneficiario (cep). type: string required: - key - amount - accountId - status type: object UpdateDynamicQRResponse: additionalProperties: false properties: payloadUrl: description: >- La URL del host JWS resoluble que embebe el QR dinámico (urlPayloadJson; sin esquema). type: string qrCode: description: >- El payload del QR EMV actualizado (decodificado de base64, listo para renderizar). type: string revision: description: La revisión del cobro calculada por el upstream (revisao). format: int64 type: integer required: - qrCode - revision 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 AdditionalDataBody: additionalProperties: false properties: name: description: El nombre de la entrada de datos adicionales. type: string value: description: El valor de la entrada de datos adicionales. type: string required: - name - value type: object PayerBody: additionalProperties: false properties: document: description: Documento del pagador (CPF/CNPJ). type: string name: description: Nombre del titular pagador (solo se reenvía junto con un documento). type: string validate: description: Si el documento del pagador debe validarse en la liquidación. type: boolean 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). ````