تكامل Razorpay مع PosBytz: دليل الإعداد

تكامل Razorpay مع PosBytz: دليل الإعداد خطوة بخطوة

يتوقع العملاء اليوم أن يدفعوا بسرعة وبأمان. مع تكامل Razorpay في PosBytz، يستطيع العملاء الذين يطلبون من موقعك الإلكتروني أو تطبيقك الدفع عبر UPI أو البطاقات أو الخدمات المصرفية عبر الإنترنت أو المحافظ الإلكترونية، ويُربط كل دفع بطلبه تلقائيًا.

يستغرق الإعداد بضع دقائق فقط. تحتاج إلى بيانين من حسابك في Razorpay، ويتم الباقي داخل PosBytz Studio. يرشدك هذا الدليل إلى كل خطوة، من إنشاء مفاتيح API إلى إتمام الربط.

ما تحتاج إليه قبل البدء

جهّز ما يلي قبل البدء في تكامل بوابة الدفع Razorpay:

• حساب تاجر نشط في Razorpay مع اكتمال التحقق من الهوية (KYC) وتفعيل المدفوعات الحية
• معرّف المفتاح (Key ID) في Razorpay، وهو معرّف عام لحسابك في Razorpay
• المفتاح السري (Key Secret) في Razorpay، وهو مفتاح خاص يُصرّح بطلبات الدفع
• صلاحية المسؤول (Admin) في PosBytz Studio عبر studio.posbytz.com

الخطوة 1: إنشاء مفاتيح Razorpay API

يتم إنشاء Key ID وKey Secret من لوحة تحكم Razorpay.

1. سجّل الدخول إلى لوحة تحكم Razorpay.
2. انتقل إلى الوضع المباشر (Live Mode) باستخدام المفتاح التبديلي أعلى لوحة التحكم.
3. اذهب إلى Account & Settings ثم افتح API Keys.
4. انقر على Generate Key.
5. انسخ كلًّا من Key ID وKey Secret، واحفظهما في مكان آمن.

مهم: يعرض Razorpay المفتاح السري (Key Secret) مرة واحدة فقط، وقت إنشائه. إذا فقدته، فستحتاج إلى إنشاء مجموعة مفاتيح جديدة. وإنشاء مفاتيح جديدة يؤدي إلى تعطيل المفاتيح القديمة، وبالتالي سيتوقف أي نظام يستخدمها عن العمل إلى أن تقوم بتحديثها.

الخطوة 2: تسجيل الدخول إلى PosBytz Studio

افتح studio.posbytz.com في المتصفح، وسجّل الدخول بحساب المسؤول الخاص بك. PosBytz Studio هو لوحة الإدارة التي تدير منها متجرك الإلكتروني ومنتجاتك وطلباتك وتكاملاتك.

الخطوة 3: فتح تكاملات الدفع

من القائمة الرئيسية، اذهب إلى Integrations (التكاملات) ثم اختر Payment Integrations (تكاملات الدفع). ستظهر لك قائمة بمزوّدي الدفع المتاحين لحسابك.

الخطوة 4: اختيار Razorpay وإدخال بياناتك

1. اختر Razorpay من قائمة مزوّدي الدفع.
2. الصق Key ID في حقل Key ID.
3. الصق Key Secret في حقل Key Secret.
4. احفظ البيانات.

هذا كل شيء. اكتمل تكامل Razorpay الآن، وأصبح Razorpay جاهزًا للاستخدام كخيار دفع على موقع الطلب الإلكتروني وتطبيقاتك.

كيف تعمل المدفوعات الإلكترونية بعد الإعداد

بعد تفعيل تكامل الدفع عبر Razorpay، تتم عملية الدفع الإلكتروني كما يلي:

