PIX

PIX ialah skim pembayaran segera Brazil, dikendalikan oleh Banco Central do Brasil (BACEN). Format QR BR Code ialah subset EMVCo MPM dengan Maklumat Akaun Peniaga (teg 26) membawa kunci PIX, boleh jadi CPF, CNPJ, e-mel, nombor telefon, atau EVP rawak. PIX menyelesaikan trilion real pertama dalam masa kurang dari dua tahun sejak dilancarkan (2020 → 2022) dan kini menjadi rangkaian pembayaran runcit dominan di Brazil.

Spesifikasi kanonik:Banco Central do Brasil, dokumentasi PIX. Resolusi teras: BACEN Resolution 103/2021, Manual de Padrões para Iniciação do Pix.
Spesifikasi induk:EMVCo MPM v1.1. PIX menempah teg akaun peniaga 26; selebihnya diwarisi dari EMVCo.
Pengekodan: TLV (Tag-Length-Value) dengan teg 2 digit, panjang 2 digit, dan trailer CRC16-CCITT.

Struktur BR Code, teg 26 (PIX Merchant Account Information)

Kandungan khusus PIX terdapat dalam teg 26. Ia sendiri merupakan struktur TLV bersarang dengan sub-teg berikut:

Sub-teg	Nama	Panjang	Nota
`00`	GUI, Pengecam Unik Global	14	Nilai tetap `br.gov.bcb.pix`. Mengenal pasti skim sebagai PIX.
`01`	Kunci PIX	berubah-ubah	CPF (11 digit), CNPJ (14 digit), e-mel, telefon (+55DDPHONE), atau EVP (kunci rawak seperti UUID).
`02`	Maklumat tambahan	berubah-ubah, ≤72	Mesej teks bebas untuk pembayar. Dipaparkan kepada pembayar dalam apl perbankan mereka.
`25`	URL, PIX dinamik	berubah-ubah	Digunakan hanya untuk PIX dinamik: apl pembayar mengambil muatan penuh dari URL ini semasa imbasan (jumlah, tarikh matang, tamat tempoh, diskaun/denda). PIX statik menghilangkan teg 25 sepenuhnya.

Jenis kunci PIX

Jenis kunci	Format	Pengesahan
CPF (ID cukai individu)	11 digit, tiada tanda baca dalam muatan QR	Checksum Mod-11 pada 2 digit terakhir. Topeng `123.456.789-09` → mentah `12345678909`.
CNPJ (ID cukai korporat)	14 digit, tiada tanda baca	Dua checksum mod-11. Topeng `12.345.678/0001-95` → mentah `12345678000195`.
E-mel	Mematuhi RFC 5321, maks 77 aksara	BACEN menukar kepada huruf kecil semasa pendaftaran; muatan QR mesti sepadan dengan kes yang didaftarkan.
Telefon	E.164 dengan kod negara `+55`, maks 14 aksara	Format: `+55DDNNNNNNNNN` di mana DD ialah kod kawasan 2 digit. Tiada ruang atau tanda sempang.
EVP (kunci rawak)	Format UUID v4, 36 aksara	Dijana di sisi pelayan oleh bank pembayar semasa pendaftaran. Disyorkan untuk peniaga yang tidak mahu mendedahkan CPF/CNPJ/e-mel/telefon.

PIX statik berbanding PIX dinamik

PIX statik (Point of Initiation 11). Semua dikodkan dalam QR: kunci PIX, nama peniaga, bandar peniaga, jumlah tetap pilihan, rujukan pilihan. Apl pembayar membaca terus dan memberi kebenaran. Terbaik untuk pelekat cetak, invois, poster tingkap. Jumlah boleh ditinggalkan (pembayar menaipnya) atau ditetapkan (caj tepat).
PIX dinamik (Point of Initiation 12). QR membawa URL (sub-teg 25). Apl pembayar mengambil muatan JSON bertandatangan JWS dari URL tersebut semasa imbasan, mengandungi jumlah, tarikh matang, tetingkap tamat tempoh, dan peraturan caj lewat/diskaun pilihan. Diperlukan untuk invois pengebilan dengan tarikh tamat tempoh (boletos híbridos). Juga digunakan untuk PIX Cobrança (pengebilan).

Vektor ujian kanonik, PIX statik dengan kunci CPF dan jumlah tetap

CPF 12345678909, peniaga LOJA TESTE di SAO PAULO, jumlah tetap R$10.00, tiada rujukan transaksi:

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

