Pular para o conteúdo
xFlow Payments

Glossário

O que é BR Code

BR Code é o padrão de QR Code para iniciar pagamentos adotado no Brasil, baseado no padrão EMV e documentado pelo Banco Central. O Pix copia e cola é o mesmo conteúdo do QR Code em forma de texto, e na API da xFlow ele vem no campo pix.copyPaste.

Atualizado em · Equipe xFlow Payments · 2 min de leitura

Todo QR Code Pix é um BR Code. A imagem que o pagador escaneia e o texto que ele cola no app são duas formas do mesmo conteúdo: uma sequência de campos com os dados do recebedor e da transação.

Como o BR Code é montado

O Manual BR Code do Banco Central (versão 2.0.1, de 31/08/2020) explica que o BR Code segue o padrão EMV de QR Codes para sistemas de pagamento, no modo em que o recebedor apresenta o código. O conteúdo, chamado payload, é uma sequência de objetos no formato ID, tamanho e valor: dois dígitos de ID, dois dígitos de tamanho e o valor. Um objeto pode conter outros, formando uma árvore.

Os campos principais:

ID Campo Conteúdo
00 Payload Format Indicator Versão do payload, fixa em 01.
26 Merchant Account Information Dados do arranjo. No Pix, o GUI BR.GOV.BCB.PIX e a chave.
52 Merchant Category Code 0000 ou o código da categoria.
53 Transaction Currency 986, o real.
54 Transaction Amount Valor, opcional.
58 Country Code BR.
59 Merchant Name Nome do recebedor.
60 Merchant City Cidade.
62 Additional Data Field Inclui o campo 05, o identificador da transação.
63 CRC16 Verificação de integridade do payload.

No QR Code dinâmico, o Manual de Padrões para Iniciação do Pix (versão 2.10.0, de 19/08/2026) diz que valor e txid valem os do payload JSON obtido pela URL do código, e não os campos do BR Code.

Na API da xFlow

  • pix.copyPaste: o payload EMV no padrão BR Code, pronto para o copia e cola. Pela documentação, o campo 54 é o valor quando o QR é de valor fixo, e o campo 26 traz a chave Pix. Trate o código como opaco e repasse sem alterar.
  • pix.qrCodeBase64: o mesmo conteúdo já desenhado como QR, em PNG data-URL, pronto para <img src>.
  • qr_code em POST /api/v1/transfers: para pagar um BR Code de terceiro com o seu saldo, no saque Pix por API.

Exemplo

Trecho do exemplo do Manual BR Code, separado campo a campo:

text
00 02 01                 versão do payload
26 58 0014BR.GOV.BCB.PIX0136123e4567-e12b-12d1-a456-426655440000
53 03 986                moeda: real
54 06 123.45             valor
58 02 BR                 país
63 04 AD38               CRC16

Na integração, você não precisa montar nem decodificar isso. A API já entrega o texto e a imagem. Veja como exibir os dois em Pix copia e cola por API e QR Code Pix dinâmico por API.

Termos relacionados

  • txid: o identificador que, no QR estático, ocupa o campo 62-05.
  • DICT: onde a chave Pix do campo 26 é consultada.
  • PSP: quem apresenta o QR Code do lado do recebedor.

Conteúdo informativo, atualizado em 25/10/2026. Não substitui orientação jurídica.

Continue lendo