PIX QR Kod Oluşturucu
Yapılandırılmış BR Code alanları ve hesaplanmış CRC16 sağlama toplamıyla statik bir Brezilya PIX ödeme QR kodu oluşturun.
Bu oluşturucu GS1 Digital Link URI’sini doğrudan QR kodunun içinde tutar. GS1 Digital Link kodları için Premium QR dinamik yönlendirmeleri kullanılmaz.
Gelişmiş Özelleştirme
Renkler ve Gradyanlar
Logo ve Sosyal Simge
QR Kod Boyutu
PIX QR Kod Oluşturucu
Kısa cevap: Resmî olarak BR Code olarak adlandırılan PIX QR kodu, Banco Central do Brasil (BCB) tarafından belirtilen EMVCo MPM TLV biçimini izler. Yük, zorunlu CRC-16/CCITT-FALSE sağlama toplamıyla biter. PIX anahtarları CPF/CNPJ vergi kimliği, telefon, e-posta veya rastgele EVP UUID olabilir.
PIX QR kodu nasıl oluşturulur
- PIX anahtarınızı girin — alıcı banka hesabına bağlı tanımlayıcı. Bu, CPF, CNPJ, +5511999999999 biçiminde Brezilya cep telefonu numarası, e-posta adresi veya ödeme hizmet sağlayıcınızın atadığı rastgele EVP UUID olabilir.
- Satıcı adını ASCII büyük harflerle, en fazla 25 karakter olarak, aksan ve özel karakter kullanmadan girin.
- Satıcı şehrini ASCII büyük harflerle, en fazla 15 karakter olarak girin.
- Ödemenin bilinen bir değeri varsa sabit tutar girin; ödeyenin dolduracağı açık tutarlı statik QR için boş bırakın.
- Ödemeyi mutabakat için eşleştirmeniz gerekiyorsa işlem kimliği (TXID) girin. Açık tutarlı statik QR için TXID yer tutucusu olarak üç yıldız (***) kullanın.
- İndirmeden önce oluşturulan kodu PIX destekli bir bankacılık uygulamasıyla tarayarak doğrulayın.
- Gerekirse deseni, göz stilini, renkleri ve logoyu özelleştirin; ardından PNG, SVG, WEBP veya JPG olarak 4096 px'e kadar dışa aktarın.
QR kod tarayıcınızda oluşturulur. Girdiğiniz hiçbir şey sunucuya gönderilmez.
PIX QR kodu nedir
Resmî belirtimde BR Code olarak geçen PIX QR kodu, QR kod içinde kodlanan bir ödeme başlatma yüküdür. Şu standardı izler: EMVCo QRCPS-MPM (Merchant Presented Mode), Brezilya'da Banco Central do Brasil (BCB) tarafından Mayıs 2020 tarihli BR Code Manual sürüm 2.0 ile uygulanmıştır.
PIX, Banco Central do Brasil tarafından işletilen ve düzenlenen Brezilya'nın anlık ödeme sistemidir. Lisanslı tüm Brezilya finans kuruluşları PIX'i desteklemek zorundadır. Ödemeler hafta sonları ve tatiller dahil 7/24 gerçek zamanlı olarak kesinleşir. Sistem, belirli büyüklük eşiğinin üzerindeki kuruluşlar için isteğe bağlı değil zorunludur.
PIX QR kodu banka hesap numarası değildir. Hesaba bağlı bir takma ad olan PIX anahtarını içerir. BCB'nin PIX altyapısı, ödeme anında anahtarı gerçek hesap bilgilerine çözümler. Ödeyen kişi hesap numarasını görmez.
Statik PIX QR kodu yeniden kullanılabilir. Dinamik PIX QR kodu (COB veya COBV biçimi), belirli bir işlem için ödeme hizmet sağlayıcısı (PSP) tarafından üretilir ve ödeyenin uygulamasının gerçek zamanlı çözdüğü bir URL içerir. Bu oluşturucu statik QR kodları üretir. Dinamik kodlar PSP API gerektirir.
PIX BR Code teknik yapısı
EMVCo TLV biçimi
PIX yükü şu kodlamayı kullanır: EMVCo Tag-Length-Value (TLV). Her alan iki basamaklı etiket kimliği, iki basamaklı alan uzunluğu ve ardından alan içeriğinden oluşur. Alanlar ayırıcı olmadan birleştirilir.
| Etiket | Alan | Örnek içerik | Notlar |
|---|---|---|---|
| 00 | Yük Biçimi Göstergesi | 01 | Her zaman "01" — zorunlu |
| 01 | Başlatma Noktası Yöntemi | 11 | 11 = statik/yeniden kullanılabilir; 12 = tek kullanımlık dinamik |
| 26 | Satıcı Hesap Bilgisi (PIX) | (alt şablon — aşağıya bakın) | PIX GUI ve PIX anahtarını içerir |
| 52 | Satıcı Kategori Kodu | 0000 | Genel kullanım için 0000; ISO 18245 kodları geçerlidir |
| 53 | İşlem Para Birimi | 986 | ISO 4217 uyarınca 986 = BRL |
| 54 | İşlem Tutarı | 123.45 | Ondalık biçim; açık tutar için atlayın |
| 58 | Ülke Kodu | BR | PIX için her zaman "BR" |
| 59 | Satıcı Adı | JOAO SILVA | En fazla 25 ASCII karakter, büyük harf, aksansız |
| 60 | Satıcı Şehri | SAO PAULO | En fazla 15 ASCII karakter, büyük harf, aksansız |
| 62 | Ek Veri Alanı Şablonu | (alt şablon — aşağıya bakın) | TXID içerir |
| 63 | CRC-16 Sağlama Toplamı | 4 karakterli büyük harf onaltılık | CRC-16/CCITT-FALSE, zorunlu, her zaman son |
Satıcı hesap bilgisi (etiket 26 alt şablonu)
Etiket 26, PIX için iç içe bir TLV yapısı içerir:
| Alt etiket | İçerik |
|---|---|
| 00 | BR.GOV.BCB.PIX — PIX GUI, her zaman sabit |
| 01 | PIX anahtar değeri |
PIX GUI (Globally Unique Identifier) BR.GOV.BCB.PIX, BCB tarafından belirtilen sabit bir dizgedir. Ödeme alanını PIX olarak şu yapı içinde tanımlar: EMVCo framework.
PIX anahtar türleri
PIX anahtarı, BCB DICT (işlem hesapları ve ödemeler dizini) aracılığıyla banka hesabına çözümlenen kayıtlı bir takma addır. Dört anahtar türü vardır:
| Anahtar türü | Biçim örneği | Notlar |
|---|---|---|
| CPF | 12345678901 (11 basamak) | Brezilya bireysel vergi kimliği |
| CNPJ | 12345678000195 (14 basamak) | Brezilya tüzel kişi vergi kimliği |
| Telefon | +5511999999999 | E.164 biçiminde Brezilya cep telefonu numarası |
| E-posta | [email protected] | Kayıtlı e-posta adresi |
| EVP (rastgele) | UUID v4, ör. 123e4567-e89b-12d3-a456-… | PSP tarafından rastgele oluşturulan anahtar — kişisel veri içermez |
EVP (Endereço Virtual de Pagamento) anahtarı, ödeme hizmet sağlayıcısı tarafından atanan rastgele bir UUID'dir. Kişisel olarak tanımlanabilir bilgi içermez ve CPF, telefon veya e-posta bilgisini herkese açık bir QR kodunda yayımlamak istemeyen kişiler için gizliliği koruyan bir seçenektir.
CRC-16 sağlama toplamı
Her PIX BR Code yükünün son alanı etiket 63'tür: zorunlu, dört karakterli büyük harf onaltılık CRC-16 sağlama toplamı. Algoritma, 0x1021 polinomu ve 0xFFFF başlangıç değeriyle CRC-16/CCITT-FALSE'dur.
Sağlama toplamı, alan 63'ün etiketi ve uzunluğu dahil olmak üzere tüm yük dizgesi üzerinden hesaplanır (yani "6304" ile biten dizge, dört karakterli sonuç eklenmeden önce hesaplamaya dahildir). Yanlış veya eksik CRC-16 içeren yük PIX destekli bankacılık uygulamaları tarafından reddedilir.
Bu oluşturucu doğru CRC-16 sağlama toplamını otomatik hesaplar ve ekler. Yükü elle oluşturursanız herhangi bir alan değiştiğinde sağlama toplamı yeniden hesaplanmalıdır.
Ek veri alanı (etiket 62 alt şablonu)
Etiket 62, işlem tanımlaması için iç içe bir alt şablon içerir:
| Alt etiket | İçerik | Notlar |
|---|---|---|
| 05 | TXID | 26 ila 35 alfanümerik karakter; açık tutar için *** kullanın |
TXID, ödemeyi satıcının sistemindeki belirli bir işlemle bağlar. Açık tutarlı statik QR için BCB belirtimi TXID yer tutucusu olarak üç yıldız (***) kullanımına izin verir.
Statik ve dinamik PIX QR kodları
| Özellik | Statik PIX QR (BR Code) | Dinamik PIX QR (COB/COBV) |
|---|---|---|
| Tutar | Sabit veya açık tutar | İşlem başına sabit |
| Yeniden kullanılabilir | Evet | Kod başına tek kullanım |
| Oluşturan | Herhangi bir BR Code oluşturucu | BCB COB/COBV belirtimine göre PSP API |
| Yük içeriği | Tam ödeme verileri QR içinde | URL, ödeyenin bankacılık uygulaması tarafından gerçek zamanlı çözümlenir |
| Otomatik mutabakat | Belirtilmişse TXID üzerinden | PSP işlem referansı üzerinden otomatik |
| Uygun olduğu alanlar | Küçük satıcılar, bireyler | E-ticaret, faturalama, yinelenen ödemeler |
Dinamik PIX QR kodları (açık tutar için COB, sabit tutar için COBV) bir PSP API entegrasyonu gerektirir. BCB, COB/COBV teknik belirtimini statik BR Code Manual'dan ayrı yayımlar. Bu oluşturucu yalnızca statik kodlar üretir.
PIX QR kodu ne zaman kullanılır
Küçük satıcılar ve pazar tezgahları. Tezgâh veya kasa üzerinde basılı açık tutarlı statik QR, müşterilerin borçlu oldukları tutarı girip herhangi bir bankacılık uygulamasından anında ödeme yapmasını sağlar. Kart okuyucu gerekmez.
Hizmet profesyonelleri. Fatura veya kartvizite basılan QR kodu, müşterilerin sağlayıcının banka hesap bilgilerini bilmeden PIX ile ödeme yapmasını sağlar — yalnızca PIX anahtarı gerekir.
Serbest çalışanlar ve bireysel satıcılar. Pazar yeri ilanı veya sosyal medya profilindeki EVP anahtarlı QR kodu, satıcının kişisel vergi kimliği veya telefon numarasını yayımlamadan alıcıların ödeme yapmasını sağlar.
Kar amacı gütmeyen ve topluluk kuruluşları. Bağış materyaline basılan açık tutarlı QR kodu destekçilerin PIX ile istedikleri tutarı göndermesini sağlar.
Etkinlikler ve geçici konumlar. Rozet veya basılı kart üzerindeki QR kodu nakit ya da POS terminali olmadan anında ödeme almayı sağlar.
Tasarım ve baskı gereksinimleri
Tüm kenarlarda dört modüllük sessiz bölge bırakın; belirtildiği gibi ISO/IEC 18004:2015 bölüm 6.3.3.
Yakın mesafe taraması için en az 2 cm x 2 cm basın. Ayakta okunacak bir satıcı tezgâh ekranı için 5 cm veya daha büyük uygun sektör kılavuzudur.
Açık zemin üzerinde koyu modüller kullanın. Ters renkli kodlar ve düşük kontrastlı tasarımlar değişken dış ortam ışığında telefon kameralarında sıkça başarısız olur.
PIX yükü — satıcı GUI, PIX anahtarı, ad, şehir, TXID ve CRC-16 dahil — orta yoğunlukta bir dizgedir. Tüm alanları doldurulmuş statik kod, URL QR'den daha karmaşık bir QR sembolü üretir. Daha küçük değil, daha büyük basın.
Temel olarak hata düzeltme seviyesi M kullanın. Seviye M hasarlı kod sözcüklerinin yaklaşık yüzde 15'ini kurtarır. Logo eklerseniz seviye H kullanın (yaklaşık yüzde 30 kurtarma) ve logoyu kod alanının en fazla yüzde 30'unda tutun.
Sorun giderme: PIX QR kodunuz neden çalışmıyor
PIX anahtarı BCB DICT'te kayıtlı değil. Kayıtsız PIX anahtarıyla QR kod üretmek, bankacılık uygulamasının yönlendiremediği sözdizimsel olarak geçerli bir kod oluşturur. Kodlamadan önce anahtarın bankacılık uygulamanızdaki PIX anahtar ayarlarında etkin olduğunu doğrulayın.
CRC-16 sağlama toplamı yanlış. Sağlama toplamı hesaplandıktan sonra herhangi bir alanda yapılan değişiklik onu geçersiz kılar. Ham yük dizgesini elle düzenlediyseniz sağlama toplamını yeniden hesaplayın. Bu oluşturucu otomatik hesaplar.
Satıcı adı ASCII dışı karakter veya aksan içeriyor. BCB, Merchant Name alanının (etiket 59) aksansız büyük harf ASCII olması gerektiğini belirtir. "João" yerine "JOAO", "São Paulo" yerine "SAO PAULO" kullanın.
Satıcı adı veya şehir karakter sınırını aşıyor. Etiket 59 (Merchant Name) en fazla 25 karakterdir. Etiket 60 (Merchant City) en fazla 15 karakterdir. Sığması için kısaltın.
TXID boş veya izin verilmeyen biçimde. Açık tutarlı statik QR için TXID olarak üç yıldız (***) kullanın. Sabit işlem için 26 ila 35 alfanümerik karakter kullanın. Geçersiz TXID bazı bankacılık uygulamalarının yükü reddetmesine neden olur.
Bankacılık uygulaması PIX destekli değil. BCB eşiğinin üzerindeki tüm lisanslı Brezilya finans kuruluşları PIX'i desteklemek zorundadır. Eşiğin altındaki kurumların veya Brezilya dışı bankaların uygulamaları PIX ödemesini işlemez.
PIX ve diğer ödeme QR standartları
| Özellik | PIX QR — BR Code (Brezilya) | EPC QR — GiroCode (Avrupa/SEPA) | UPI QR (Hindistan) |
|---|---|---|---|
| Yönetim organı | Banco Central do Brasil | European Payments Council | NPCI |
| Standart | BCB BR Code Manual v2.0, EMVCo MPM | EPC069-12 v3.1 | NPCI UPI Ürün Genel Bakışı |
| Para birimi | BRL (ISO 4217 kodu 986) | Yalnızca EUR | Yalnızca INR |
| Yük biçimi | EMVCo TLV | 12 satırlık düz metin | upi:// URI sorgu dizgesi |
| Zorunlu sağlama toplamı | Evet — CRC-16/CCITT-FALSE | Hayır | Hayır |
| Hata düzeltme zorunluluğu | Araştırmada belirtilmemiş | Seviye M zorunlu (EPC069-12) | Araştırmada belirtilmemiş |
Bu PIX QR Kod Oluşturucu size ne sağlar
Bu tarayıcı tabanlı araç, satıcı bilgileri, isteğe bağlı tutar, referans ve sağlama toplamıyla statik bir Brezilya PIX BR Code yükü oluşturur. Brezilya anlık ödeme talepleri, faturalar, uzaktan satışlar ve sabit konum tahsilatları için tasarlanmıştır. Canlı önizleme düzenlerken güncellenir; indirmeden önce eksik alanı veya beklenmedik yoğun sembolü görmeyi kolaylaştırır.
Matris desenlerini, bulucu gözü stillerini, ön plan ve arka plan renklerini, geçişleri, çerçeveleri, boyutu ve isteğe bağlı logoyu ayarlayabilirsiniz. Dışa aktarma SVG, PNG, WEBP ve JPG olarak 512, 1024, 2048 veya 4096 piksel boyutlarında sunulur. Profesyonel baskı için SVG pratik seçimdir. Yüksek çözünürlüklü PNG ofis belgeleri ve dijital tasarımlar için uygundur.
Statik yük tarayıcınızda oluşturulur. QR görüntüsünü oluşturmak için girilen bilgilerin yüklenmesi gerekmez. Transferi onaylamadan önce PIX anahtarını, satıcı adını, şehri, tutarı ve bankacılık uygulamasında gösterilen alıcıyı kontrol edin.
Bu QR kodunu Bahreyn’de ve yurt dışında kullanma
PIX, Brezilya'nın anlık ödeme sistemidir ve Bahreyn'in yerel ödeme ağı değildir. Yalnızca gerçek bir Brezilya hesabı ve uyumlu PIX erişimi olan ödeyen için kullanın.
Kuruluşunuzun yazım stiline uyuyorsa müşteriye dönük metinlerde Britanya İngilizcesi yazımını kullanın ve hedef kitlenin beklediği yerlerde Arapça metin sağlayın. Taramadan sonraki eylemi açık tutun. Sembolün yanındaki “Kişiyi kaydetmek için tarayın” veya “Konumu açmak için tarayın” gibi kısa bir ifade, kullanıcı kamerayı doğrultmadan önce güven verir.
Son tasarımı güncel iPhone ve Android cihazlarda test edin. Gerçek kâğıt, etiket, kart, tabela veya ambalaj malzemesine bastıktan sonra yeniden test edin. Bahreyn’in parlak dış mekân ışığı, bilgisayar ekranında daha az belirgin olan parlamayı ve düşük kontrast sorunlarını ortaya çıkarabilir. Uluslararası kullanımda ülke kodlarını, para birimlerini, saat dilimlerini, bölgesel uygulama kullanılabilirliğini ve ödeme ağı uyumluluğunu doğrulayın.
Yayımlamadan önce
- Doğru QR yük türü
- Eksiksiz ve doğrulanmış veriler
- Dört modüllük sessiz bölge
- Güçlü ön plan kontrastı
- Orantılı kare ölçekleme
- Logo güvenli sınırlar içinde
- SVG veya yüksek çözünürlüklü PNG
- Son boyutta cihaz tarama testi
Sık sorulan sorular
Kısa bir teknik yanıt okumak için bir soruyu açın.
01PIX QR kodu nedir?+
Resmî olarak BR Code olarak adlandırılan PIX QR kodu, Banco Central do Brasil'ın BR Code Manual v2.0 belgesinde belirtilen EMVCo Merchant Presented Mode TLV biçimini kullanarak bir PIX ödeme talebini kodlar. Zorunlu CRC-16/CCITT-FALSE sağlama toplamıyla biter. Brezilya'daki PIX destekli herhangi bir bankacılık uygulaması ödemeyi tarayıp işleyebilir.
02QR kodunda hangi PIX anahtar türlerini kullanabilirim?+
PIX dört anahtar türünü destekler: CPF (11 basamaklı bireysel vergi kimliği), CNPJ (14 basamaklı kuruluş vergi kimliği), E.164 biçiminde Brezilya cep telefonu numarası (+5511999999999), e-posta adresi ve EVP — ödeme hizmet sağlayıcısının atadığı, kişisel veri içermeyen rastgele UUID anahtarı. EVP gizliliği koruyan seçenektir.
03PIX QR kodundaki CRC-16 sağlama toplamı nedir?+
Her PIX BR Code yükü, etiket 63 alanında dört karakterli büyük harf onaltılık CRC-16 sağlama toplamıyla bitmelidir. Algoritma, 0x1021 polinomu ve 0xFFFF başlangıç değeriyle CRC-16/CCITT-FALSE'dur. Sağlama toplamı, sağlama toplamı alanının "6304" öneki dahil tüm yük dizgesi üzerinden hesaplanır. Bankacılık uygulamaları eksik veya yanlış sağlama toplamlı yükleri reddeder.
04Statik ve dinamik PIX QR kodu arasındaki fark nedir?+
Statik PIX QR tüm ödeme verilerini doğrudan kodlar ve birden fazla işlem için yeniden kullanılabilir. Dinamik PIX QR (COB/COBV biçimi), ödeyenin bankacılık uygulamasının PSP üzerinden gerçek zamanlı çözdüğü bir URL içerir. Dinamik kodlar işlem başına tek kullanımlıktır ve PSP API gerektirir. Bu oluşturucu yalnızca statik kod oluşturur.
05Sabit tutar olmadan PIX QR kodu oluşturabilir miyim?+
Evet. Tutar alanını (etiket 54) atlayın. Oluşturulan kod ödeyenin bankacılık uygulamasında herhangi bir tutar girmesine izin verir. Açık tutarlı statik QR için BCB BR Code belirtimine göre etiket 62 alt etiket 05'te TXID olarak üç yıldız (***) kullanın.
06Hangi uygulamalar PIX QR kodunu tarayabilir?+
PIX destekli Brezilya finans kuruluşunun herhangi bir bankacılık uygulaması BR Code tarayabilir. Banco Central do Brasil, tanımlı eşik üzerindeki tüm lisanslı kuruluşlar için PIX katılımını zorunlu kılmıştır. Brezilya'nın tüm büyük perakende ve dijital bankaları PIX taramasını destekler.
07PIX QR kodundaki EVP anahtarı nedir?+
EVP (Endereço Virtual de Pagamento) anahtarı, ödeme hizmet sağlayıcısının atadığı rastgele oluşturulmuş bir UUID'dir. BCB DICT üzerinden banka hesabına bağlanır ve hesap sahibinin CPF, telefon veya e-postasını açığa çıkarmaz. QR kodu herkese açık gösterilecekse önerilen PIX anahtar türüdür.
08PIX yükündeki BR.GOV.BCB.PIX dizgesi ne anlama gelir?+
BR.GOV.BCB.PIX, EMVCo framework içinde PIX ödeme uygulamasının Globally Unique Identifier (GUI) değeridir. Merchant Account Information şablonunda (etiket 26) alt etiket 00 olarak görünür. Bu sabit dizge ödeme alanını PIX olarak tanımlar. Tüm geçerli PIX BR Codes bu gerçek dizgeyi içerir.
09PIX QR kodunda satıcı adının azami uzunluğu nedir?+
BCB BR Code belirtimi Merchant Name alanını (etiket 59) aksansız büyük harf 25 ASCII karakterle sınırlar. Merchant City alanı (etiket 60) 15 ASCII karakterle sınırlıdır. Sınırı aşan adlar kısaltılmalıdır. Özel karakterler ve aksanlar izinli değildir.
10PIX QR kodunu baskıdan önce neden doğrulamalıyım?+
Geçerli BR Code yükü üretmek, PIX anahtarının BCB DICT'te etkin veya doğru eşlenmiş olduğunu doğrulamaz. Kayıtsız veya yanlış yazılmış anahtar doğru taranan ancak ödeme anında başarısız olan kod üretir. Toplu baskıdan önce kodu PIX destekli bir bankacılık uygulamasıyla tarayın ve uygulamada gösterilen alıcı adını doğrulayın.