> ## 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. # Criar QR code dinamico > Gera um QR code PIX dinamico de uso unico com recursos avancados como expiracao, validacao do pagador e informacoes adicionais de pagamento. Ideal para faturamento e pagamentos controlados. ## OpenAPI ````yaml pt/openapi/v3-current/pix.yaml POST /v1/qrcodes/dynamic openapi: 3.0.3 info: title: Plugin BR Pix Direct - API Completa description: > API completa para o sistema de pagamentos instantaneos PIX brasileiro, incluindo operacoes de dicionario de chaves PIX, geracao/decodificacao de QR codes, transacoes e limites de transacao. 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: post: tags: - API de QR Codes summary: Criar QR code dinamico description: >- Gera um QR code PIX dinamico de uso unico com recursos avancados como expiracao, validacao do pagador e informacoes adicionais de pagamento. Ideal para faturamento e pagamentos controlados. requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateDynamicQRCodeRequest' responses: '200': description: QR code dinamico criado com sucesso content: application/json: schema: $ref: '#/components/schemas/QRCodeResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '500': $ref: '#/components/responses/InternalServerError' components: schemas: CreateDynamicQRCodeRequest: type: object required: - type - key - amount - recipientName - payer - dueDate - expirationTime - city - zipCode - recipientConciliationId - partnerId - description properties: type: type: string description: >- Especifica o tipo do QR Code. Para `IMMEDIATE`, indica um QR Code de uso unico gerado para pagamentos PIX instantaneos com valor predefinido e tempo de expiracao. enum: - IMMEDIATE example: IMMEDIATE key: type: string description: Chave PIX do destinatario. example: '12345678901' amount: type: number description: Valor para o QR code dinamico. format: double example: 50 recipientName: type: string description: Nome do destinatario (beneficiario). example: João da Silva payer: type: object description: Informacoes do pagador. required: - document - validate - name properties: document: type: string description: CPF (11 digitos) ou CNPJ (14 digitos) do pagador. example: '98765432100' validate: type: boolean description: Indica se a chave do pagador deve ser validada. example: true name: type: string description: Nome do pagador. example: Maria Santos dueDate: type: string description: Data de vencimento do pagamento (AAAA-MM-DD). format: date example: '2024-12-31' expirationTime: type: integer description: >- Tempo de expiracao em segundos apos o qual o QR code se torna invalido. example: 3600 city: type: string description: Cidade do destinatario. example: São Paulo zipCode: type: string description: CEP do destinatario (8 digitos). example: '01234567' recipientConciliationId: type: string description: Identificador para conciliacao pelo destinatario. example: CONC123456789 partnerId: type: string description: Identificador do sistema parceiro. format: uuid example: 019c96a0-0c0c-7221-8cf3-13313fb60081 description: type: array description: Lista de descricoes para o pagamento. items: type: object required: - name - value properties: name: type: string description: Nome da descricao. example: Invoice value: type: string description: Valor da descricao. example: INV-001 QRCodeResponse: type: object required: - qrCode properties: qrCode: type: string description: String do QR code PIX gerado. example: >- 00020101021226850014br.gov.bcb.pix2563qrcode.example.com.br/v2/cobv/9d36b84fc70b478fb95c12729b90ca255204000053039865802BR5913Merchant Name6009Sao Paulo62070503***63042C43 ErrorResponse: type: object properties: code: type: string description: Codigo do erro message: type: string description: Mensagem de erro details: type: array items: type: string description: Detalhes adicionais do erro responses: BadRequest: description: Requisicao Invalida - Parametros invalidos content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_key_type: summary: Invalid key type value: code: INVALID_KEY_TYPE message: Key type must be between 0 and 4 details: - 'keyType: must be one of [0, 1, 2, 3, 4]' missing_required_field: summary: Missing required field value: code: VALIDATION_ERROR message: Required field is missing details: - 'accountId: field is required' invalid_document_format: summary: Invalid document format value: code: INVALID_DOCUMENT message: Document must be valid CPF (11 digits) or CNPJ (14 digits) details: - 'document: must match pattern ^\d{11}$|^\d{14}$' invalid_phone_format: summary: Invalid phone format value: code: INVALID_PHONE message: Phone must be in Brazilian format details: - 'phone: must match pattern ^\+55\d{2}\d{8,9}$' Unauthorized: description: Nao Autorizado - Autenticacao invalida ou ausente content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: missing_token: summary: Missing authentication token value: code: MISSING_TOKEN message: Authorization header is required details: [] invalid_token: summary: Invalid token value: code: INVALID_TOKEN message: Invalid or expired access token details: [] expired_token: summary: Expired token value: code: TOKEN_EXPIRED message: Access token has expired. Please obtain a new token. details: [] InternalServerError: description: Erro Interno do Servidor content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: generic_error: summary: Generic internal error value: code: INTERNAL_ERROR message: An internal error occurred. Please try again later. details: [] database_error: summary: Database error value: code: DATABASE_ERROR message: Database operation failed details: [] external_service_error: summary: External service error value: code: EXTERNAL_SERVICE_ERROR message: External service (JD PIX) is temporarily unavailable details: [] securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Autenticacao por token JWT Bearer. Obtenha o token no endpoint `/v1/login/oauth/access_token` usando credenciais do cliente (clientId e clientSecret). Inclua o token no header Authorization: `Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...` O token expira apos 3600 segundos (1 hora). ````