توثيق Pay by QR
شرح بالفيديو
بفصول قابلة للنقر — انقر فصلاً للانتقال إليه مباشرة.
البدء
اتبع هذه الخطوات لتشغيل Pay by QR.
تثبيت Pay by QR
افتح Setup > Modules، واختر الملف المضغوط في «Upload Module» ثم اضغط «Install». فعّل الإضافة وأدخل مفتاح الترخيص. تجد الإعدادات في Setup > Pay by QR.
راجع طريقة الدفع بالتحويل البنكي
تأكد أن وصف طريقة الدفع «Bank transfer» في Setup > Finance > Payment Modes يحتوي على رقم IBAN (ورمز BIC إن أردت). في Pay by QR تنسخهما عبر «استيراد من طريقة دفع» أو تدخل الحساب يدوياً. لا مشكلة في عدة حسابات بعدة طرق دفع: كل فاتورة باليورو أو الكرونة تستخدم حساب الطريقة المسموح بها عليها. أما بيانات سويسرا وUPI فلها أقسامها الخاصة.
صاحب الحساب والدول
أدخل اسم صاحب الحساب كما هو مسجّل لدى بنكك تماماً. املأ الأقسام التي تحتاجها فقط: العنوان السويسري للفرنك، ورقم IBAN التشيكي للكرونة، ومعرّف UPI واسم المستفيد للروبية. وتبقى أقسام العملات غير المضافة في Perfex مطوية.
ضع قسم الدفع في ملف PDF
اختر الموضع (بعد المحتوى، أو قبل ملاحظة العميل، أو أسفل الصفحة الأخيرة) والحجم، وعنواناً وإطاراً إن أردت، وما إذا كان الرمز يظهر أيضاً على الفاتورة في منطقة العملاء. قسم الدفع السويسري (Swiss QR-bill) له تصميم ثابت ولا يتأثر بهذه الخيارات.
مسح تجريبي ثم التشغيل
امسح الرموز النموذجية (المبلغ 1.00 والمرجع TEST-0001) بتطبيقك وتحقق من المستفيد والمبلغ والمرجع، دون تأكيد الدفع. بعد ذلك فعّل «طباعة رمز QR للدفع على الفواتير».
اختياري: رمز الرابط للعملات الأخرى
خيار رمز الرابط مفعّل افتراضياً، ويعمل بمجرد أن تكون بوابة دفع مثل PayPal Smart Checkout أو Stripe Checkout مفعّلة، وتتضمن عملة الفاتورة، ومسموحاً بها على الفاتورة. يعرض مربع الحالة البوابات المفعّلة.
نصائح وحيل
احصل على أقصى استفادة من Pay by QR مع هذه النصائح.
الاسم المسجّل لدى البنك للفواتير باليورو
في الفواتير باليورو أدخل اسم صاحب الحساب كما يعرفه بنكك. فمنذ أكتوبر 2025 تقارن البنوك في منطقة اليورو الاسم برقم IBAN، والاسم التجاري يجعل بنك العميل يحذّر من عدم التطابق رغم صحة IBAN.
اقصر الرمز على التحويل البنكي
في «العرض فقط إذا كانت طريقة الدفع هذه مسموحة للفاتورة» اختر طريقة التحويل البنكي، فلا تحصل الفواتير المدفوعة بالبطاقة أو نقداً على أي رمز.
اترك مساحة لرموز UPI
تحتاج رموز UPI إلى حد أدنى أكبر للحجم كي تبقى قابلة للمسح، لذا تكبّرها Pay by QR إلى 32 ملم على الأقل، أو 45 ملم مع بيانات GST، أياً كان الحجم الذي ضبطته. اترك هذه المساحة فارغة في فاتورتك.
رمز الرابط مع PayPal: ثلاث نقاط للتحقق
إذا لم يظهر رمز الرابط مع PayPal Smart Checkout، فتحقق من أن «Active» مفعّل و«Enable Test Mode» معطّل، وأن عملة الفاتورة مدرجة في «Currencies»، وأن PayPal ضمن طرق الدفع المسموح بها على الفاتورة.
العنوان السويسري كما لدى البنك
في قسم الدفع السويسري (Swiss QR-bill) يجب أن يطابق الاسم والشارع والرمز البريدي والمدينة بيانات بنكك. وإذا كان العنوان ناقصاً، تحصل الفواتير باليورو على رمز EPC عادي.
تقرير التشخيص لدعم أسرع
عند فتح تذكرة دعم، نزّل تقرير التشخيص من إعدادات Pay by QR وأرفقه. فهو يعرض الحسابات الموجودة في طرق الدفع وبوابات الدفع المفعّلة، وهذا يفسّر غالباً سبب غياب رمز QR.
الرمز الضريبي يبقى من مهمة برنامجك الضريبي
إذا كان بلدك يشترط رمز QR ضريبياً، فواصل إصداره ببرنامج الفوترة المعتمد. تضيف Pay by QR رمز الدفع فقط.
الأسئلة الشائعة
هل تحل Pay by QR محل رمز QR الضريبي لدى ZATCA؟
لا، لا تحل Pay by QR محل رمز QR الضريبي لدى هيئة الزكاة والضريبة والجمارك ولا أي رمز ضريبي آخر مثل ATCUD أو VERI*FACTU أو IRN. فهي تطبع رموز QR للدفع تخبر تطبيق البنك بمن يُدفع له وكم. أما الرموز الضريبية الإلزامية فيصدرها برنامج الفوترة المعتمد لديك أو الجهة الضريبية.
أي رمز QR للدفع تحصل عليه فاتورتي في Perfex CRM؟
تختار Pay by QR الرمز حسب عملة الفاتورة وحسابك. الفواتير باليورو تحصل على رمز SEPA (EPC)، والفواتير بالفرنك السويسري على قسم الدفع السويسري (Swiss QR-bill)، والفواتير بالكرونة التشيكية على QR Platba، والفواتير بالروبية الهندية على رمز UPI. وكل عملة أخرى تحصل على رمز QR يفتح صفحة الفاتورة على الإنترنت، إذا سمحت الفاتورة ببوابة دفع إلكتروني مفعّلة.
هل تنشئ Pay by QR رمزاً بنكياً للفواتير بالريال السعودي أو الدرهم الإماراتي؟
لا، لا تنشئ Pay by QR رمز QR بنكياً محلياً للريال السعودي أو الدرهم الإماراتي أو غيرهما من عملات المنطقة. تحصل هذه الفواتير على رمز QR يفتح صفحة الفاتورة على الإنترنت، ومنها يدفع العميل عبر بوابة دفع مفعّلة في Perfex. إذا كان عملاؤك يدفعون غالباً بالبطاقة، فرابط الفاتورة الذي يرسله Perfex أصلاً يؤدي معظم المهمة.
هل تُعلَّم الفاتورة كمدفوعة تلقائياً؟
ليس في حالة التحويل البنكي: لا تقرأ Pay by QR حسابك البنكي، لذا تسجّل التحويل أو دفعة UPI في Perfex كالمعتاد عبر زر «Payment» في الفاتورة. ما يتغير هو ما يصلك: المبلغ الصحيح مع رقم الفاتورة كمرجع، فتسهل مطابقة الدفعة. أما إذا دفع عميلك عبر رمز الرابط من خلال بوابة دفع إلكتروني مثل PayPal Smart Checkout، فيسجّل Perfex الدفعة بنفسه ويحدّث حالة الفاتورة.
لماذا لا يظهر رمز QR على إحدى الفواتير؟
لا تطبع Pay by QR الرمز إذا كانت الفاتورة لا تُدفع به، وغالباً ما يعود السبب إلى أحد الأمور التالية. قد يكون المفتاح الرئيسي «طباعة رمز QR للدفع على الفواتير» معطّلاً، وهو كذلك بعد التثبيت مباشرة. وقد تكون الفاتورة مدفوعة أو ملغاة أو مسودة، أو لم يبقَ منها شيء للدفع. وربما قصرت الرمز على طريقة دفع واحدة في «العرض فقط إذا كانت طريقة الدفع هذه مسموحة للفاتورة» والفاتورة لا تسمح بها. وإذا كانت أرقام IBAN محفوظة في طرق الدفع ولا تحتوي أي طريقة مسموح بها على فاتورة باليورو أو الكرونة على رقم منها، فلا يظهر رمز SEPA أو QR Platba. وقد تكون البيانات البنكية للعملة ناقصة أو غير صحيحة، وتعرض صفحة الإعدادات ما يجب تصحيحه عند الحفظ. وأخيراً قد لا يكون للعملة معيار QR بنكي، ولا تسمح الفاتورة بأي بوابة دفع مفعّلة لرمز الرابط. يعرض مربع الحالة في الإعدادات البوابات المفعّلة.
كيف أحصل على رمز QR برابط الدفع مع بوابة دفع في Perfex مثل PayPal Smart Checkout؟
تعرض Pay by QR رمز الرابط عندما تسمح الفاتورة ببوابة دفع إلكتروني مفعّلة. مع PayPal Smart Checkout: افتح Setup > Settings > Finance > Payment Gateways ثم تبويب «Paypal Smart Checkout». اضبط «Active» على Yes وأدخل Client ID وSecret الخاصين بتطبيق PayPal. اضبط «Enable Test Mode» على No، وإلا ذهبت المدفوعات إلى بيئة PayPal التجريبية. أضف عملة فواتيرك إلى «Currencies (coma separated)» (القيمة الافتراضية USD,CAD,EUR)، لأن Perfex لا يعرض البوابة إلا لهذه العملات. خيار «Selected by default on invoice» يخص الفواتير الجديدة فقط، أما الفواتير الحالية فأضف PayPal فيها ضمن «Allowed payment modes for this invoice». خيار رمز الرابط في Pay by QR مفعّل افتراضياً، والخطوات نفسها تنطبق على بوابات Perfex الأخرى مثل Stripe Checkout.
هل تضيف Pay by QR رمز UPI إلى فواتير Perfex CRM في الهند؟
نعم، تضيف Pay by QR رمز QR بنظام UPI إلى كل فاتورة غير مدفوعة بالروبية، وفق مواصفات روابط UPI، لتطبيقات مثل Google Pay وPhonePe وPaytm وBHIM، ويحمل معرّف UPI والمبلغ المتبقي ورقم الفاتورة. ويعرض التطبيق الاسم المسجّل لدى بنكك. الرمز غير موقّع من مزوّد خدمة دفع، لأن التوقيع لا يتم إلا عبر البنك المستحوذ، لذلك قد تعرض بعض التطبيقات تنبيه «غير موثّق». كما أنني لم أختبره بعد بتطبيق UPI في الهند، والحد الأدنى للحجم (32 ملم، و45 ملم مع بيانات GST) مأخوذ من محاكاة المسح بالهاتف. يمكنك التحقق بنفسك من اليوم الأول: بعد حفظ معرّف UPI واسم المستفيد يعرض المسح التجريبي رمزاً بقيمة ₹1.00 ومرجع TEST-0001، فامسحه بتطبيق UPI دون تأكيد الدفع. وإن لم يعمل معك، يمكنك استرداد أموالك خلال 14 يوماً، لأي سبب.
هل يمكن أن تضيف Pay by QR بيانات GST لرمز UPI ديناميكي؟
نعم، يمكن أن تضيف Pay by QR إلى رمز UPI رقم GSTIN ورقم الفاتورة وتاريخها وتوزيع CGST/SGST/IGST/cess من ضرائب الفاتورة. يحمل الرمز حينها بيانات أكثر فيُطبع بحجم 45 ملم. أما هل يفي ذلك بمتطلبات الرمز الديناميكي لشركتك، فاسأل مستشارك الضريبي. ولا تنشئ الإضافة رمز الفاتورة الإلكترونية (IRN).
هل يحمل رمز QR المبلغ المتبقي بعد الدفع الجزئي؟
نعم، تستخدم Pay by QR دائماً المبلغ المتبقي وليس الإجمالي الأصلي. فإذا دفع عميلك 300 من 1000، يطلب المسح التالي 700، ورقم الفاتورة هو المرجع.
أي تطبيقات البنوك تقرأ رمز QR؟
تبني Pay by QR كل رمز وفق المعيار المنشور في بلده: EPC069-12 لـ SEPA، وإرشادات SIX 2.4 لقسم الدفع السويسري (Swiss QR-bill)، ومعيار رابطة البنوك التشيكية لـ QR Platba، ومواصفات روابط UPI للهند. مسحتُ إحدى فواتيري بتطبيق بنك ألماني (comdirect) فكان المبلغ والمرجع صحيحين. وفُحصت الرموز السويسرية والتشيكية وبيانات EPC أيضاً بأدوات تحقق مستقلة. لم تُجرَّب كل التطبيقات، ولهذا توجد في الإعدادات ميزة المسح التجريبي لتطبيقك.
هل يجب أن أعدّل قالب الفاتورة؟
لا، لا تلمس Pay by QR قالب فاتورتك ولا أي ملف من ملفات Perfex الأساسية. فهي تضيف قسم الدفع عبر الخطافات القياسية: بعد المحتوى، أو قبل ملاحظة العميل، أو أسفل الصفحة الأخيرة. وإذا تعذّر إنشاء رمز QR، يُنشأ ملف PDF للفاتورة رغم ذلك، لكن دون قسم الدفع.
هل يمكنني تجربة Pay by QR قبل الشراء؟
نعم، يمكنك تجربة Pay by QR في العرض التجريبي: افتح من Sales > Invoices فاتورة غير مدفوعة باليورو ثم ملف PDF الخاص بها، وامسح الرمز من الشاشة بتطبيق البنك على هاتفك. المستفيد رقم IBAN نموذجي منشور للعامة، فلا يعرض تطبيقك إلا بيانات تحويل جاهزة تغلقها دون إرسال. وإن كنت تصدر فواتير بالروبية، فاستخدم المسح التجريبي في الإعدادات بعد التثبيت. وبعد الشراء لديك 14 يوماً لاسترداد أموالك، لأي سبب.
هل يمكنني استخدام ترخيص واحد على عدة تثبيتات من Perfex؟
لا، ترخيص Pay by QR يغطي تثبيتاً واحداً من Perfex CRM ومرتبط بنطاق واحد. وكل تثبيت إضافي، لدى عميل آخر مثلاً، يحتاج ترخيصاً مستقلاً.
ما إصدارات Perfex CRM المدعومة؟
صُممت Pay by QR لإصدارات Perfex CRM 3.x وفُحصت على الإصدار 3.4.0، وهو يتطلب بدوره PHP 8.1 أو أحدث.
هل تحتاج مساعدة إضافية؟
تواصل مع فريق الدعم أو قم بزيارة صفحة الإضافة لمزيد من المعلومات.