منشئ رمز PIX QR
أنشئ static Brazilian PIX payment QR code باستخدام حقول BR Code منظَّمة وCRC16 checksum محسوب.
يحتفظ هذا المنشئ بعنوان URI الخاص بـ GS1 Digital Link مباشرة داخل رمز QR. لا تُستخدم عمليات إعادة التوجيه الديناميكية من Premium QR مع رموز GS1 Digital Link.
تخصيص متقدم
الألوان والتدرجات
الشعار وأيقونة التواصل
حجم رمز QR
منشئ رمز PIX QR
باختصار: يتبع PIX QR code — واسمه الرسمي BR Code — صيغة EMVCo MPM TLV المحددة من Banco Central do Brasil (BCB). ينتهي payload بـ mandatory CRC-16/CCITT-FALSE checksum. يمكن أن تكون PIX keys عبارة عن CPF/CNPJ tax ID أو phone أو email أو random EVP UUID.
كيفية إنشاء PIX QR code
- أدخل PIX key الخاصة بك — وهي identifier مرتبط بحساب البنك المستلم. يمكن أن تكون CPF أو CNPJ أو رقم هاتف محمول برازيلي بصيغة +5511999999999 أو email address أو random EVP UUID يعيّنه payment service provider.
- أدخل merchant name بأحرف ASCII كبيرة، بحد أقصى 25 characters، من دون accents أو special characters.
- أدخل merchant city بأحرف ASCII كبيرة، بحد أقصى 15 characters.
- أدخل fixed amount إذا كانت للدفعة قيمة معروفة، أو اتركه فارغاً لـ open-value static QR يملؤه payer.
- أدخل transaction ID (TXID) إذا كنت تحتاج إلى reconcile للدفعة. بالنسبة إلى open-value static QR استخدم ثلاثة asterisks (***) كـ TXID placeholder.
- تحقق من الرمز الناتج بمسحه في PIX-enabled banking app قبل التنزيل.
- خصّص النمط وشكل العيون والألوان والشعار عند الحاجة، ثم صدّر PNG أو SVG أو WEBP أو JPG بدقة تصل إلى 4096 px.
يتم إنشاء رمز QR في متصفحك. لا يتم إرسال أي شيء تدخله إلى خادم.
ما هو PIX QR code
PIX QR code — ويشار إليه في المواصفة الرسمية باسم BR Code — هو payment initiation payload مشفر داخل QR code. وهو يتبع EMVCo QRCPS-MPM (Merchant Presented Mode) standard الذي طبقه في Brazil بنك Banco Central do Brasil (BCB) ضمن BR Code Manual, version 2.0 بتاريخ May 2020.
PIX هو نظام الدفع الفوري في Brazil، يديره وينظمه Banco Central do Brasil. يجب على جميع licensed Brazilian financial institutions دعم PIX. تُسوّى المدفوعات real time على مدار الساعة، بما في ذلك weekends وholidays. النظام mandatory — وليس voluntary — للمؤسسات التي تتجاوز حجماً معيناً.
PIX QR code ليس bank account number. فهو يحتوي PIX key، وهي alias مرتبطة بالحساب. تقوم بنية PIX لدى BCB بحل المفتاح إلى actual account details وقت الدفع. لا يرى payer رقم الحساب أبداً.
Static PIX QR code قابل لإعادة الاستخدام. أما dynamic PIX QR code (COB أو COBV format) فينشئه payment service provider (PSP) لمعاملة محددة ويحتوي URL يحله تطبيق payer في real time. هذا المنشئ ينشئ static QR codes. وتتطلب dynamic codes وجود PSP API.
البنية التقنية لـ PIX BR Code
EMVCo TLV format
يستخدم PIX payload EMVCo ترميز Tag-Length-Value (TLV). يمثل كل field بـ two-digit tag ID ثم two-digit field length ثم field content. وتُجمع الحقول بلا separators.
| Tag | الحقل | Example content | ملاحظات |
|---|---|---|---|
| 00 | Payload Format Indicator — مؤشر تنسيق payload | 01 | دائماً "01" — mandatory |
| 01 | Point of Initiation Method — طريقة بدء الدفع | 11 | 11 = static/reusable؛ 12 = single-use dynamic |
| 26 | Merchant Account Info (PIX) — معلومات حساب التاجر | (sub-template — انظر أدناه) | يحتوي PIX GUI وPIX key |
| 52 | Merchant Category Code — رمز فئة التاجر | 0000 | 0000 للاستخدام العام؛ تنطبق ISO 18245 codes |
| 53 | Transaction Currency — عملة المعاملة | 986 | 986 = BRL وفق ISO 4217 |
| 54 | Transaction Amount | 123.45 | Decimal format؛ احذفه لـ open-value |
| 58 | Country Code | BR | دائماً "BR" لـ PIX |
| 59 | اسم التاجر | JOAO SILVA | بحد أقصى 25 ASCII characters، uppercase، بلا accents |
| 60 | مدينة التاجر | SAO PAULO | بحد أقصى 15 ASCII characters، uppercase، بلا accents |
| 62 | Additional Data Field Template — قالب حقل بيانات إضافي | (sub-template — انظر أدناه) | يحتوي TXID |
| 63 | CRC-16 Checksum | 4-character uppercase hex — قيمة hex من 4 أحرف كبيرة | CRC-16/CCITT-FALSE، mandatory، ودائماً في النهاية |
معلومات حساب التاجر (tag 26 sub-template)
يحتوي Tag 26 بنية TLV متداخلة لـ PIX:
| Sub-tag | Content |
|---|---|
| 00 | BR.GOV.BCB.PIX — PIX GUI، ثابت دائماً |
| 01 | قيمة PIX key |
PIX GUI (Globally Unique Identifier) BR.GOV.BCB.PIX عبارة عن fixed string يحددها BCB. وهو يعرّف payment domain على أنه PIX داخل EMVCo framework.
أنواع PIX key
PIX key عبارة عن registered alias يُحل إلى bank account عبر BCB DICT (Transactional Accounts and Payments directory). توجد أربعة key types:
| Key type | Format example | ملاحظات |
|---|---|---|
| CPF | 12345678901 (11 digits — 11 رقماً) | معرّف دافع ضرائب فردي برازيلي |
| CNPJ | 12345678000195 (14 digits — 14 رقماً) | معرّف دافع ضرائب لكيان قانوني برازيلي |
| رقم الهاتف | +5511999999999 | رقم هاتف محمول برازيلي بصيغة E.164 |
| البريد الإلكتروني | [email protected] | عنوان بريد إلكتروني مسجل |
| EVP (random) | UUID v4، مثلاً 123e4567-e89b-12d3-a456-… | مفتاح ينشئه PSP عشوائياً — بلا personal data |
EVP (Endereço Virtual de Pagamento) key هو random UUID يعيّنه payment service provider. لا يحتوي personally identifiable information، ولذلك يمثل privacy-preserving option للأفراد الذين لا يريدون نشر CPF أو phone أو email داخل public QR code.
CRC-16 checksum
آخر field في كل PIX BR Code payload هو tag 63، وهو mandatory four-character uppercase hexadecimal CRC-16 checksum. Algorithm هو CRC-16/CCITT-FALSE مع polynomial 0x1021 وinitial value 0xFFFF.
يُحسب checksum على كامل payload string حتى tag وlength الخاصين بالحقل 63 نفسه (أي أن string المنتهي بـ "6304" يدخل في checksum calculation قبل إضافة four-character result). وسيُرفض payload إذا كان CRC-16 خاطئاً أو مفقوداً بواسطة PIX-enabled banking apps.
يحسب هذا المنشئ correct CRC-16 checksum ويضيفه تلقائياً. إذا أنشأت payload يدوياً فيجب إعادة حساب checksum كلما تغير أي field.
حقل بيانات إضافي (tag 62 sub-template)
يحتوي Tag 62 nested sub-template لتعريف المعاملة:
| Sub-tag | Content | ملاحظات |
|---|---|---|
| 05 | TXID | 26 to 35 alphanumeric characters; استخدم *** لـ open-value |
يربط TXID الدفعة بمعاملة محددة داخل نظام merchant. بالنسبة إلى static open-value QR تسمح مواصفة BCB باستخدام ثلاثة asterisks (***) كـ TXID placeholder.
Static مقابل dynamic PIX QR codes
| ميزة | Static PIX QR (BR Code) — ثابت | Dynamic PIX QR (COB/COBV) — ديناميكي |
|---|---|---|
| المبلغ | قيمة ثابتة أو مفتوحة | ثابت لكل معاملة |
| قابل لإعادة الاستخدام | نعم | One use per code |
| تم إنشاؤه بواسطة | أي منشئ BR Code | PSP API، وفق BCB COB/COBV specification |
| Payload content | بيانات الدفع كاملة داخل QR | URL يحله banking app الخاص بـ payer في real time |
| مطابقة آلية | عبر TXID إذا تم تحديده | Automatic عبر PSP transaction reference |
| مناسب لـ | تجار صغار، أفراد | E-commerce، invoicing، recurring payments |
تتطلب dynamic PIX QR codes (صيغة COB لـ open value وCOBV لـ fixed value) تكامل PSP API. تصدر BCB المواصفة التقنية لـ COB/COBV بشكل منفصل عن static BR Code Manual. هذا المنشئ ينتج static codes فقط.
متى تستخدم PIX QR code
التجار الصغار وأكشاك الأسواق. يسمح open-value static QR مطبوع على الكشك أو counter للعملاء بإدخال المبلغ المستحق والدفع فوراً من أي banking app. لا حاجة إلى card reader.
مقدمو الخدمات. يتيح QR code مطبوع على invoice أو business card للعملاء الدفع عبر PIX من دون معرفة bank account details الخاصة بالمقدم — يكفي PIX key.
المستقلون والبائعون الأفراد. يتيح EVP key QR code على marketplace listing أو social media profile للمشترين الدفع من دون أن ينشر البائع personal tax ID أو phone number.
المنظمات غير الربحية والمجتمعية. يسمح open-value QR code مطبوع على مواد التبرع للداعمين بإرسال أي مبلغ عبر PIX.
الفعاليات والمواقع المؤقتة. يتيح QR code على badge أو printed card استلام الدفع فوراً من دون cash أو POS terminal.
متطلبات التصميم والطباعة
حافظ على four-module quiet zone من جميع الجهات كما هو محدد في ISO/IEC 18004:2015 section 6.3.3.
اطبع بحجم لا يقل عن 2 cm by 2 cm للمسح القريب. ولـ merchant counter display يُقرأ من وضع الوقوف، فإن 5 cm أو أكبر هو appropriate industry guidance.
استخدم dark modules على light background. تفشل inverted-colour codes والتصميمات منخفضة التباين كثيراً على phone cameras في الإضاءة الخارجية المتغيرة.
PIX payload — بما في ذلك merchant GUI وPIX key والاسم والمدينة وTXID وCRC-16 — عبارة عن string متوسطة الكثافة. سينتج static code مع جميع fields populated QR symbol أكثر تعقيداً من URL QR. اطبع أكبر بدلاً من أصغر.
استخدم error correction level M كخط أساس. يستعيد Level M نحو 15 percent من damaged codewords. إذا أضفت logo فاستخدم level H (approximately 30 percent recovery)، وحافظ على logo ضمن 30 percent من code area كحد أقصى.
استكشاف الأخطاء: لماذا لا يعمل PIX QR code
PIX key غير مسجلة في BCB DICT. إنشاء QR code بمفتاح PIX غير مسجل ينتج code صحيحاً من ناحية syntax لكن banking app لا يستطيع route له. تحقق من أن المفتاح active في PIX key settings لتطبيقك المصرفي قبل encoding.
CRC-16 checksum خاطئ. أي تغيير في أي field بعد حساب checksum يبطله. إذا عدلت raw payload string يدوياً فأعد حساب checksum. هذا المنشئ يحسب checksum تلقائياً.
Merchant name يحتوي non-ASCII characters أو accents. تحدد BCB أن Merchant Name field (tag 59) يجب أن يكون uppercase ASCII بلا accents. استبدل "João" بـ "JOAO" و"São Paulo" بـ "SAO PAULO".
Merchant name أو city يتجاوز character limit. Tag 59 (Merchant Name) بحد أقصى 25 characters. Tag 60 (Merchant City) بحد أقصى 15 characters. اختصر حتى يتوافق.
TXID فارغ أو يستخدم disallowed format. بالنسبة إلى open-value static QR استخدم ثلاثة asterisks (***) كـ TXID. ولـ fixed transaction استخدم 26 to 35 alphanumeric characters. Invalid TXID يجعل بعض banking apps ترفض payload.
Banking app غير PIX-enabled. يجب على جميع licensed Brazilian financial institutions فوق BCB threshold دعم PIX. Apps من مؤسسات تحت threshold أو non-Brazilian banking apps لن تعالج PIX payment.
PIX مقابل معايير payment QR الأخرى
| ميزة | PIX QR — BR Code (Brazil / البرازيل) | EPC QR — GiroCode (Europe/SEPA / أوروبا) | UPI QR (الهند) |
|---|---|---|---|
| الجهة الحاكمة | Banco Central do Brasil | European Payments Council | NPCI |
| قياسي | BCB BR Code Manual v2.0, EMVCo MPM | EPC069-12 v3.1 | NPCI نظرة عامة على منتج UPI |
| العملة | BRL (ISO 4217 code 986) — عملة المعاملة | EUR فقط | INR فقط |
| Payload format | EMVCo TLV | 12-line plain text | upi:// URI query string — سلسلة استعلام |
| Mandatory checksum | نعم — CRC-16/CCITT-FALSE | لا | لا |
| متطلب error correction | غير محدد في research | Level M mandatory (EPC069-12) — المستوى M إلزامي | غير محدد في research |
ما الذي يقدمه PIX QR Code Generator هذا
تنشئ هذه الأداة القائمة على المتصفح static Brazilian PIX BR Code payload مع merchant details وoptional amount وreference وchecksum. وهي مخصصة لطلبات instant-payment البرازيلية والفواتير والمبيعات عن بعد والتحصيل في المواقع الثابتة. يتحدث live preview أثناء التحرير، مما يسهل اكتشاف missing field أو symbol كثيف بشكل غير متوقع قبل التنزيل.
يمكنك ضبط أنماط المصفوفة وأشكال عيون التحديد وألوان المقدمة والخلفية والتدرجات والإطارات والحجم وشعار اختياري. تتوفر الصادرات بصيغ SVG وPNG وWEBP وJPG بأحجام 512 أو 1024 أو 2048 أو 4096 بكسل. ويعد SVG الخيار العملي للطباعة الاحترافية، بينما يناسب PNG عالي الدقة مستندات المكتب والأعمال الرسومية الرقمية.
يُنشأ static payload داخل المتصفح. لا يلزم رفع المعلومات المدخلة إلى المنشئ لإنشاء QR image. تحقق من PIX key وmerchant name والcity والamount والrecipient المعروض في banking app قبل authorising transfer.
استخدام رمز QR هذا في البحرين وخارجها
PIX هو نظام instant-payment في Brazil وليس domestic Bahrain rail. استخدمه فقط لحساب برازيلي حقيقي وpayer لديه PIX access متوافق.
استخدم الإملاء البريطاني للإنجليزية في النصوص الموجهة للعملاء عندما يتوافق مع أسلوب مؤسستك، وقدّم صياغة عربية عندما يتوقعها الجمهور. اجعل الإجراء بعد المسح واضحاً. عبارة قصيرة بجانب الرمز مثل «امسح لحفظ جهة الاتصال» أو «امسح لفتح الموقع» تمنح الأشخاص ثقة قبل توجيه الكاميرا.
اختبر التصميم النهائي على أجهزة iPhone وAndroid الحديثة. ثم اختبره مرة أخرى بعد الطباعة على الورق أو الملصق أو البطاقة أو اللافتة أو مادة التغليف الفعلية. قد تكشف إضاءة البحرين الخارجية الساطعة الوهج ومشكلات التباين المنخفض التي تكون أقل وضوحاً على شاشة الكمبيوتر. وللاستخدام الدولي تحقق من رموز الدول والعملات والمناطق الزمنية وتوفر التطبيقات إقليمياً وتوافق شبكات الدفع.
قبل النشر
- نوع حمولة QR الصحيح
- بيانات كاملة ومتحقق منها
- منطقة هادئة من أربع وحدات
- تباين قوي للمقدمة
- تحجيم مربع متناسب
- إبقاء الشعار ضمن الحدود الآمنة
- SVG أو PNG عالي الدقة
- اختبار المسح على جهاز بالحجم النهائي
الأسئلة الشائعة
افتح سؤالاً لقراءة إجابة تقنية موجزة.
01ما هو PIX QR code؟+
PIX QR code — واسمه الرسمي BR Code — يشفر طلب PIX payment باستخدام EMVCo Merchant Presented Mode TLV format كما حدده Banco Central do Brasil في BR Code Manual v2.0. وينتهي بـ mandatory CRC-16/CCITT-FALSE checksum. يمكن لأي PIX-enabled banking app في Brazil مسحه ومعالجة الدفع.
02ما أنواع PIX key التي يمكن استخدامها في QR code؟+
يدعم PIX أربعة key types: CPF (11-digit individual tax ID)، CNPJ (14-digit entity tax ID)، رقم هاتف محمول برازيلي بصيغة E.164 (+5511999999999)، email address، وEVP — random UUID key بلا personal data يعيّنه payment service provider. EVP key هو privacy-preserving option.
03ما CRC-16 checksum في PIX QR code؟+
يجب أن ينتهي كل PIX BR Code payload بـ four-character uppercase hexadecimal CRC-16 checksum في tag field 63. Algorithm هو CRC-16/CCITT-FALSE مع polynomial 0x1021 وinitial value 0xFFFF. يُحسب checksum على complete payload string بما في ذلك "6304" prefix لحقل checksum نفسه. ترفض banking apps payloads ذات checksum المفقود أو الخاطئ.
04ما الفرق بين static وdynamic PIX QR code؟+
Static PIX QR يشفر full payment data مباشرة ويمكن إعادة استخدامه لمعاملات متعددة. Dynamic PIX QR (COB/COBV format) يحتوي URL يحله banking app لدى payer في real time عبر PSP. Dynamic codes one-use لكل transaction وتتطلب PSP API. هذا المنشئ ينشئ static codes فقط.
05هل يمكن إنشاء PIX QR code بلا fixed amount؟+
نعم. احذف amount field (tag 54). يسمح generated code لـ payer بإدخال أي amount في banking app. بالنسبة إلى open-value static QR استخدم ثلاثة asterisks (***) كـ TXID في tag 62 sub-tag 05 وفق BCB BR Code specification.
06ما التطبيقات التي يمكنها مسح PIX QR code؟+
يمكن لأي banking app تابع لـ PIX-enabled Brazilian financial institution مسح BR Code. فرض Banco Central do Brasil مشاركة PIX على جميع licensed institutions فوق defined threshold. جميع major Brazilian retail banks وdigital banks تدعم PIX scanning.
07ما EVP key في PIX QR code؟+
EVP (Endereço Virtual de Pagamento) key هو randomly generated UUID يعيّنه payment service provider. يرتبط bank account عبر BCB DICT من دون كشف CPF أو phone أو email لصاحب الحساب. وهو recommended PIX key type عندما سيُعرض QR code علناً.
08ماذا تعني string BR.GOV.BCB.PIX في PIX payload؟+
BR.GOV.BCB.PIX هو Globally Unique Identifier (GUI) لتطبيق PIX payment ضمن EMVCo framework. يظهر كـ sub-tag 00 داخل Merchant Account Information template (tag 26). تعرّف هذه fixed string payment domain على أنه PIX. تحتوي جميع PIX BR Codes الصحيحة على هذه literal string.
09ما maximum merchant name length في PIX QR code؟+
تقيد BCB BR Code specification حقل Merchant Name (tag 59) إلى 25 ASCII characters بالأحرف الكبيرة ومن دون accents. وحقل Merchant City (tag 60) محدود بـ 15 ASCII characters. يجب truncate للأسماء التي تتجاوز الحدود. Special characters وdiacritics غير مسموح بها.
10لماذا يجب التحقق من PIX QR code قبل الطباعة؟+
إنشاء valid BR Code payload لا يؤكد أن PIX key active أو correctly mapped في BCB DICT. المفتاح غير المسجل أو المكتوب خطأ ينتج code يُمسح بشكل صحيح لكنه يفشل وقت الدفع. امسح الرمز بتطبيق PIX-enabled banking app وتأكد من payee name المعروض قبل الطباعة بكميات كبيرة.