المكان: Settings → Readers & money → Connections → Payments
افتح هذه الصفحة: admin.<your-site>/settings/connections/payments (استبدل <your-site> بعنوان موقعك)
قبل البدء
- حساب على Razorpay. ابدأ في وضع التجربة داخل Razorpay.
- يجب أن تكون مالك الموقع.
الخطوات
- في لوحة تحكم Razorpay، بدّل إلى وضع التجربة.
- اذهب إلى الإعدادات → خيارات متقدمة → ربط تطبيقات أخرى → مفاتيح API وأنشئ مفتاحاً. انسخ key id و key secret. تعرض Razorpay المفتاح السري لمرة واحدة فقط.
- في Keynate، افتح الإعدادات → القراء والأرباح → عمليات الربط → المدفوعات واضغط على ربط Razorpay (أو إضافة جهة ربط).
- اختر وضع التجربة. الصق معرّف المفتاح (يبدأ بـ
rzp_test_)، والمفتاح السري، ورمز سر Webhook. - اضغط على ربط Razorpay في أسفل النافذة.
- في البطاقة، ابحث عن السماح لـ Razorpay بإخطار موقعك بالمدفوعات. لا تسمح Razorpay للتطبيقات الأخرى بإجراء ذلك نيابة عنك، لذا يستغرق الأمر دقيقة واحدة داخل Razorpay. ويتضمن 3 خطوات:
- افتح Razorpay ← أدوات Webhooks واضغط على Add New Webhook.
- املأ استمارة Razorpay بـ رابط Webhook، والمفتاح السري (Secret)، وActive events (حدد كل واحد منها). يتوفر بجانب كل منها زر نسخ. يُعرض الرمز السري مرة واحدة فقط. إذا أضعته، اضغط على تعديل، ثم إنشاء رمز سري جديد لي.
- اضغط على Create Webhook. ثم قم بإجراء عملية دفع تجريبية صغيرة.
- راقب السطر الموجود أسفل الخطوات. سيظهر Waiting for Razorpay's first message… وسيتحول إلى اللون الأخضر مع عبارة We received Razorpay's first message. عند نجاح العملية. ستظهر المدفوعات بعد ذلك كمدفوعة تلقائياً. اضغط على تحقق الآن للتحقق مجدداً. لاحقاً، يفتح عرض الخطوات مجدداً هذه الخطوات.
- اضغط على اختبار الاتصال في البطاقة، ثم قم بإجراء عملية دفع تجريبية.
- عندما تعمل بنجاح، اضغط على Go live with Razorpay في شريط وضع الاختبار وأضف مفاتيحك المباشرة (
rzp_live_). في الوضع المباشر، تتحول البطاقة إلى اللون الأخضر بعد أول عملية دفع حقيقية لك.
مزيد من المساعدة: إشعارات الدفع (webhook).
معلومات تهمك
- يجب أن تبدأ معرّفات المفاتيح بـ
rzp_test_لوضع الاختبار أوrzp_live_للوضع المباشر. - استخدم webhook secret مختلفاً لوضع الاختبار عن الوضع المباشر.
المشاكل الشائعة
- "تبدأ معرّفات المفاتيح بـ rzp_test_ (لوضع الاختبار) أو rzp_live_ (للوضع المباشر). انسخها من صفحة مفاتيح API داخل لوحة تحكم Razorpay."
- "الصق key secret. تعرضه Razorpay مرة واحدة فقط عند إنشاء المفتاح." أنشئ مفتاحاً جديداً إذا أضعته.
- "الصق webhook secret الذي أدخلته في Razorpay."
الأسئلة الشائعة
الأسئلة الشائعة
أين أجد صفحة مفاتيح Razorpay؟
تحتوي النافذة على رابط يفتحها في علامة تبويب جديدة، وتحتوي اللوحة الجانبية للصفحة على فتح مفاتيح API في Razorpay وفتح Webhooks في Razorpay.
كيف أتأكد من أن الـ webhook يعمل؟
تعرض البطاقة We received Razorpay's first message.، وحتى يحين ذلك يظهر Waiting for Razorpay's first message…. إذا كانت Stripe أو PayPal مفعلة أيضاً، فلن تتمكن البطاقة من تحديد أي منها أرسل الإشعار وستوضح ذلك. إذا قمت بذلك بنجاح مسبقاً، فلا داعي لأي إجراء إضافي.
أين يوجد زر التبديل إلى وضع الاختبار؟
داخل لوحة تحكم Razorpay. بدّل إلى وضع التجربة قبل إنشاء المفاتيح.