Pembuat Kode QR PIX
Buat kode QR pembayaran PIX Brasil statis menggunakan bidang BR Code terstruktur dan checksum CRC16 yang dihitung.
Generator ini menyimpan URI GS1 Digital Link langsung di dalam kode QR. Pengalihan dinamis Premium QR tidak digunakan untuk kode GS1 Digital Link.
Kustomisasi Lanjutan
Warna & Gradien
Logo & Ikon Sosial
Ukuran Kode QR
Pembuat Kode QR PIX
Jawaban singkat: Kode QR PIX — secara resmi disebut BR Code — mengikuti format TLV EMVCo MPM yang ditentukan oleh Banco Central do Brasil (BCB). Payload diakhiri checksum CRC-16/CCITT-FALSE wajib. Kunci PIX dapat berupa ID pajak CPF/CNPJ, telepon, e-mail, atau UUID EVP acak.
Cara membuat kode QR PIX
- Masukkan kunci PIX Anda — pengenal yang ditautkan ke rekening bank penerima. Ini dapat berupa CPF, CNPJ, nomor ponsel Brasil dalam format +5511999999999, alamat e-mail, atau UUID EVP acak yang diberikan penyedia layanan pembayaran Anda.
- Masukkan nama merchant dalam karakter ASCII huruf besar, maksimum 25 karakter, tanpa aksen atau karakter khusus.
- Masukkan kota merchant dalam karakter ASCII huruf besar, maksimum 15 karakter.
- Masukkan jumlah tetap jika pembayaran memiliki nilai yang diketahui, atau biarkan kosong untuk QR statis bernilai terbuka yang akan diisi oleh pembayar.
- Masukkan ID transaksi (TXID) jika Anda perlu merekonsiliasi pembayaran. Untuk QR statis bernilai terbuka, gunakan tiga tanda bintang (***) sebagai placeholder TXID.
- Verifikasi kode yang dibuat dengan memindainya menggunakan aplikasi perbankan berkemampuan PIX sebelum mengunduh.
- Sesuaikan pola, gaya mata, warna, dan logo bila diperlukan, lalu ekspor PNG, SVG, WEBP, atau JPG hingga 4096 px.
Kode QR dibuat di browser Anda. Tidak ada yang Anda masukkan dikirim ke server.
Apa itu kode QR PIX
Kode QR PIX — disebut BR Code dalam spesifikasi resmi — adalah payload inisiasi pembayaran yang dikodekan sebagai kode QR. Ia mengikuti EMVCo standar QRCPS-MPM (Merchant Presented Mode), yang diterapkan di Brasil oleh Banco Central do Brasil (BCB) dalam BR Code Manual, versi 2.0, tertanggal Mei 2020.
PIX adalah sistem pembayaran instan Brasil, dioperasikan dan diatur oleh Banco Central do Brasil. Semua lembaga keuangan Brasil berlisensi wajib mendukung PIX. Pembayaran diselesaikan secara real time sepanjang waktu, termasuk akhir pekan dan hari libur. Sistem ini wajib — bukan sukarela — bagi lembaga di atas ambang ukuran tertentu.
Kode QR PIX bukan nomor rekening bank. Kode ini berisi kunci PIX, yaitu alias yang ditautkan ke rekening. Infrastruktur PIX BCB menyelesaikan kunci ke detail rekening sebenarnya pada saat pembayaran. Pembayar tidak pernah melihat nomor rekening.
Kode QR PIX statis dapat digunakan kembali. Kode QR PIX dinamis (format COB atau COBV) dibuat oleh penyedia layanan pembayaran (PSP) untuk transaksi tertentu dan berisi URL yang diselesaikan aplikasi pembayar secara real time. Pembuat ini membuat kode QR statis. Kode dinamis memerlukan PSP API.
Struktur teknis PIX BR Code
EMVCo Format TLV
Payload PIX menggunakan pengodean EMVCo Tag-Length-Value (TLV). Setiap bidang direpresentasikan oleh ID tag dua digit, diikuti panjang bidang dua digit, lalu isi bidang. Bidang digabung tanpa pemisah.
| Tag | Kolom | Contoh isi | Catatan |
|---|---|---|---|
| 00 | Indikator Format Payload | 01 | Selalu "01" — wajib |
| 01 | Metode Inisiasi di Titik Pembayaran | 11 | 11 = statis/dapat digunakan kembali; 12 = dinamis sekali pakai |
| 26 | Informasi Akun Merchant (PIX) | (subtemplate — lihat di bawah) | Berisi GUI PIX dan kunci PIX |
| 52 | Kode Kategori Merchant | 0000 | 0000 untuk penggunaan umum; kode ISO 18245 berlaku |
| 53 | Mata Uang Transaksi | 986 | 986 = BRL sesuai ISO 4217 |
| 54 | Jumlah Transaksi | 123.45 | Format desimal; hilangkan untuk nilai terbuka |
| 58 | Kode Negara | BR | Selalu "BR" untuk PIX |
| 59 | Nama Merchant | JOAO SILVA | Maksimum 25 karakter ASCII, huruf besar, tanpa aksen |
| 60 | Kota Merchant | SAO PAULO | Maksimum 15 karakter ASCII, huruf besar, tanpa aksen |
| 62 | Template Bidang Data Tambahan | (subtemplate — lihat di bawah) | Berisi TXID |
| 63 | Checksum CRC-16 | Heksadesimal huruf besar 4 karakter | CRC-16/CCITT-FALSE, wajib, selalu terakhir |
Informasi akun merchant (subtemplate tag 26)
Tag 26 berisi struktur TLV bertingkat untuk PIX:
| Subtag | Isi |
|---|---|
| 00 | BR.GOV.BCB.PIX — GUI PIX, selalu tetap |
| 01 | Nilai kunci PIX |
GUI PIX (Globally Unique Identifier) BR.GOV.BCB.PIX adalah string tetap yang ditentukan BCB. String ini mengidentifikasi domain pembayaran sebagai PIX dalam EMVCo framework.
Jenis kunci PIX
Kunci PIX adalah alias terdaftar yang diselesaikan ke rekening bank melalui BCB DICT (direktori rekening transaksional dan pembayaran). Ada empat jenis kunci:
| Jenis kunci | Contoh format | Catatan |
|---|---|---|
| CPF | 12345678901 (11 digit) | ID wajib pajak individu Brasil |
| CNPJ | 12345678000195 (14 digit) | ID wajib pajak badan hukum Brasil |
| Telepon | +5511999999999 | Nomor ponsel Brasil dalam format E.164 |
| Surel | [email protected] | Alamat e-mail terdaftar |
| EVP (acak) | UUID v4, mis. 123e4567-e89b-12d3-a456-… | Kunci yang dibuat acak oleh PSP — tanpa data pribadi |
Kunci EVP (Endereço Virtual de Pagamento) adalah UUID acak yang diberikan oleh penyedia layanan pembayaran. Kunci ini tidak mengandung informasi identitas pribadi dan merupakan pilihan yang menjaga privasi bagi individu yang tidak ingin memublikasikan CPF, telepon, atau e-mail dalam kode QR publik.
Checksum CRC-16
Bidang terakhir setiap payload PIX BR Code adalah tag 63, checksum CRC-16 heksadesimal huruf besar empat karakter yang wajib. Algoritmanya adalah CRC-16/CCITT-FALSE dengan polinomial 0x1021 dan nilai awal 0xFFFF.
Checksum dihitung atas seluruh string payload hingga dan termasuk tag serta panjang bidang 63 itu sendiri (artinya string yang berakhir dengan "6304" disertakan dalam perhitungan sebelum hasil empat karakter ditambahkan). Payload dengan CRC-16 salah atau tidak ada akan ditolak aplikasi perbankan berkemampuan PIX.
Pembuat ini menghitung dan menambahkan checksum CRC-16 yang benar secara otomatis. Jika Anda menyusun payload secara manual, checksum harus dihitung ulang setiap kali bidang berubah.
Bidang data tambahan (subtemplate tag 62)
Tag 62 berisi subtemplate bertingkat untuk identifikasi transaksi:
| Subtag | Isi | Catatan |
|---|---|---|
| 05 | TXID | 26 hingga 35 karakter alfanumerik; gunakan *** untuk nilai terbuka |
TXID menghubungkan pembayaran ke transaksi tertentu dalam sistem merchant. Untuk QR statis bernilai terbuka, spesifikasi BCB mengizinkan tiga tanda bintang (***) sebagai placeholder TXID.
Kode QR PIX statis vs dinamis
| Fitur | PIX QR statis (BR Code) | PIX QR dinamis (COB/COBV) |
|---|---|---|
| Jumlah | Jumlah tetap atau terbuka | Tetap per transaksi |
| Dapat digunakan ulang | Ya | Satu penggunaan per kode |
| Dibuat oleh | Pembuat BR Code apa pun | PSP API, sesuai spesifikasi BCB COB/COBV |
| Isi payload | Data pembayaran lengkap di dalam QR | URL diselesaikan secara real time oleh aplikasi perbankan pembayar |
| Rekonsiliasi otomatis | Melalui TXID jika ditentukan | Otomatis melalui referensi transaksi PSP |
| Cocok untuk | Merchant kecil, individu | E-commerce, penagihan, pembayaran berulang |
Kode QR PIX dinamis (format COB untuk nilai terbuka, COBV untuk nilai tetap) memerlukan integrasi PSP API. BCB menerbitkan spesifikasi teknis COB/COBV secara terpisah dari BR Code Manual statis. Pembuat ini hanya menghasilkan kode statis.
Kapan menggunakan kode QR PIX
Merchant kecil dan kios pasar. QR statis bernilai terbuka yang dicetak di kios atau konter memungkinkan pelanggan memasukkan jumlah yang harus dibayar dan membayar seketika dari aplikasi bank mana pun. Tidak memerlukan mesin kartu.
Profesional jasa. Kode QR yang dicetak pada faktur atau kartu nama memungkinkan klien membayar melalui PIX tanpa mengetahui detail rekening bank penyedia — hanya kunci PIX yang diperlukan.
Freelancer dan penjual individu. Kode QR kunci EVP di listing marketplace atau profil media sosial memungkinkan pembeli membayar tanpa penjual memublikasikan ID pajak pribadi atau nomor telepon.
Organisasi nirlaba dan komunitas. Kode QR bernilai terbuka yang dicetak pada materi donasi memungkinkan pendukung mengirim jumlah berapa pun melalui PIX.
Acara dan lokasi sementara. Kode QR pada lencana atau kartu cetak memungkinkan penerimaan pembayaran instan tanpa uang tunai atau terminal POS.
Persyaratan desain dan pencetakan
Pertahankan quiet zone empat modul di semua sisi, sebagaimana ditentukan dalam ISO/IEC 18004:2015 bagian 6.3.3.
Cetak minimum 2 cm x 2 cm untuk pemindaian jarak dekat. Untuk tampilan konter merchant yang dibaca sambil berdiri, 5 cm atau lebih merupakan panduan industri yang tepat.
Gunakan modul gelap pada latar terang. Kode dengan warna terbalik dan desain kontras rendah sering gagal pada kamera ponsel dalam pencahayaan luar yang berubah.
Payload PIX — termasuk GUI merchant, kunci PIX, nama, kota, TXID, dan CRC-16 — adalah string dengan kepadatan sedang. Kode statis dengan semua bidang terisi akan menghasilkan simbol QR yang lebih kompleks daripada QR URL. Cetak lebih besar, bukan lebih kecil.
Gunakan tingkat koreksi kesalahan M sebagai dasar. Tingkat M memulihkan sekitar 15 persen codeword yang rusak. Jika Anda menyematkan logo, gunakan tingkat H (sekitar 30 persen pemulihan) dan batasi logo tidak lebih dari 30 persen area kode.
Pemecahan masalah: mengapa kode QR PIX Anda tidak berfungsi
Kunci PIX tidak terdaftar di BCB DICT. Membuat kode QR dengan kunci PIX yang tidak terdaftar menghasilkan kode yang valid secara sintaksis tetapi tidak dapat dirutekan aplikasi perbankan. Pastikan kunci aktif di pengaturan kunci PIX aplikasi perbankan sebelum mengodekannya.
Checksum CRC-16 salah. Perubahan pada bidang apa pun setelah checksum dihitung akan membatalkannya. Jika Anda mengedit string payload mentah secara manual, hitung ulang checksum. Pembuat ini menghitungnya otomatis.
Nama merchant berisi karakter non-ASCII atau aksen. BCB menentukan bahwa bidang Merchant Name (tag 59) harus berupa ASCII huruf besar tanpa aksen. Ganti "João" dengan "JOAO" dan "São Paulo" dengan "SAO PAULO".
Nama atau kota merchant melebihi batas karakter. Tag 59 (Merchant Name) maksimum 25 karakter. Tag 60 (Merchant City) maksimum 15 karakter. Potong agar sesuai.
TXID kosong atau menggunakan format yang tidak diizinkan. Untuk QR statis bernilai terbuka, gunakan tiga tanda bintang (***) sebagai TXID. Untuk transaksi tetap, gunakan 26 hingga 35 karakter alfanumerik. TXID tidak valid menyebabkan beberapa aplikasi bank menolak payload.
Aplikasi perbankan tidak berkemampuan PIX. Semua lembaga keuangan Brasil berlisensi di atas ambang BCB wajib mendukung PIX. Aplikasi dari lembaga di bawah ambang atau bank non-Brasil tidak akan memproses pembayaran PIX.
PIX dibanding standar QR pembayaran lainnya
| Fitur | PIX QR — BR Code (Brasil) | EPC QR — GiroCode (Eropa/SEPA) | QR UPI (India) |
|---|---|---|---|
| Badan pengatur | Banco Central do Brasil | European Payments Council | NPCI |
| Standar | BCB BR Code Manual v2.0, EMVCo MPM | EPC069-12 v3.1 | NPCI Ikhtisar Produk UPI |
| Mata uang | BRL (kode ISO 4217 986) | Hanya EUR | Hanya INR |
| Format payload | EMVCo TLV | Teks biasa 12 baris | String kueri URI upi:// |
| Checksum wajib | Ya — CRC-16/CCITT-FALSE | Tidak | Tidak |
| Mandat koreksi kesalahan | Tidak ditentukan dalam penelitian | Tingkat M wajib (EPC069-12) | Tidak ditentukan dalam penelitian |
Yang diberikan Pembuat Kode QR PIX ini
Alat berbasis browser ini membuat payload PIX BR Code Brasil statis dengan detail merchant, jumlah opsional, referensi, dan checksum. Alat ini dirancang untuk permintaan pembayaran instan Brasil, faktur, penjualan jarak jauh, dan penagihan lokasi tetap. Pratinjau langsung diperbarui saat Anda mengedit sehingga lebih mudah menemukan bidang yang hilang atau simbol yang terlalu padat sebelum mengunduh.
Anda dapat menyesuaikan pola matriks, gaya mata pencari, warna latar depan dan belakang, gradien, bingkai, ukuran, dan logo opsional. Ekspor tersedia sebagai SVG, PNG, WEBP, dan JPG pada 512, 1024, 2048, atau 4096 piksel. SVG adalah pilihan praktis untuk pencetakan profesional. PNG resolusi tinggi cocok untuk dokumen kantor dan karya digital.
Payload statis dibuat di browser Anda. Informasi yang dimasukkan tidak perlu diunggah untuk membuat gambar QR. Periksa kunci PIX, nama merchant, kota, jumlah, dan penerima yang ditampilkan aplikasi bank sebelum mengotorisasi transfer.
Menggunakan kode QR ini di Bahrain dan luar negeri
PIX adalah sistem pembayaran instan Brasil dan bukan jalur domestik Bahrain. Gunakan hanya untuk rekening Brasil yang sah dan pembayar dengan akses PIX yang kompatibel.
Gunakan ejaan Inggris Britania pada konten yang menghadap pelanggan jika sesuai dengan gaya organisasi Anda, dan sediakan teks Arab ketika audiens mengharapkannya. Buat tindakan setelah pemindaian jelas. Baris singkat di samping simbol seperti “Pindai untuk menyimpan kontak” atau “Pindai untuk membuka lokasi” memberi keyakinan sebelum orang mengarahkan kamera.
Uji desain akhir pada perangkat iPhone dan Android terkini. Uji lagi setelah dicetak pada kertas, stiker, kartu, papan, atau bahan kemasan sebenarnya. Cahaya luar ruang Bahrain yang terang dapat menampakkan silau dan masalah kontras rendah yang kurang terlihat di layar komputer. Untuk penggunaan internasional, pastikan kode negara, mata uang, zona waktu, ketersediaan aplikasi regional, dan kompatibilitas jaringan pembayaran.
Sebelum Anda menerbitkan
- Jenis muatan QR yang tepat
- Data lengkap dan terverifikasi
- Quiet zone empat modul
- Kontras latar depan yang kuat
- Penskalaan persegi proporsional
- Logo dijaga dalam batas aman
- SVG atau PNG resolusi tinggi
- Uji pemindaian perangkat pada ukuran akhir
Pertanyaan umum
Buka pertanyaan untuk membaca jawaban teknis yang ringkas.
01Apa itu kode QR PIX?+
Kode QR PIX — secara resmi disebut BR Code — mengodekan permintaan pembayaran PIX menggunakan format TLV EMVCo Merchant Presented Mode seperti yang ditentukan Banco Central do Brasil dalam BR Code Manual v2.0. Payload diakhiri checksum CRC-16/CCITT-FALSE wajib. Aplikasi perbankan berkemampuan PIX mana pun di Brasil dapat memindai dan memproses pembayaran.
02Jenis kunci PIX apa yang dapat saya gunakan dalam kode QR?+
PIX mendukung empat jenis kunci: CPF (ID pajak individu 11 digit), CNPJ (ID pajak badan 14 digit), nomor ponsel Brasil dalam format E.164 (+5511999999999), alamat e-mail, dan EVP — kunci UUID acak tanpa data pribadi yang diberikan penyedia layanan pembayaran. Kunci EVP adalah opsi yang menjaga privasi.
03Apa itu checksum CRC-16 dalam kode QR PIX?+
Setiap payload PIX BR Code harus diakhiri checksum CRC-16 heksadesimal huruf besar empat karakter pada bidang tag 63. Algoritmanya adalah CRC-16/CCITT-FALSE, dengan polinomial 0x1021 dan nilai awal 0xFFFF. Checksum dihitung atas seluruh string payload termasuk awalan "6304" dari bidang checksum itu sendiri. Aplikasi bank menolak payload dengan checksum yang hilang atau salah.
04Apa perbedaan kode QR PIX statis dan dinamis?+
PIX QR statis mengodekan seluruh data pembayaran secara langsung dan dapat digunakan kembali untuk beberapa transaksi. PIX QR dinamis (format COB/COBV) berisi URL yang diselesaikan aplikasi bank pembayar secara real time melalui PSP. Kode dinamis digunakan satu kali per transaksi dan memerlukan PSP API. Pembuat ini hanya membuat kode statis.
05Bisakah saya membuat kode QR PIX tanpa jumlah tetap?+
Ya. Hilangkan bidang jumlah (tag 54). Kode yang dibuat memungkinkan pembayar memasukkan jumlah apa pun di aplikasi bank. Untuk QR statis bernilai terbuka, gunakan tiga tanda bintang (***) sebagai TXID di tag 62 subtag 05 sesuai spesifikasi BCB BR Code.
06Aplikasi apa yang dapat memindai kode QR PIX?+
Aplikasi perbankan dari lembaga keuangan Brasil berkemampuan PIX mana pun dapat memindai BR Code. Banco Central do Brasil mewajibkan partisipasi PIX bagi semua lembaga berlisensi di atas ambang tertentu. Semua bank ritel dan bank digital utama Brasil mendukung pemindaian PIX.
07Apa itu kunci EVP dalam kode QR PIX?+
Kunci EVP (Endereço Virtual de Pagamento) adalah UUID yang dibuat acak dan diberikan oleh penyedia layanan pembayaran. Kunci ini ditautkan ke rekening bank melalui BCB DICT tanpa mengekspos CPF, telepon, atau e-mail pemegang rekening. Ini adalah jenis kunci PIX yang disarankan saat kode QR akan ditampilkan publik.
08Apa arti string BR.GOV.BCB.PIX dalam payload PIX?+
BR.GOV.BCB.PIX adalah Globally Unique Identifier (GUI) untuk aplikasi pembayaran PIX dalam framework EMVCo. Ia muncul sebagai subtag 00 di dalam template Merchant Account Information (tag 26). String tetap ini mengidentifikasi domain pembayaran sebagai PIX. Semua PIX BR Codes yang valid berisi string literal ini.
09Berapa panjang maksimum nama merchant dalam kode QR PIX?+
Spesifikasi BCB BR Code membatasi bidang Merchant Name (tag 59) hingga 25 karakter ASCII huruf besar tanpa aksen. Bidang Merchant City (tag 60) dibatasi 15 karakter ASCII. Nama yang melebihi batas harus dipotong. Karakter khusus dan diakritik tidak diizinkan.
10Mengapa saya perlu memverifikasi kode QR PIX sebelum mencetak?+
Membuat payload BR Code yang valid tidak memastikan kunci PIX aktif atau dipetakan dengan benar di BCB DICT. Kunci yang tidak terdaftar atau salah ketik menghasilkan kode yang dipindai dengan benar tetapi gagal saat pembayaran. Pindai kode dengan aplikasi bank berkemampuan PIX dan konfirmasikan nama penerima yang ditampilkan sebelum mencetak dalam jumlah besar.