هذا العرض يوضح لك خطوة بخطوة كيفية بناء تطبيق صغير من الصفر. Razorpay هو مزود خدمة دفع في الهند. سيقوم هذا العرض بإنشاء إجراء "إنشاء رابط دفع" ومحفز "مدفوع الدفع". راجع الوثائق هنا: مستندات Razorpay.

الخطوات | ماذا تفعل

سجل | سجل في Razorpay واحصل على مفتاح API

اصنع | أنشئ التطبيق

الإعدادات | إعداد معلومات التطبيق الأساسية

المصادقة | إعداد مصادقة التطبيق

الإجراءات | أضف إجراء "إنشاء رابط الدفع" وتحرير معلومات الإجراء والمدخلات

التدفقات | قم بتحرير التدفق الفرعي للإجراء والحصول على مخرجات الفعل

الإجراءات | تحرير مخرجات الإجراءات

الاختبار | قم بتثبيت تطبيق المسودة وجربه

روابط لمرة واحدة | أضف رابط لمرة واحدة لتلقي نتيجة الدفع

10. المحفزات | أضف محفزا لإرسال نتيجة الدفع

11. الاختبار | اختبار مرة أخرى

أول شيء، سجل حساب Razorpay واحصل على مفتاح API الخاص بك في الإعدادات - مفتاح API:

في لوحة التحكم الخاصة بك، اتبع الخطوات من 1 إلى 7 في لقطة الشاشة أعلاه لإنشاء تطبيق الإصدار 2 والدخول إلى منشئ التطبيقات.

في قسم الإعدادات، انقر على تعديل لتعديل معلومات التطبيق بما في ذلك اسم التطبيق، الوصف، الشعار وصورة الغلاف.

يمكن للمستخدمين عرض معلومات تطبيقك قبل تحميل تطبيقك.

وفقا لوثيقة التحقق من Razorpay، key_id وهذه key_secret الوثائق مطلوبة مع التحقق الأساسي من المصادقة .

في قسم المصادقة ، اختر مفتاح API كنوع تصادق واضغط على تعديل لإضافة مدخلي التوثيق.

انقر على الحفظ عند الانتهاء من الإضافة key_id و key_secret:

الآن قمنا بإعداد جزء المصادقة في تطبيقك، دعونا نضيف الإجراءات!

واجهة برمجة التطبيقات المستخدمة: إنشاء رابط دفع.

اتبع الخطوات من 1 إلى 6 في لقطة الشاشة أعلاه لإنشاء الإجراء وابدأ في تحريره.

باتباع وثائق واجهة برمجة التطبيقات، يمكنك معرفة المعلمات المطلوبة، وأنواع القيم، وهل هي إلزامية أم اختيارية.

انقر على إضافة العناصر في قسم المدخلات :

احتفظ بوثائقك NewAge Ai جنبا إلى جنب، وانسخ ووالصق المعلومات وفقا لذلك.

بالنسبة للمعلمات الاختيارية، قم بإلغاء تحديد خيار Required? وقدم قيمة افتراضية إذا احتجت.

نقترح عليك ملء المدخلات أولا وترك المخرجات بعد الانتهاء من التدفق الفرعي لهذا الإجراء.

ضع الوصف والإرشاد اللازمين، وتحقق من قسم المعاينة لرؤية مداخلاتك.

تذكر دائما أن تضغط على الحفظ بدلا من الإلغاء قبل الخروج من تحرير الإجراءات.

بعد تحرير معلومات الإجراء والمدخلات، أنشئ تدفقا فرعيا ليتم تشغيله عندما يستدعي المستخدمون هذا الإجراء:

اذهب إلى قسم التدفقات وأدخل التدفق الفرعي الذي أنشأناه للتو:

في حالة إنشاء رابط دفع، يجب أن يكون طلب خارجي واحد كافيا:

اتبع الخطوات من 3 إلى 5 في لقطة الشاشة أعلاه لبدء تحرير الطلب الخارجي. لا تعرف كيف تضيف خطوة إجراء؟ لا تقلق، جرب النقر بزر الفأرة الأيمن.

اختر POST النوع، والصق الرابط، ثم اختر Body - raw - JSON ثم انسخ المعلمين، المبلغ والعملة.

