Pix QR Code Generator

BR Code fields and the CRC16 checksum

The Pix copy-and-paste is a sequence of TLV fields (Tag, Length, Value): a 2-digit identifier, the value length in 2 digits and the value. Field 00 is the format version, 01 says whether the code is static (11) or dynamic (12), 26 carries the recipient account (the br.gov.bcb.pix identifier, the Pix key and an optional description in subfields), 52 is the merchant category, 53 the currency (986, the real) and 54 the amount, when there is one. Fields 58, 59 and 60 carry the country (BR), name (up to 25 characters) and city (up to 15), and 62 holds the transaction reference.

The last field, 63, is the CRC16 (CCITT-FALSE variant: polynomial 0x1021, initial value 0xFFFF), computed over the whole text up to it, including the 6304 characters that open the field itself. Changing a single character changes the CRC, which is how bank apps reject a corrupted or tampered code. Because lengths use 2 digits, no field goes past 99 characters, including 26, which holds the identifier, key and description together.

• Field 01: 11 for a static code, 12 for a dynamic one.
• Field 26: br.gov.bcb.pix, key and optional description, 99 characters in total at most.
• Field 54: amount with a dot and two decimals. Without this field, the payer types the amount.
• Field 62: reference (txid) with up to 25 letters and numbers, or *** when there is none.
• Field 63: CRC16 of the rest of the code.

CPF, CNPJ, email, phone and random key

Each key type enters the code in its own way. CPF goes in as 11 digits and CNPJ as 14 characters, without punctuation, and the check digits are verified before generating (CNPJ may be alphanumeric in the new format). Email goes in lowercase. The phone goes in international format, with the +55 prefix, area code and number, without spaces, parentheses or dashes: the tool adds the +55 for you. A random key (EVP) is a UUID of 32 hexadecimal characters with hyphens, and the tool also accepts it pasted without hyphens and rewrites it in the right format.

Eleven bare digits can be a CPF or a phone typed without the +55. Since a phone key requires the +55, the tool reads bare numbers as a CPF and, if the CPF is invalid and the digits look like a mobile number, suggests using it as a phone. It validates only the format: it can never know whether the key is registered, active or yours, which exists only inside the Central Bank system and the institutions.

From the QR code on screen to the shop counter

For the counter, the poster button opens the print dialog with an A6 or A5 sheet showing Pague com Pix (Pay with Pix), the large QR code, the recipient name, the amount (or a note that the payer chooses) and the city. For anyone charging several people, the bulk tab reads a list of lines as label;amount;txid, generates one QR code per line with your key and hands you a ZIP with the PNGs (and SVGs, if you want) plus a CSV spreadsheet with the copy-and-paste codes.

The Read copy-and-paste tab does the reverse, from the payer side: it shows the key, name, city, amount and reference of a code you received, checks the CRC and points out what is off-standard. It is the fastest way to test a code generated here or to doubt a code that arrived in a message.

What this tool does and what it does not

The tool runs entirely in your browser. Key, name, city and amount are not sent to a server, and nothing stays saved unless you turn on the remember option, which stores only key, name and city in this browser. Remember that a QR code is open text: whoever scans it or pastes the copy-and-paste text reads the whole key. So on a poster, menu or website, a random key is a better choice than a CPF, phone or email.

Generating a QR code does not create or register the key: it must already exist and be active at your bank, or the payment fails. The generated code is static and does not identify who paid. If you need a charge with an amount, due date and automatic reconciliation, the way to go is dynamic Pix, generated by the payment provider.