PIX

PIX on Brasilian välitön maksujärjestelmä, jota Banco Central do Brasil (BACEN) hallinnoi. BR Code QR -muoto on EMVCo MPM -alijoukko, jossa Merchant Account Information (tagi 26) kantaa PIX-avainta, joka voi olla CPF, CNPJ, sähköposti, puhelinnumero tai satunnainen EVP. PIX sai ensimmäisen biljoonan realin selvitettyä alle kahdessa vuodessa lanseerauksesta (2020 → 2022) ja on nyt Brasilian hallitseva vähittäismaksujärjestelmä.

Kanoninen spesifikaatio:Banco Central do Brasil, PIX-dokumentaatio. Ydinresoluutio: BACEN Resolution 103/2021, Manual de Padrões para Iniciação do Pix.
Yläspesifikaatio:EMVCo MPM v1.1. PIX varaa kauppiastilin tagin 26; kaikki muu on peritty EMVCo:lta.
Koodaus: TLV (Tag-Length-Value) 2-numeroisilla tageilla, 2-numeroisilla pituuksilla ja CRC16-CCITT-perällä.

BR Code -rakenne, tagi 26 (PIX Merchant Account Information)

PIX-kohtainen sisältö sijaitsee tagissa 26. Se on itse sisäkkäinen TLV-rakenne, jossa on nämä alitägit:

Alitagi	Nimi	Pituus	Huomiot
`00`	GUI, globaali yksilöllinen tunniste	14	Kiinteä arvo `br.gov.bcb.pix`. Tunnistaa järjestelmän PIX:ksi.
`01`	PIX-avain	vaihteleva	CPF (11 numeroa), CNPJ (14 numeroa), sähköposti, puhelin (+55DDPHONE) tai EVP (UUID-tyyppinen satunnaisavain).
`02`	Lisätiedot	vaihteleva, ≤72	Vapaamuotoinen maksajaviesti. Näytetään maksajalle heidän pankkisovelluksessaan.
`25`	URL, dynaaminen PIX	vaihteleva	Käytetään vain dynaamiselle PIX:lle: maksajan sovellus hakee skannauksessa täyden hyötykuorman tästä URL:sta (summa, eräpäivä, vanhentuminen, alennus/sakko). Staattinen PIX jättää tagin 25 kokonaan pois.

PIX-avaintyypit

Avaintyyppi	Muoto	Validointi
CPF (henkilön verotunniste)	11 numeroa, ei välimerkkejä QR-hyötykuormassa	Mod-11-tarkistussumma kahdelle viimeiselle numerolle. Maski `123.456.789-09` → raaka `12345678909`.
CNPJ (yrityksen verotunniste)	14 numeroa, ei välimerkkejä	Kaksi mod-11-tarkistussummaa. Maski `12.345.678/0001-95` → raaka `12345678000195`.
Sähköposti	RFC 5321 -yhteensopiva, enintään 77 merkkiä	BACEN muuntaa pieniksi kirjaimiksi rekisteröinnin yhteydessä; QR-hyötykuorman on vastattava rekisteröityä kirjainkokoa.
Puhelin	E.164 maakoodilla `+55`, enintään 14 merkkiä	Muoto: `+55DDNNNNNNNNN`, jossa DD on 2-numeroinen suuntanumero. Ei välilyöntejä tai viivoja.
EVP (satunnaisavain)	UUID v4 -muoto, 36 merkkiä	Maksajan pankki luo palvelimella rekisteröinnin yhteydessä. Suositeltava kauppiaille, jotka eivät halua paljastaa CPF/CNPJ/sähköposti/puhelin.

Staattinen vs dynaaminen PIX

Staattinen PIX (Point of Initiation 11). Kaikki koodattu QR:ään: PIX-avain, kauppiaan nimi, kauppiaan kaupunki, valinnainen kiinteä summa, valinnainen viite. Maksajan sovellus lukee suoraan ja valtuuttaa. Paras tulostetuille tarroille, laskuille, ikkunajulisteille. Summa voidaan jättää pois (maksaja kirjoittaa sen) tai kiinnittää (tarkka maksu).
Dynaaminen PIX (Point of Initiation 12). QR kantaa URL:a (alitagi 25). Maksajan sovellus hakee skannauksessa JWS-allekirjoitetun JSON-hyötykuorman kyseisestä URL:sta, jossa on summa, eräpäivä, vanhentumisikkuna ja valinnaiset myöhästymismaksu/alennussäännöt. Vaaditaan laskutuslaskuille, joilla on vanhentumispäiviä (boletos híbridos). Käytetään myös PIX Cobrançaan (laskutus).

Kanoninen testvektori, staattinen PIX CPF-avaimella ja kiinteällä summalla

CPF 12345678909, kauppias LOJA TESTE paikassa SAO PAULO, kiinteä summa R$10.00, ei tapahtumaviitettä:

00020126360014br.gov.bcb.pix0114123456789095204000053039865406010.005802BR5910LOJA TESTE6009SAO PAULO62070503***6304XXXX