استبدل 1000 حقول تطبيق المبلغ والعملة بالضغط INR على الزر </> على الجانب الأيمن. في النافذة المنبثقة، ابحث عن الحقل بالاسم وانقر لاختيار:

عند إدخال حقول التطبيق، يظهر "محتوى جسم الاختبار". الهدف هو تحديد قيم الاختبار للحقول. بدون قيمة الاختبار، يمكن أن يفشل الاختبار. لنحدد المبلغ والعملة 1000 على AUD:

نصيحة - عندما تستخدم {{ استدعاء حقل، تأكد من عدم وجود حرف مشابه " خلفه مباشرة. انظر لقطة الشاشة أدناه.

بالنسبة للمصادقة، ذكرنا أن Razorpay API يستخدم Basic Authorth:

اختر المصادقة الأساسية، املأ حقول التطبيق وتذكر أن تضع الاختبار key_id والاختبار key_secret.

يبدو أن كل شيء على ما يرام الآن، اضغط زر الاختبار :

اتبع الخطوات من 1 إلى 8 لحفظ نتيجة الاختبار في حقول التطبيق واضغط على حفظ.

ممتاز! تم إكمال الطلب وحصلنا على payment_link_id ما payment_link نحتاجه من بيانات الرد.

payment_link_id هو معرف لتتبع رابط الدفع ويخزن payment_link الرابط نفسه.

حاول زيارة رابط الدفع:

ممتاز! كيف نعيد رابط الدفع والمعرف إلى روبوت الدردشة؟ لا تنس أننا لم نقم بعد بإعداد مخرجات الأكشن !

احفظ وانشر التدفق الفرعي الخاص بك، ثم لنعد إلى قسم الإجراءات :

أضف المخرجين واضغط على زري الحفظ لحفظ ليس فقط تحرير المخرج، بل أيضا تحرير الحركة.

في لوحة التحكم الخاصة بك، اتبع لقطات الشاشة أدناه لتثبيت تطبيقك في النسخة الأصلية لأنه لم ينشر بعد:

قم بتعبئة بيانات الاعتماد الخاصة بك وادخر:

قم بتحديث بيانات اعتمادك هنا إذا احتجت:

اختر أي من روبوتات الدردشة الخاصة بك، مثل فيسبوك دردشة روبوت:

أنشئ خطوة إجراء، ثم اذهب إلى التكاملات، ثم اختر إجراء تطبيقك.

املأ المدخلات، إعداد المخرجات، ثم اضغط على حفظ:

أضف خطوتين إضافيتين لإرسال رسالة للتعامل مع حالتين مختلفتين:

اطبع النتيجة وضع رابط الدفع على زر URL.

معاينة من خطوة الإجراء، وسترى هذه الرسالة المرسلة إلى ماسنجر الخاص بك:

انقر على زر الدفع وسترى صفحة الدفع في Razorpay تظهر دفعة بقيمة 99.99 دولار أمريكي:

ماذا لو لم يتم استلام الرسالة؟

قد تفشل في استقبال هذه الرسالة لأن بعض روابط الدفع يمكن أن تحجب تلقائيا من قبل فيسبوك. قد ترغب في اختيار بعض خدمات اختصار الروابط مثل Bitly وغيرها. (تطبيق Bitly متوفر في متجر التطبيقات NewAge Ai )

في حال لم يتم استلام الرسالة على جانب فيسبوك، يرجى التحقق منها في الدردشة المباشرة:

نصيحة - عندما تعرض رسالة في محادثة الدردشة المباشرة ، فهذا يعني أن النظام قد أرسلها.

يبدو أن الحركة تعمل بشكل جيد!

تطبيقك على وشك الانتهاء! انتظر، الدفع يتم على موقع Razorpay، كيف لي أن أعرف هل تم دفع الدفعة أم فشلت؟ حسنا، عادة ما يقدم مزودو الدفع معاملة تسمى Callback URL:

وفقا للوثائق، callback_url هو المكان الذي يرسل فيه Razorpay نتيجة الدفع. وهذا يعني أننا بحاجة إلى إعطاء Razorpay رسالة callback_urlتخبرهم أين يرسلون المعلومات.

يمكن استخدام رابط لمرة واحدة كرابط Callback URL هنا.

اتبع الخطوات من 1 إلى 5 في لقطة الشاشة أعلاه لإنشاء وتعديل رابط المرة الواحدة.

دعنا نفتح صفحة ويب أخرى للتطبيق قبل أن تدخل صفحة تحرير الرابط لمرة واحدة.

اذهب إلى إجراء "إنشاء رابط دفع" في الصفحة 2 وأضف المعلمين إلى قسم النص:

استمع إلى الحمولة لاختبار مباشر. يرجى ملاحظة أن رابط الاختبار يجب لصقه في "محتويات جسم الاختبار" بدلا من "محتوى الجسم":

عند الانتهاء، اضغط على Test وستحصل على رابط دفع كما رأيت سابقا. قم بزيارة رابط الدفع وقم بإجراء دفعة اختبارية:

استخدم بطاقة اختبار لمحاكاة عملية الدفع.

أعط رمز OTP عشوائي وقدم.

وأخيرا، اضغط على تم (Done) وسترى البيانات التي نحتاجها عند دفع دفعة حقيقية:

لقد أنهينا الآن القسم الأول، المعلمات، في "رابط لمرة واحدة".

نماذج الويب هي جمع معلومات إضافية عبر نموذج إلكتروني، وهو أمر غير ضروري في القضية. لنذهب مباشرة لتصميم صفحتنا الإلكترونية:

يبدو جيدا. في الأسفل، اذكر فترة انتهاء صلاحية لعنوان URL لمرة واحدة. افتراضيا، ينتهي صلاحية الرابط خلال 10 دقائق. الخطوة النهائية لرابط المرة الواحدة هي تحديد تدفق فرعي ليتم تشغيله عند فتح هذه الصفحة من قبل المستخدمين:

لا تنس الضغط على حفظ في الزاوية العلوية اليمنى ويتم الانتهاء من رابط المرة الواحدة:

بعد إعداد الرابط لمرة واحدة، دعونا نضيفه إلى إجراء إنشاء رابط الدفع :

في التدفق الفرعي لإنشاء رابط الدفع ، أضف إجراء الحصول على رابط مرة واحدة قبل الطلب الخارجي (انقر واسحب للنقل).

احفظ عنوان URL الجديد المنشأ في حقل تطبيق، ثم عدل الطلب الخارجي لإدراج الحقل:

احفظ التحرير وانشر التدفق الفرعي.

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

اتبع الخطوات من 1 إلى 6 في لقطة الشاشة أعلاه لإنشاء محفز وابدأ في تحريره:

هنا تحدد البيانات التي يجب إرسالها إلى روبوت الدردشة، وفي هذه الحالة نرسل كلاهما payment_status وكل payment_result ملف JSON.

بعد ذلك، يمكننا تشغيل الزناد في التدفق الفرعي الذي يشغله عنوان URL لمرة واحدة عند استلام الدفع:

نصيحة - بما أن تطبيقك لا يزال في النسخة الأولية، فإن أي تغييرات تجرى على التطبيق سيتم تحديثها لجميع التطبيقات المثبتة أيضا. كل ما عليك هو تحديث الصفحة للحصول على أحدث نسخة من التطبيق.

لا يوجد شيء لتعديله في تدفق الدردشة السابق لكن يجب إعداد المحفز في الأتمتة قبل اختبار عملية الدفع مرة أخرى:

اتبع الخطوات من 1 إلى 4 في لقطة الشاشة أعلاه لإضافة الزناد وتسمية حقلين مخصصين لحفظ البيانات في الدردشة الروبوتية:

أنشئ تدفقا فرعيا جديدا لهذا المحفز. سيتم تشغيل التدفق الفرعي بمجرد استلام روبوت الدردشة للبيانات من التطبيق:

في التدفق الفرعي، ببساطة نطبع البيانات التي استلمناها:

كل شيء على ما يرام الآن، دعونا ننشر التدفق الفرعي ونعود إلى التدفق الفرعي السابق لمعاينة خطوة الإجراء مرة أخرى:

تم استلام رابط آخر، اضغط على الدفع واستخدم بطاقة الاختبار مرة أخرى لمعالجة الدفع:

تظهر صفحة الويب المصممة كما هو متوقع:

دينغ! وصلت رسالة أيضا في رسالة الرسائل:

🚀 مبروك!! لقد أنشأت أول تطبيق لك! 😍