استخدام Paddle مع MonstarX
باختصاراختر بيئة الاختبار أو البيئة الفعلية، والصق مفتاح Paddle API في صف Paddle ضمن الخدمات السحابية ← السحابة. بعدها يستطيع وكيل الإنشاء في MonstarX قراءة منتجاتك وعملائك ومعاملاتك واشتراكاتك في Paddle، مثلًا لإنشاء صفحة أسعار تطابق كتالوجك. وهو يقرأ فقط، ولا يغيّر أي شيء في Paddle أبدًا.
اطّلع على المنتجات والعملاء والاشتراكات.
- النوع
- أداة أعمال · مفتاح API
- الفئة
- المدفوعات والفوترة
- طريقة الربط
- مفتاح API
يبيع Paddle البرامج والمنتجات الرقمية نيابةً عنك، ويتولى الفوترة والضرائب والاشتراكات. اربط حسابك في Paddle بمفتاح API (رمز يشبه كلمة المرور، يتيح للبرامج استخدام حسابك)، وسيتمكن وكيل الإنشاء في MonstarX، أي الذكاء الاصطناعي الذي تتحدث معه، من قراءة كتالوجك وبيانات الفوترة أثناء عمله: ينشئ صفحة أسعار من منتجاتك الحقيقية، أو يلخّص الخطط التي اشترك فيها عملاؤك.
هذه أداة أعمال: يقرأ MonstarX حسابك في Paddle نيابةً عنك. أما التطبيق الذي تنشئه فلا يحصل على مفتاحك أبدًا. لاستقبال المدفوعات في تطبيقك، راجع Stripe.
ما الذي يستطيع MonstarX فعله به؟
Section titled “ما الذي يستطيع MonstarX فعله به؟”| ما يستطيع MonstarX فعله | متى |
|---|---|
| عرض منتجاتك | أي وضع |
| عرض عملائك | أي وضع |
| عرض معاملاتك | أي وضع |
| عرض اشتراكاتك | أي وضع |
تأتي كل قائمة 20 عنصرًا في كل مرة (حتى 30)، ويستطيع MonstarX التنقل بين الصفحات لجلب المزيد. ما لا يفعله أبدًا: إنشاء أي شيء أو تغييره أو إلغاؤه، سواء كان منتجات أو أسعارًا أو عملاء أو معاملات أو اشتراكات أو مبالغ مستردة.
قبل أن تبدأ
Section titled “قبل أن تبدأ”- حساب في Paddle. يحتوي حساب بيئة الاختبار (sandbox) على بيانات تجريبية، ويحتوي حسابك الفعلي (live) على البيانات الحقيقية. وهما حسابان منفصلان لكل منهما مفاتيحه.
- أنت مالك المشروع في MonstarX. لا يستطيع ربط أداة أو قطع اتصالها إلا المالك.
احصل على مفتاحك
Section titled “احصل على مفتاحك”-
في Paddle (في بيئة الاختبار أو البيئة الفعلية، أيهما تريد ربطه)، انتقل إلى Developer Tools > Authentication وافتح تبويب API keys.
-
انقر على New API key وسمِّ المفتاح باسم مثل
MonstarX. -
امنحه أذونات القراءة هذه:
product.readوcustomer.readوtransaction.readوsubscription.read. لا يحتاج MonstarX إلى أكثر من ذلك، ولا يستخدم أذونات الكتابة أبدًا. -
حدّد تاريخ انتهاء الصلاحية (المدة الافتراضية في Paddle هي 90 يومًا)، ثم احفظ وانسخ المفتاح. يبدأ المفتاح بـ
pdl_sdbx_apikey_في بيئة الاختبار، أو بـpdl_live_apikey_في البيئة الفعلية.
دليل Paddle الرسمي: Create and manage API keys.
اربطه في MonstarX
Section titled “اربطه في MonstarX”-
افتح مشروعك وانقر على الخدمات السحابية في الشريط العلوي، ثم على السحابة.
-
انتقل إلى قسم الموصلات، وابحث عن Paddle، ثم انقر على ربط.
-
اختر بيئة الاختبار أو البيئة الفعلية بما يطابق مفتاحك، والصق المفتاح في حقل المفتاح، ثم انقر على ربط.
-
يتحقق MonstarX من المفتاح لدى Paddle. إذا نجح ذلك، يظهر في الصف متصل · بيئة الاختبار أو متصل · البيئة الفعلية. وإذا لم يطابق المفتاح البيئة المختارة، يرفضه Paddle ولا يُحفظ شيء.
اطلب من MonstarX استخدامه
Section titled “اطلب من MonstarX استخدامه”| ما تكتبه | ما يحدث |
|---|---|
| «اقرأ منتجاتي في Paddle، وأنشئ صفحة أسعار بتلك الخطط وأسمائها.» | يعرض MonstarX منتجاتك، ثم ينشئ الصفحة منها في وضع الإنشاء. |
| «كم اشتراكًا نشطًا لديّ في Paddle، وعلى أي الخطط؟» | يتنقل بين صفحات اشتراكاتك ويلخّصها في المحادثة. |
| «اطّلع على آخر 20 معاملة لي في Paddle، وأخبرني بالمنتج الأكثر مبيعًا.» | يقرأ المعاملات ويجيب. |
الأمان والخصوصية
Section titled “الأمان والخصوصية”- يبقى لدى MonstarX. يُحفظ المفتاح مشفّرًا على خوادم MonstarX، ولا يُكتب أبدًا في شفرة تطبيقك ولا يُعطى لتطبيقك.
- للقراءة فقط. لا يطلب MonstarX من Paddle سوى القوائم. امنح المفتاح أذونات قراءة فقط، وعندها لا يستطيع حتى المفتاح المسرَّب أن يغيّر شيئًا في الفوترة.
- بيانات سرية. يتعامل MonstarX مع بيانات العملاء والفوترة على أنها خاصة، وعلى أنها معلومات، لا تعليمات ينفّذها.
- اقطع الاتصال متى شئت. انقر على قطع الاتصال بجانب Paddle في الخدمات السحابيةالسحابة، ثم أكّد عند ظهور السؤال هل تريد فصل Paddle عن هذا المشروع؟ عندها يحذف MonstarX المفتاح. وألغِ المفتاح في Paddle أيضًا إذا لم تعد بحاجة إليه.
معلومات مفيدة
Section titled “معلومات مفيدة”- ابدأ بـ بيئة الاختبار أثناء الإنشاء، ثم انتقل إلى البيئة الفعلية: اقطع الاتصال، ثم اربط مجددًا بمفتاح فعلي.
- عندما تنتهي صلاحية المفتاح في Paddle، تفشل طلبات MonstarX. أنشئ مفتاحًا جديدًا واربطه مجددًا.
- حساب Paddle واحد لكل مشروع في الوقت نفسه.
الأسئلة الشائعة
Section titled “الأسئلة الشائعة”هل يستطيع تطبيقي استقبال المدفوعات عبر Paddle بهذا الربط؟
لا. يتيح هذا الربط لوكيل الإنشاء في MonstarX قراءة بياناتك في Paddle. لاستقبال المدفوعات في تطبيقك، يوفّر MonstarX موصل Stripe. ولاستخدام مزوّد آخر، أضف مفاتيحه في الخدمات السحابية ← الأسرار واطلب من MonstarX إنشاء الميزة.
ما الأذونات التي يحتاج إليها المفتاح؟
product.read وcustomer.read وtransaction.read وsubscription.read. احذف أي إذن لا تريد أن يقرأ MonstarX بياناته، وستفشل تلك القوائم فحسب.
هل يستطيع MonstarX استرداد مبلغ أو إلغاء اشتراك؟
لا. يستطيع فقط عرض المنتجات والعملاء والمعاملات والاشتراكات.
لماذا رُفض مفتاحي؟
غالبًا لأن المفتاح يخص البيئة الأخرى: مفتاح pdl_sdbx_ يحتاج إلى بيئة الاختبار، ومفتاح pdl_live_ يحتاج إلى البيئة الفعلية. كما يُرفض المفتاح المنتهي الصلاحية أو الملغى.