Gerar QR Code PIX Estático

Gera um QR Code PIX do tipo estático a partir de uma chave PIX existente, com valor e descrição opcionais.

Este endpoint permite gerar um QR Code PIX estático, vinculado a uma chave PIX previamente cadastrada na conta.

O QR Code gerado pode ser utilizado para recebimentos instantâneos, pagamentos avulsos, cobranças simples e integrações com pontos de venda (PDV).

Diferente do QR Code dinâmico, o QR Code estático pode ser reutilizado para múltiplas transações, mantendo os mesmos dados de identificação.

O corpo da requisição deve conter:

• key: identificador ou valor da chave PIX (UUID, CPF, CNPJ, telefone ou e-mail);

• amount: valor opcional do pagamento (em reais, com até duas casas decimais);

• description: texto descritivo da cobrança (até 255 caracteres).

O retorno inclui:

• text → o código EMV completo (conteúdo textual do QR Code);

• image → o QR Code em base64 (pode ser renderizado diretamente em tela).

Endpoint para Criar Qr Code Estático

POST /accounts/{accountId}/pix/qrcode/static

Este endpoint é protegido e requer o uso do cabeçalho Authorization: Bearer <token> e x-tenant-id.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>
x-tenant-id	Tenant ID

Body

Name	Type	Description
key	string	Chave para qual o QR Code será atrelado
amount	number	Valor
description	string	Descrição (opcional)

Response

200

{
  "qrCode": {
    "image": "iVBORw0KGgoAAAANSUhEUgAAAUAAAAFACAYAAABzFzsuAAAABHNCSVQICAgIfAhkiAAAA...",
    "text": "00020126580014BR.GOV.BCB.PIX0136a87b1234-fb11-4d31-a9a2-5de9b1a07cb85204000053039865404150.005802BR5918Juliana Santos Almeida6014Rio de Janeiro61083004000063047E25"
  }
}

404

{
    "code": "NOT_FOUND",
    "error": "Informações da chave pix não encontrada",
    "message": "Informações da chave pix não encontrada"
}