Wallet payments
نظرة عامة
يتصل بـ PayPal. يدفع عملاؤك فاتورة، أو أي سجل يحمل مبلغًا، بحسابهم في PayPal على صفحة PayPal. يوافق العميل على الدفعة هناك ثم يعود؛ وعندها يُحصّل Adminium المال (ويسمّي PayPal ذلك «capture») ويسجّله على السجل مرة واحدة. وإن لم يعد العميل أبدًا، حصّله الـ Webhook أو الفحص الذي يجريه Adminium نفسه بدلًا منه، والدفعة التي يحتجزها PayPal تظهر «قيد المعالجة» مع السبب الذي يذكره PayPal. البائع هو متجرك: يحتاج إلى حساب أعمال خاص به في PayPal (PayPal Business)، ويذهب المال من العميل مباشرة إلى ذلك الحساب. لا يملك Adminium أي حساب دفع ولا بيانات اعتماد خاصة به ولا أي مال، ولا يعالج شيئًا؛ ولا يصل إلى خادمك شيء مما يكتبه العميل على صفحة PayPal. يُعدّ من صفحة المدفوعات في Studio، في بيئة Sandbox أولًا: تطبيق REST بمعرّف العميل والسر، وWebhook لكل وضع، ثم دفعة اختبار بصفة مشترٍ في Sandbox، لا تكتب شيئًا في جداولك. تُردّ المبالغ من لوحة الدفع في السجل أو من النشاط، ويُسجَّل أيضًا الاسترداد الذي يُجرى في لوحة تحكم PayPal. والدفعة المتنازع عليها تُتابَع حتى يحسم PayPal النزاع؛ وتردّ عليه في لوحة تحكم PayPal. يقدّم طريقة دفع واحدة، هي حساب العميل في PayPal، ويقبل العملات الأربع والعشرين التي يقبلها PayPal، على أن تكون HUF وJPY وTWD بوحدات كاملة فقط. ويحتاج إلى Adminium 0.3.33 أو أحدث على عنوان https عام على المنفذ 443، فـ PayPal لا يرسل الـ Webhook إلا إليه.
بماذا ترتبط
وهذه لا ترتبط بتطبيق بعينه. تعمل داخل Adminium نفسه، وفي أي تطبيق يستضيف الإضافات.
ما الذي يتيحه لها الربط
يحتاج إلى تطبيق REST من حساب الأعمال الخاص بك في PayPal (PayPal Business)، مرة لبيئة Sandbox ومرة للوضع الحقيقي: معرّف العميل الخاص به، وسرّه، ومعرّف الـ Webhook الخاص به. والسر يفتح حساب PayPal كله — فليس لدى PayPal مفتاح أضيق صلاحية — لذلك تُحفظ الثلاثة مشفّرة على خادمك، لكل وضع على حدة، ولا يصل أي جزء من الإضافة إلى المتصفح أبدًا. ويُتحقق من توقيع كل Webhook على خادمك بمعرّف الـ Webhook. ولا تُكتب الدفعات إلا على صفوف الجداول التي تختارها في «ما يمكن دفعه». ويجوز لنصفه الخادم نداء العناوين الستة أدناه ولا شيء غيرها.
العناوين التي يجوز لشيفرتها على الخادم الوصول إليها
- api-m.paypal.com
- api-m.sandbox.paypal.com
- www.paypal.com
- www.sandbox.paypal.com
- api.paypal.com
- api.sandbox.paypal.com
هذه القائمة هي القائمة كاملةً: أي اتصال بعنوان آخر يُرفض ويُسجَّل.
ما يلزم للربط
مفتاح API
ما الذي تضيفه
أين تظهر ٣
- في Adminium: بطاقته في تبويب الإعداد بصفحة المدفوعات في Studio، مع قائمة الخطوات: تطبيق Sandbox، Webhook الـ Sandbox، إرسال دفعة اختبار، التطبيق الحقيقي، Webhook الحقيقي، وصلت أول دفعة حقيقية
- في صفحة الدفع الخاصة بالسجل: «الدفع عبر PayPal»، الذي ينقل العميل إلى صفحة PayPal
- في لوحة الدفع في السجل وفي النشاط: الدفعات التي حصّلها، مع المبالغ المستردة والنزاعات الخاصة بها
الجداول التي تجلبها ٠
لا شيء — لا تجلب جداول خاصة بها.
الإعدادات التي تضبطها ٣
- معرّف العميل
- السر
- معرّف Webhook
إذا أوقفتها
فصل الإضافة يزيل واجهاتها. ولا يُسقط أبدًا الجداول التي أنشأتها، ولا يحذف الملفات التي كتبتها، ولا يزيل السجلات التي أضافتها — كل ما كتبته يبقى في قاعدة بياناتك. بيانات الاعتماد التي أُعطيت لها تُلغى وتُحذف معها.
ما يبقى
تبقى كل دفعة وكل استرداد سُجّل من قبل: على سجله، وفي النشاط، وفي جدول المدفوعات الخاص بك إن كنت اخترت واحدًا. لم يجلب أي جداول خاصة به. وطرق الدفع اليدوية وتسجيل دفعة يدويًا تعمل كما كانت، وحسابك في PayPal والمال الذي فيه لا يُمسّان.
ما يزول
يتيح «فصل» في بطاقته طريقين. إيقاف المدفوعات الجديدة: لا تبدأ أي دفعة جديدة، ويحتفظ Adminium ببيانات الاعتماد لإتمام المدفوعات التي ما زالت في الانتظار ولإصدار المبالغ المستردة. إزالة المفاتيح: تُحذف بيانات الاعتماد من هذا الخادم، ولا يعود Adminium قادرًا على إتمام دفعة أو إصدار استرداد عبر PayPal. وإزالتها هنا لا تُلغيها لدى PayPal؛ للأمان، أنشئ سرًّا جديدًا للتطبيق في لوحة تحكم المطوّرين لدى PayPal.
عن العرض التوضيحي
لا يُجري أي عرض توضيحي على هذا الموقع اتصالًا حقيقيًا بخدمة جهة أخرى. كل إضافة تأتي بناقل بديل يجيب من بيانات مدمجة، وهو مُفعَّل منذ البداية. أما بيانات الاعتماد الحقيقية فهي خيار الاستضافة الذاتية، وموصوفة في ملف README الخاص بالإضافة.
كيف تشغّلها لا يتضمنه أي من العروض التجريبية على هذا الموقع. في Adminium الخاص بك (0.3.33 أو أحدث)، ثبّت Wallet payments من الإضافات، وافتح صفحة المدفوعات في Studio، واتبع قائمة الخطوات في بطاقته، في بيئة Sandbox أولًا. وكل صفحة دفع تجريبية تعرض أيضًا الخدمة التجريبية التي لا تحتاج إلى أي حساب، فتستطيع تجربة المسار كله، بما فيه الاسترداد، قبل أن توصل أي شيء.
Adminium ليست تابعة لهذه الشركة.