Skip to main content
Este guia mostra como criar QR Codes PIX para receber pagamentos de forma detalhada, com exemplos práticos e todas as opções disponíveis.

Endpoint

POST /api/v1/pix/in/qrcode

Cria um QR Code PIX para recebimento de pagamentos instantâneos. URL Completa:
  • Produção: https://api.quantumpay.com.br/api/v1/pix/in/qrcode

Headers obrigatórios

Parâmetros do corpo

Campos Obrigatórios

Tipo: number
Descrição: Valor em centavos (ex: 10000 = R100,00)Mıˊnimo:1centavo(R 100,00) **Mínimo**: 1 centavo (R 0,01)
Máximo: 1.000.000.000 centavos (R$ 10.000.000,00)
Tipo: object
Descrição: Dados do cliente pagador
Campos obrigatórios do customer:
  • name (string): Nome completo
  • email (string): Email válido
  • documentType (string): “cpf” ou “cnpj”
  • document (string): Número do documento (apenas números)
  • phone (string): Telefone com DDD

Campos opcionais

Tipo: string
Descrição: Descrição da transação
Limite: 140 caracteres
Padrão: Vazio
Tipo: string
Descrição: URL específica para webhooks desta transação
Formato: URL válida (https://)
Tipo: object
Descrição: Endereço de cobrança do cliente
Tipo: array
Descrição: Lista de itens da compra

Exemplos práticos

Exemplo Básico - Cobrança Simples

Exemplo Completo - E-commerce

Exemplo B2B - CNPJ

Resposta de sucesso (200)

Campos da Resposta

Exibindo o QR Code

Exibir Imagem

Código para Copiar

Implementações por linguagem

JavaScript/Node.js

Python

PHP

❌ Tratamento de Erros

Possíveis Erros

Exemplo de Tratamento

Validações recomendadas

Validação de CPF

Validação de CNPJ


Próximos passos

Configurar webhooks

Configure notificações automáticas de pagamento

PIX OUT

Aprenda a enviar transferências PIX

Status e códigos

Entenda os status e códigos de erro

Segurança

Boas práticas de segurança