1. يضيف العميل المنتجات إلى السلة في موقعك أو تطبيقك ثم ينتقل إلى إتمام الطلب.
2. تفتح نافذة Razorpay وقد أُدخل فيها مبلغ الطلب بدقة.
3. يدفع العميل عبر UPI أو بطاقة أو الخدمات المصرفية عبر الإنترنت أو محفظة إلكترونية.
4. بعد تأكيد الدفع، يتم تسجيل الطلب وتُسجَّل المعاملة مقابله في PosBytz.

تُحفظ كل معاملة Razorpay مع طلبها، مما يجعل مطابقة تحصيلاتك الإلكترونية مع تسويات Razorpay أسرع بكثير.

حل المشكلات الشائعة في الإعداد

يفشل الاتصال بعد حفظ البيانات.
تأكد من نسخ Key ID وKey Secret كاملين دون مسافات زائدة في البداية أو النهاية. غالبًا ما يحل لصق المفتاحين من جديد المشكلة.

المدفوعات لا تصل إلى حسابك البنكي.
تأكد من استخدام مفاتيح الوضع المباشر (Live Mode). تبدأ المفاتيح الحية بـ rzp_live_، بينما تبدأ مفاتيح الاختبار بـ rzp_test_. مفاتيح الاختبار تحاكي المدفوعات فقط، ولذلك لا يتم تحصيل أي أموال حقيقية.

توقّف التكامل فجأة عن العمل.
يحدث هذا عادةً عندما يعيد شخص ما إنشاء مفاتيح API في لوحة تحكم Razorpay. أنشئ مجموعة مفاتيح جديدة وحدّثها في PosBytz Studio ضمن Payment Integrations.

الوضع المباشر (Live Mode) غير متاح في لوحة تحكم Razorpay.
لا يفعّل Razorpay الوضع المباشر إلا بعد اكتمال تفعيل حسابك والتحقق من الهوية (KYC). تواصل مع دعم Razorpay إذا كان التفعيل لا يزال قيد المعالجة.

الأسئلة الشائعة

كم يستغرق تكامل Razorpay في PosBytz؟

تُنهي معظم الأنشطة التجارية الإعداد في أقل من 10 دقائق. وبعد أن تصبح مفاتيح API جاهزة، لا يتطلب ربطها في PosBytz Studio سوى بضع نقرات.

هل أحتاج إلى مطوّر لتكامل بوابة الدفع Razorpay؟

لا. كل ما عليك هو نسخ Key ID وKey Secret من Razorpay ولصقهما في PosBytz Studio. لا حاجة إلى أي برمجة.

أين يمكن للعملاء الدفع عبر Razorpay؟

يعمل Razorpay على موقع الطلب الإلكتروني وتطبيقات PosBytz. أما للمدفوعات داخل المتجر عند نقطة المحاسبة، فيمكنك استخدام تكامل PhonePe مع رموز QR الديناميكية لـ UPI.

هل يمكنني استخدام مفاتيح الاختبار لتجربة التكامل أولًا؟

تحاكي مفاتيح الاختبار المعاملات دون أموال حقيقية. استخدم المفاتيح الحية عندما تكون مستعدًا لقبول مدفوعات فعلية من العملاء.

أين أجد المفتاح السري (Key Secret) إذا فقدته؟

لا يعرض Razorpay المفتاح السري مرة أخرى بعد إنشائه. ستحتاج إلى إنشاء مجموعة مفاتيح جديدة وتحديث القيمتين في PosBytz Studio.

من يقوم بتسوية الأموال من مدفوعات Razorpay؟

يقوم Razorpay بتسوية الأموال مباشرة إلى حسابك البنكي وفق دورة التسوية الخاصة بك. أما PosBytz فيسجّل المعاملة فقط، ولا يحتفظ بأموالك أبدًا.

ابدأ قبول المدفوعات الإلكترونية عبر Razorpay

يساعدك تكامل Razorpay على إتمام عدد أكبر من الطلبات الإلكترونية، وتقليل مخاطر الدفع عند الاستلام، وإبقاء كل دفعة مطابقة لطلبها. اربط حسابك في Razorpay داخل PosBytz Studio وابدأ قبول المدفوعات الإلكترونية اليوم.