> ## Documentation Index > Fetch the complete documentation index at: https://docs.quantumpay.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Criar QR Code PIX para recebimento > Cria um QR Code PIX para receber pagamentos instantâneos ## OpenAPI ````yaml /openapi.yaml post /api/v1/pix/in/qrcode openapi: 3.1.0 info: title: API Quantum Pay description: >- API para gerenciamento de pagamentos PIX da Quantum Pay. Permite criar QR codes para recebimento, realizar transferências PIX e gerenciar webhooks. version: 1.0.0 contact: name: Quantum Pay email: contato@quantumhubpay.com url: https://quantumpay.com.br servers: - url: https://api.quantumpay.com.br description: Ambiente de produção security: [] tags: - name: Autenticação description: Endpoints para autenticação e geração de tokens - name: Empresa description: Endpoints para consulta de dados da empresa - name: PIX IN description: Endpoints para recebimento de pagamentos PIX - name: PIX OUT description: Endpoints para envio de transferências PIX - name: Webhooks description: Endpoints para gerenciamento de webhooks paths: /api/v1/pix/in/qrcode: post: tags: - PIX IN summary: Criar QR Code PIX para recebimento description: Cria um QR Code PIX para receber pagamentos instantâneos requestBody: required: true content: application/json: schema: type: object required: - amountInCents - customer properties: amountInCents: type: integer minimum: 100 description: Valor em centavos (mínimo R$ 1,00) example: 5000 description: type: string maxLength: 140 description: Descrição que aparecerá no extrato do pagador example: Pagamento de serviços postbackUrl: type: string format: uri description: URL para receber notificações de webhook example: https://exemplo.com.br/webhook customer: $ref: '#/components/schemas/Customer' items: type: array description: Lista de itens do pedido items: $ref: '#/components/schemas/Item' metadata: type: object description: Metadados adicionais (UTMs, dados do checkout, etc.) additionalProperties: true example: utm_source: google checkout: shopify responses: '201': description: QR Code criado com sucesso content: application/json: schema: $ref: '#/components/schemas/PixQRCodeResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/RateLimited' security: - bearerAuth: [] components: schemas: Customer: type: object required: - name - email - documentType - document - phone properties: name: type: string description: Nome completo do cliente example: Cliente Exemplo email: type: string format: email description: Email do cliente example: cliente@exemplo.com documentType: type: string enum: - cpf - cnpj description: Tipo de documento do cliente (obrigatório) example: cpf document: type: string description: CPF ou CNPJ do cliente (apenas números) example: '11122233344' phone: type: string description: Telefone do cliente com DDD example: '11912345678' billingAddress: $ref: '#/components/schemas/Address' Item: type: object required: - title - quantity - amountInCents properties: title: type: string description: Nome do item example: Produto A tangible: type: boolean description: Se o item é tangível (produto físico) example: false quantity: type: integer minimum: 1 description: Quantidade example: 2 amountInCents: type: integer description: Valor total do item em centavos (quantidade x preço unitário) example: 5000 PixQRCodeResponse: type: object properties: success: type: boolean description: Indica se a operação foi bem-sucedida example: true message: type: string description: Mensagem de retorno example: Transação criada com sucesso data: type: object properties: id: type: string description: ID único da transação example: trx_1a2b3c4d5e6f7g8h9i0j pix: type: object properties: emv: type: string description: Código EMV (copia e cola) example: 00020126...SEU_CODIGO_EMV_AQUI...6304ABCD qrCode: type: string description: Imagem do QR Code em Base64 example: '[BASE64_ENCODED_QRCODE_IMAGE]' status: type: string enum: - pending - paid - canceled - refunded description: Status da transação example: pending fees: type: integer description: Taxa cobrada em centavos example: 0 Address: type: object required: - street - number - neighborhood - city - state - zipCode properties: street: type: string description: Logradouro example: Rua Exemplo number: type: string description: Número example: '100' neighborhood: type: string description: Bairro example: Centro city: type: string description: Cidade example: São Paulo state: type: string description: Estado (sigla) example: SP zipCode: type: string description: CEP example: '01001000' Error: type: object properties: error: type: string description: Código do erro example: INVALID_REQUEST message: type: string description: Mensagem de erro example: O campo 'amount' é obrigatório details: type: object description: Detalhes adicionais do erro additionalProperties: true responses: BadRequest: description: Requisição inválida content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Não autorizado content: application/json: schema: $ref: '#/components/schemas/Error' example: error: UNAUTHORIZED message: Token de autenticação inválido ou expirado RateLimited: description: Limite de taxa excedido content: application/json: schema: $ref: '#/components/schemas/Error' example: error: RATE_LIMITED message: Muitas requisições. Tente novamente em alguns minutos. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: Token JWT no cabeçalho Authorization ````