Card payments
نظرة عامة
يتصل بـ Stripe. يدفع عملاؤك فاتورة، أو أي سجل يحمل مبلغًا، بالبطاقة وبالطرق الأخرى التي يتيحها حسابك في Stripe، على صفحة Stripe. وتُسجَّل الدفعة في Adminium على السجل لحظة يؤكد Stripe أنها تمت، ومرة واحدة فقط، سواء وجدها الـ Webhook أولًا أو الفحص الذي يجريه Adminium نفسه. البائع هو متجرك: يفتح حسابه الخاص في Stripe وينشئ مفتاحه الخاص، ويذهب المال من العميل مباشرة إلى ذلك الحساب. لا يملك Adminium أي حساب دفع ولا مفتاحًا خاصًا به ولا أي مال، ولا يعالج شيئًا؛ يكتب العملاء بيانات بطاقاتهم على صفحة Stripe فقط، فلا يصل أي رقم بطاقة إلى خادمك. يُعدّ من صفحة المدفوعات في Studio، بوضع الاختبار أولًا: مفتاح مقيّد وWebhook لكل وضع، ثم دفعة اختبار ببطاقة الاختبار من Stripe، لا تكتب شيئًا في جداولك. تُردّ المبالغ من لوحة الدفع في السجل أو من النشاط، ويُسجَّل أيضًا الاسترداد الذي يُجرى في لوحة تحكم Stripe. والدفعة المتنازع عليها تُعلَّم وتُتابَع حتى ينتهي النزاع؛ وتردّ عليه في لوحة تحكم Stripe. لا يحفظ البطاقات ولا يتولى الاشتراكات ولا يضع نموذج الدفع في صفحتك أنت، ولا تُقبل بعدُ عبر الإنترنت المدفوعات بعملات BHD وJOD وKWD وOMR وTND وUGX. ويحتاج إلى Adminium 0.3.33 أو أحدث على عنوان https عام.
بماذا ترتبط
وهذه لا ترتبط بتطبيق بعينه. تعمل داخل Adminium نفسه، وفي أي تطبيق يستضيف الإضافات.
ما الذي يتيحه لها الربط
يحتاج إلى شيئين من حسابك أنت في Stripe، مرة لوضع الاختبار ومرة للوضع الحقيقي: مفتاح مقيّد (rk_…؛ ويُرفض المفتاح السري) وسر توقيع الـ Webhook. ويُحفظ كلاهما مشفّرًا على خادمك، لكل وضع على حدة، ولا يصل أي جزء من الإضافة إلى المتصفح أبدًا. ولا يُعطى المفتاح إلا الصلاحيات التي تذكرها بطاقة الإعداد: بدء دفعة وإنهاء دفعة لم تعد مطلوبة، وقراءة كيف انتهت والمبلغ المُحصَّل، وإصدار المبالغ المستردة (وهذه الصلاحية في Stripe تسمح أيضًا بتعديل عمليات الخصم)، وقراءة الأحداث والنزاعات، وطرق الدفع التي فعّلتها، والحساب الذي ينتمي إليه المفتاح. ولا تُكتب الدفعات إلا على صفوف الجداول التي تختارها في «ما يمكن دفعه». ويجوز لنصفه الخادم نداء العنوانين أدناه ولا شيء غيرهما.
العناوين التي يجوز لشيفرتها على الخادم الوصول إليها
- api.stripe.com
- checkout.stripe.com
هذه القائمة هي القائمة كاملةً: أي اتصال بعنوان آخر يُرفض ويُسجَّل.
ما يلزم للربط
مفتاح API
ما الذي تضيفه
أين تظهر ٣
- في Adminium: بطاقته في تبويب الإعداد بصفحة المدفوعات في Studio، مع قائمة الخطوات: مفتاح الاختبار، Webhook الاختبار، إرسال دفعة اختبار، المفتاح الحقيقي، Webhook الحقيقي، وصلت أول دفعة حقيقية
- في صفحة الدفع الخاصة بالسجل: طرق الدفع المفعّلة في حسابك في Stripe، وكل منها ينقل العميل إلى صفحة Stripe
- في لوحة الدفع في السجل وفي النشاط: الدفعات التي حصّلها، مع المبالغ المستردة والنزاعات الخاصة بها
الجداول التي تجلبها ٠
لا شيء — لا تجلب جداول خاصة بها.
الإعدادات التي تضبطها ٢
- المفتاح المقيّد
- سر توقيع Webhook
إذا أوقفتها
فصل الإضافة يزيل واجهاتها. ولا يُسقط أبدًا الجداول التي أنشأتها، ولا يحذف الملفات التي كتبتها، ولا يزيل السجلات التي أضافتها — كل ما كتبته يبقى في قاعدة بياناتك. بيانات الاعتماد التي أُعطيت لها تُلغى وتُحذف معها.
ما يبقى
تبقى كل دفعة وكل استرداد سُجّل من قبل: على سجله، وفي النشاط، وفي جدول المدفوعات الخاص بك إن كنت اخترت واحدًا. لم يجلب أي جداول خاصة به. وطرق الدفع اليدوية وتسجيل دفعة يدويًا تعمل كما كانت، وحسابك في Stripe والمال الذي فيه لا يُمسّان.
ما يزول
يتيح «فصل» في بطاقته طريقين. إيقاف المدفوعات الجديدة: لا تبدأ أي دفعة جديدة، ويحتفظ Adminium بالمفتاح لإتمام المدفوعات التي ما زالت في الانتظار ولإصدار المبالغ المستردة. إزالة المفاتيح: تُحذف المفاتيح من هذا الخادم، ولا يعود Adminium قادرًا على إتمام دفعة أو إصدار استرداد عبر Stripe. وإزالة المفتاح هنا لا تُلغيه لدى Stripe؛ للأمان، جدِّده من لوحة تحكم Stripe.
عن العرض التوضيحي
لا يُجري أي عرض توضيحي على هذا الموقع اتصالًا حقيقيًا بخدمة جهة أخرى. كل إضافة تأتي بناقل بديل يجيب من بيانات مدمجة، وهو مُفعَّل منذ البداية. أما بيانات الاعتماد الحقيقية فهي خيار الاستضافة الذاتية، وموصوفة في ملف README الخاص بالإضافة.
كيف تشغّلها لا يتضمنه أي من العروض التجريبية على هذا الموقع. في Adminium الخاص بك (0.3.33 أو أحدث)، ثبّت Card payments من الإضافات، وافتح صفحة المدفوعات في Studio، واتبع قائمة الخطوات في بطاقته، بوضع الاختبار أولًا. وكل صفحة دفع تجريبية تعرض أيضًا الخدمة التجريبية التي لا تحتاج إلى أي حساب، فتستطيع تجربة المسار كله، بما فيه الاسترداد، قبل أن توصل أي شيء.
Adminium ليست تابعة لهذه الشركة.