مزوّدو الدفع
أعِدّ نسخ FastSpring وPayPal وTriple-A والتحويل البنكي في مركز التحكم — الحقول وبيانات الاعتماد والـWebhooks ونسخ الاختبار والإنتاج وربط الأسعار. ويبقى Stripe معطّلاً.
في هذه الصفحة
تعرض المدفوعات والفوترة › مزوّدو الدفع كل نسخ المزوّدين. والنسخة حساب واحد مُعدّ لدى مزوّد في بيئة واحدة (test أو live) — فمتجر FastSpring التجريبي ومتجر FastSpring الحقيقي نسختان. ويُولَّد نموذج كل نسخة من تعريف المزوّد نفسه، مع تسميات ومساعدة بالعربية والإنجليزية لكل حقل. ويتطلب الإعداد providers.manage وإعادة التحقق وسبباً.
ما يحتاج بيانات اعتماد التاجر#
| المزوّد | ما تحتاجه من حساب التاجر | الحالة |
|---|---|---|
| FastSpring | متجر (تجريبي و/أو حقيقي)، وبيانات اعتماد الـAPI، وWebhook وسرّ HMAC الخاص به، ومسار صفحة الدفع، ومنتج لكل سعر في HyoNova | مدعوم · جاهز للإعداد |
| PayPal | حساب PayPal Business، وتطبيق REST (معرّف العميل والسر)، وWebhook على ذلك التطبيق | مدعوم · جاهز للإعداد |
| Triple-A | حساب تاجر: معرّف عميل OAuth وسرّه، ومفتاح التاجر | مدعوم · جاهز للإعداد |
| التحويل البنكي | بيانات الحساب البنكي المستلِم | مدعوم · جاهز للإعداد |
| Stripe | لا شيء — أبقِه معطّلاً | معطّل |
لا يحتاج ملف المُصدِر وإعدادات الفوترة والتوجيه وربط الأسعار والخصومات أي بيانات اعتماد خارجية.
أعِدّ نسخة#
- افتح النسخة. اختر بطاقة المزوّد. يُنشئ HyoNova نسخة واحدة لكل مزوّد، معطّلة.
- اختر البيئة.
testلبيئة المزوّد التجريبية، وliveللمال الحقيقي. - املأ الإعدادات. قيم غير سرية مثل مسار صفحة الدفع أو مفتاح التاجر أو أسماء البنوك.
- أدخل بيانات الاعتماد. تُكتب الحقول السرية في مخزن الأسرار ولا تُعرض مجدداً؛ يعرض النموذج فقط هل كل منها مُعدّ. اترك الحقل السري فارغاً للإبقاء على القيمة المخزّنة.
- حدّد الدور والأولوية.
primaryللنسخة التي يستخدمها التوجيه، وsecondaryللنسخة البديلة، وavailableللمُعدّة غير المستخدمة. - فعّل واحفظ مع سبب. تفعيل نسخة
primaryيحوّل أي نسخةprimaryمفعّلة أخرى للمزوّد نفسه وفي البيئة نفسها إلىsecondary. - اختبر الاتصال. راجع حالة المزوّد. وكل حفظ يمسح نتيجة الاختبار السابقة.
لتشغيل الاختبار والإنتاج جنباً إلى جنب أضف نسخة (المزوّد، ومفتاح نسخة جديد، والبيئة، والسبب). تبدأ النسخة معطّلة.
FastSpring (البطاقة)#
| الحقل | مطلوب | القيمة |
|---|---|---|
| مسار صفحة الدفع | نعم | من FastSpring › Checkouts |
| اسم المتجر | لا | للعرض فقط |
| اسم مستخدم الـAPI | نعم (سري) | FastSpring › Developer Tools › APIs › API Credentials |
| كلمة مرور الـAPI | نعم (سري) | يعرضها FastSpring مرة واحدة |
| سر توقيع الـWebhook (HMAC) | نعم (سري) | FastSpring › Developer Tools › Webhooks › الـWebhook الخاص بك |
في FastSpring أنشئ Webhook بالعنوان المعروض على بطاقة النسخة (مضيف الـAPI للمنتج متبوعاً بـ /api/v1/webhooks/payments/fastspring)، وحدّد HMAC SHA256 Secret، وفعّل webhook expansion لتحمل الأحداث كائنات الاشتراك والطلب والحساب كاملة، واختر الأحداث المذكورة على البطاقة: order.completed، order.failed، subscription.activated، subscription.charge.completed، subscription.charge.failed، subscription.payment.overdue، subscription.updated، subscription.canceled، subscription.uncanceled، subscription.deactivated، subscription.paused، subscription.resumed، return.created، payoutEntry.created.
أعطِ كل نسخة سرّ Webhook خاصاً بها. فالـWebhooks تُفحص مقابل كل نسخ المزوّد؛ ومع سر مشترك قد يُطابَق حدث حقيقي مع النسخة التجريبية ثم يُتجاهل لعدم تطابق البيئة.
PayPal (رصيد PayPal أو البنك أو البطاقة داخل PayPal)#
| الحقل | مطلوب | القيمة |
|---|---|---|
| معرّف الـWebhook | نعم | developer.paypal.com › Apps & Credentials › تطبيقك › Webhooks |
| الاسم الظاهر في PayPal | لا | يظهر للمشتري في صفحة موافقة PayPal |
| معرّف العميل (Client ID) | نعم (سرّي) | developer.paypal.com › Apps & Credentials › تطبيق REST (تبويب Sandbox أو Live حسب البيئة) |
| السر (Secret) | نعم (سرّي) | سرّ تطبيق REST نفسه |
- أنشئ تطبيق REST. في developer.paypal.com › Apps & Credentials اختر تبويب Live للبيئة
live(أو Sandbox للبيئةtest) وأنشئ تطبيقاً من نوع Merchant، ثم انسخ معرّف العميل والسر. - أضف الـWebhook إلى التطبيق. العنوان: مضيف واجهة المنتج متبوعاً بـ
/api/v1/webhooks/payments/paypal(يظهر على بطاقة النسخة). الأحداث:BILLING.SUBSCRIPTION.ACTIVATED,BILLING.SUBSCRIPTION.UPDATED,BILLING.SUBSCRIPTION.RE-ACTIVATED,BILLING.SUBSCRIPTION.CANCELLED,BILLING.SUBSCRIPTION.SUSPENDED,BILLING.SUBSCRIPTION.EXPIRED,BILLING.SUBSCRIPTION.PAYMENT.FAILED,PAYMENT.SALE.COMPLETED,PAYMENT.SALE.REFUNDED,PAYMENT.SALE.REVERSED. ثم انسخ معرّف الـWebhook. - أعِدّ النسخة بالبيئة والقيم الثلاث وسبب، ثم اختبر الاتصال. يطلب الاختبار رمز وصول من PayPal، ومن دون معرّف Webhook تُبلغ النسخة بأن الإعداد غير مكتمل.
- أنشئ الخطط لدى المزوّد. تعرض بطاقة PayPal زر إنشاء الخطط لدى المزوّد متى اكتملت الحقول. ينشئ HyoNova منتجاً واحداً في PayPal لكل خطة في HyoNova، وخطة فوترة في PayPal لكل سعر فعّال ليس له ربط بعد، ثم يحفظ الروابط. وتُنشأ أسعار المقاعد مع دعم الكمية. لا تتغير الروابط الموجودة أبداً؛ أعِد التشغيل بعد إضافة أسعار.
- فعّل مسار
paypalفي توجيه الدفع.
يوافق المشتري على الاشتراك في PayPal، فيفعّله HyoNova من الحدث BILLING.SUBSCRIPTION.ACTIVATED ويسجّل كل خصم من PAYMENT.SALE.COMPLETED. ويُتحقق من كل Webhook بشهادة توقيع PayPal (تُجلب من مضيفات PayPal فقط) مقابل معرّف الـWebhook المُعدّ، وأي شيء آخر يُرفض بـ401. ولا يدعم PayPal التناسب: فتغيير الخطة في اشتراك PayPal يُجدوَل لنهاية الفترة المدفوعة. ويحتفظ اشتراك PayPal الملغى بالوصول حتى نهاية تلك الفترة، ثم يغلقه HyoNova بعدها بيوم لأن PayPal لا يرسل حدثاً ختامياً.
Triple-A (العملات الرقمية)#
| الحقل | مطلوب | القيمة |
|---|---|---|
| مفتاح التاجر | نعم | لوحة Triple-A › API keys |
| عملات الطلب | نعم | العملات الورقية التي تصدر بها HyoNova الفواتير، مثل USD,EUR |
| عملة التسوية | لا | للعلم |
| معرّف العميل | نعم (سري) | معرّف عميل OAuth |
| سر العميل | نعم (سري) | سر عميل OAuth |
| سر توقيع الإشعارات | نعم (سري) | سر عشوائي من 16 إلى 64 حرفاً تولّده أنت |
لا يُعدّ أي Webhook في لوحة Triple-A: يرسل HyoNova عنوان الإشعارات وسر التوقيع مع كل طلب دفع. وتستخدم البيئة test البيئة التجريبية لدى Triple-A.
التحويل البنكي (مبني في HyoNova)#
| الحقل | مطلوب | القيمة |
|---|---|---|
| اسم المستفيد | نعم | اسم صاحب الحساب كما هو لدى البنك |
| اسم البنك | نعم | البنك المستلِم |
| رمز SWIFT / BIC | لا | للتحويلات الدولية |
| العملات المقبولة | نعم | العملات التي يستقبلها الحساب |
| تعليمات الدفع | نعم | تُطبع على الفواتير؛ اطلب من الدافع ذكر مرجع الدفع |
| البنك الوسيط | لا | بيانات البنك المراسل |
| رقم IBAN / رقم الحساب | أحدهما (سري) | يُحفظ في مخزن الأسرار، ولا يُعرض إلا للشركة الدافعة وللمشغّلين |
لا توجد واجهة برمجية ولا Webhook: يؤكد مشغّلٌ الدفعات (راجع الاستردادات وتأكيد التحويلات).
Stripe (معطّل)#
Stripe تكامل مكتمل يبقى معطّلاً، بدور available، ودون توجيه. أبقِه كذلك ما لم يقرر HyoNova استخدامه. وإن أُعدّ يوماً فيجب أن يطابق مفتاحه السري بيئة النسخة (مفاتيح الاختبار لـ test، والمفاتيح الحقيقية لـ live).
ربط الأسعار والخصومات#
تُباع أسعار البطاقة عبر كتالوج المزوّد نفسه. فلكل سعر في HyoNova يُباع بالبطاقة أضف ربطاً لكل بيئة على السعر (المزوّد، والبيئة، ومرجع منتج المزوّد — مسار منتج FastSpring). وتُرفض عملية الدفع بالبطاقة لسعر غير مربوط، وتحتاج الترقيات أن يكون السعر الهدف مربوطاً أيضاً. وتحتاج رموز الخصم المستخدمة مع البطاقة ربط رمز القسيمة لدى المزوّد بالطريقة نفسها. ويتطلب الربط plans.manage.
الحالة#
| الميزة | الحالة | ملاحظات |
|---|---|---|
| مزوّدو الدفع والتوجيه | يتطلب إعداداًمبني، لكنه لا يعمل إلا بعد إعداد خدمة داعمة لمساحة عملك. | إعداد نُسخ مزوّدي الدفع واختبار اتصالها وتوجيه كل طريقة دفع إلى إحداها. |
هل كانت هذه الصفحة مفيدة؟
شكراً. لا تُجمع تقييمات الصفحات بعد، لذلك لم يُرسَل شيء. إذا وجدت نقصاً أو خطأً فراجع صفحة «الحصول على المساعدة».