Teg	Nilai	Makna
`00`	`01`	Penunjuk format muatan (sentiasa `01`)
`01`	`11`	Titik permulaan statik
`26`	36 bait TLV bersarang	PIX Merchant Account Information
├─ `00`	`br.gov.bcb.pix`	GUI
├─ `01`	`12345678909`	Kunci CPF (11 digit)
`52`	`0000`	MCC, tidak diketahui / peribadi
`53`	`986`	Kod mata wang ISO 4217 untuk BRL
`54`	`10.00`	Jumlah transaksi tetap
`58`	`BR`	Kod negara
`59`	`LOJA TESTE`	Nama peniaga (maks 25 aksara mengikut EMVCo)
`60`	`SAO PAULO`	Bandar peniaga (maks 15 aksara)
`62`	7 bait bersarang	Templat data tambahan
├─ `05`	`***`	Label rujukan (pemegang tempat tanpa rujukan)
`63`	`XXXX`	CRC16-CCITT atas semua sebelumnya (kira semula semasa pengekodan)

Perangkap biasa

Penyamaran CPF/CNPJ. Muatan QR menggunakan digit tanpa topeng sahaja (12345678909, bukan 123.456.789-09). Sesetengah penjana kod meninggalkan titik dan tanda sempang secara tidak sengaja, QR yang terhasil gagal dalam setiap apl perbankan dengan "chave PIX inválida."
Set aksara penting. Spesifikasi BACEN menyatakan ISO/IEC 8859-1 (Latin-1) untuk nama peniaga dan bandar. Aksara beraksen (São Paulo) mesti dikodkan dalam Latin-1 sebelum panjang TLV dikira, bukan UTF-8. Pengekodan UTF-8 meningkatkan bilangan bait dan merosakkan medan panjang.
Pengiraan CRC. CRC16-CCITT (polinomial 0x1021, init 0xFFFF, tiada XOR akhir) merangkumi semua dari teg 00 hingga 6304, termasuk teg+panjang literal medan CRC itu sendiri. Pepijat biasa: CRC dikira atas julat yang salah, QR dihuraikan dengan betul pada sesetengah apl dan gagal pada yang lain.
Format jumlah ialah rentetan, bukan nombor. Teg 54 ialah rentetan: 10.00, bukan 1000. Dua tempat perpuluhan diperlukan. Maks dua perpuluhan, BRL tidak mempunyai denominasi sub-sen.
PIX statik tidak mempunyai bayaran balik terbina dalam. Selepas dibayar, PIX statik adalah serta-merta dan muktamad. Peniaga perlu mengendalikan bayaran balik di luar jalur (PIX terbalik dari peniaga kepada pembayar). Paparkan ini dengan jelas pada bahan cetak.
Penipuan hamparan pelekat. Pelekat PIX QR fizikal di kaunter juruwang telah diserang dengan penipuan hamparan, penyerang melekatkan QR mereka di atas QR peniaga. Tukar pelekat QR statik secara berkala, laminatkan, dan paparkan kunci PIX yang dijangkakan sebagai teks biasa di sebelah pelekat supaya pembayar dapat mengesahkan.
Sekatan pelaburan/sekuriti. Comissão de Valores Mobiliários (CVM) melarang PIX untuk permohonan pelaburan yang tidak berdaftar. PIX QR pada halaman pendaratan untuk token, produk "pulangan terjamin", atau skim MLM mencetuskan tindakan penguatkuasaan CVM.
PIX dinamik memerlukan titik akhir langsung. Jika URL teg 25 tidak aktif, pembayaran gagal semasa imbasan. Gunakan hos yang anda kawal dan pastikan ia berjalan sekurang-kurangnya sepanjang hayat cetak QR.

Keserasian apl perbankan

Setiap peserta PIX berlesen (bank atau institusi pembayaran) menyokong BR Code dalam apl pengguna mereka. Pelaksanaan ketara:

Apl	Statik	Dinamik	Nota
Itaú, Bradesco, Santander, BB, Caixa	Ya	Ya	5 bank teratas. Sokongan PIX penuh termasuk Cobrança, agendado dan devolução.
Nubank	Ya	Ya	Neobank paling popular di Brazil. UX PIX yang bersih.
Inter, C6 Bank, PicPay	Ya	Ya	Sokongan PIX penuh.
Mercado Pago	Ya	Ya	Institusi pembayaran; PIX ialah salah satu daripada beberapa rangkaian pembayaran dalam apl yang sama.
Kamera iOS/Android generik	Tidak	Tidak	Apl kamera natif tidak menghuraikan BR Code sebagai niat pembayaran. Pengguna perlu membuka apl perbankan terlebih dahulu.

Lihat juga

/pix-qr-code/, penjana PIX dengan pengesahan CPF/CNPJ dan pengekodan BR Code langsung.
/standards/emvco/, spesifikasi induk EMVCo MPM.
/standards/upi/, UPI India, skim lain terbitan EMVCo dengan teg 26.
/standards/, kembali ke indeks piawaian.

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