Tagi	Arvo	Merkitys
`00`	`01`	Hyötykuormamuodon ilmaisin (aina `01`)
`01`	`11`	Staattinen aloituspiste
`26`	36 tavua sisäkkäistä TLV:tä	PIX Merchant Account Information
├─ `00`	`br.gov.bcb.pix`	GUI
├─ `01`	`12345678909`	CPF-avain (11 numeroa)
`52`	`0000`	MCC, tuntematon / henkilökohtainen
`53`	`986`	ISO 4217 -valuuttakoodi BRL:lle
`54`	`10.00`	Kiinteä tapahtuman summa
`58`	`BR`	Maakoodi
`59`	`LOJA TESTE`	Kauppiaan nimi (enintään 25 merkkiä EMVCo:n mukaan)
`60`	`SAO PAULO`	Kauppiaan kaupunki (enintään 15 merkkiä)
`62`	7 tavua sisäkkäistä	Lisädatamalli
├─ `05`	`***`	Viitemerkki (paikkamerkki ilman viitettä)
`63`	`XXXX`	CRC16-CCITT kaikesta edeltävästä (laske uudelleen koodauksen yhteydessä)

Yleiset sudenkuopat

CPF/CNPJ-peittäminen. QR-hyötykuorma käyttää vain peittelemättömiä numeroita (12345678909, ei 123.456.789-09). Jotkut koodigeneraattorit jättävät pisteet ja viivat vahingossa, tuloksena QR epäonnistuu jokaisessa pankkisovelluksessa "chave PIX inválida" -viestillä.
Merkkisarja on tärkeä. BACEN-spesifikaatio määrää ISO/IEC 8859-1 (Latin-1) kauppiaan nimelle ja kaupungille. Aksenttimerkit (São Paulo) on koodattava Latin-1:ksi ennen TLV-pituuden laskemista, ei UTF-8:lla. UTF-8-koodaus kasvattaa tavumäärää ja rikkoo pituuskentän.
CRC-laskenta. CRC16-CCITT (polynomi 0x1021, init 0xFFFF, ei loppuXOR:ia) kattaa kaiken tagista 00 tagiin 6304, mukaan lukien CRC-kentän kirjaimellinen tagi+pituus. Yleinen virhe: CRC laskettu väärältä alueelta, QR jäsennetään oikein joissakin sovelluksissa ja epäonnistuu muissa.
Summamuoto on merkkijono, ei luku. Tagi 54 on merkkijono: 10.00, ei 1000. Kaksi desimaalia vaaditaan. Enintään kaksi desimaalia, BRL:llä ei ole sentin alaisia nimellisarvoja.
Staattisella PIX:llä ei ole sisäänrakennettua palautusta. Kerran maksettu staattinen PIX on välitön ja lopullinen. Kauppiaiden on käsiteltävä palautukset ulkopuolisesti (käänteinen PIX kauppiaalta maksajalle). Näytä tämä selkeästi tulostetuissa materiaaleissa.
Tarrakerrostusvilppi. Kassatiskeillä olevia fyysisiä PIX QR -tarroja on hyökätty kerrostusvärjäyksellä, hyökkääjät liimaavat oman QR-koodinsa kauppiaan päälle. Kierrätä staattisia QR-koodeja säännöllisesti, laminoi ne ja näytä odotettu PIX-avain selkokielisenä tekstinä tarran vieressä, jotta maksaja voi tarkistaa.
Investointi-/arvopaperirajoitus. Comissão de Valores Mobiliários (CVM) kieltää PIX:n rekisteröimättömässä sijoitustarjouksessa. PIX QR -koodit laskeutumissivuilla tokeneille, "taatun tuoton" tuotteille tai MLM-järjestelmille käynnistävät CVM:n täytäntöönpanotoimet.
Dynaaminen PIX vaatii live-päätepistettä. Jos tagin 25 URL on pois käytöstä, maksu epäonnistuu skannauksessa. Käytä isäntää, jota hallitset, ja pidä se käynnissä vähintään QR-koodin tulostetun elinkaaren ajan.

Pankkisovellusyhteensopivuus

Jokainen lisensoitu PIX-osallistuja (pankki tai maksulaitos) tukee BR Codea kuluttajasovelluksessaan. Merkittävät toteutukset:

Sovellus	Staattinen	Dynaaminen	Huomiot
Itaú, Bradesco, Santander, BB, Caixa	Kyllä	Kyllä	Top-5-pankit. Täydellinen PIX-tuki sisältäen Cobrança, agendado ja devolução.
Nubank	Kyllä	Kyllä	Suosituin neopankki Brasiliassa. Selkeä PIX-käyttöliittymä.
Inter, C6 Bank, PicPay	Kyllä	Kyllä	Täydellinen PIX-tuki.
Mercado Pago	Kyllä	Kyllä	Maksulaitos; PIX on yksi useista maksujärjestelmistä samassa sovelluksessa.
Yleinen iOS/Android-kamera	Ei	Ei	Natiivit kamerasovellukset eivät jäsennä BR Codea maksuaikomuksena. Käyttäjän on ensin avattava pankkisovellus.

Katso myös

/pix-qr-code/, PIX-generaattori CPF/CNPJ-validoinnilla ja live BR Code -koodauksella.
/standards/emvco/, EMVCo MPM -yläspesifikaatio.
/standards/upi/, UPI Intia, toinen EMVCo-johdettu järjestelmä tagilla 26.
/standards/, takaisin standardihakemistoon.

Spesifikaatioviitteet vahvistettu 2026-04-19. BACEN Resolution 103/2021, EMVCo MPM v1.1, PIX Manual de Padrões v2.0.