المتجر
إضافة v1.0.31

Card readers

نظرة عامة

يتصل بـ Square. يضع الصندوق المبلغ على جهاز Square Terminal عند طاولتك. يقرّب الزبون بطاقته أو يُدخلها، ويمكنه إضافة بقشيش. يرى الموظفون ما تم تحصيله، مع إظهار البقشيش على حدة، ونوع البطاقة وآخر أربعة أرقام منها. وتنتهي عملية الدفع إما محصَّلة، وإما ملغاة مع السبب الذي تذكره Square. متجرك هو البائع: حسابك في Square ورمز الوصول والمال كلها لك، وAdminium ليس طرفًا في أي دفعة. تقرأ البطاقة الجهاز Terminal وتذهب إلى Square، فلا يصل أي رقم بطاقة إلى خادمك. والمبلغ المسترد من Adminium يعود عبر Square. أما دفعة Interac (كندا) فلا تُسترد إلا على جهاز Terminal، ولذلك يرفضها Adminium. وما يُجرى في Square Dashboard من مبالغ مستردة ونزاعات يقرؤه Adminium أيضًا. يُعدّ من صفحة المدفوعات في Studio برمز وصول من حسابك أنت في Square: رمز بيئة الاختبار (sandbox) للدفعات التجريبية، ورمز بيئة الإنتاج للدفعات الحقيقية. وتقرن كل قارئ في المدفوعات، قسم Card readers، برمز جهاز تكتبه على Terminal. يسأل Adminium القارئات من الخادم، فيعمل حتى خادم بلا عنوان عام. تحتفظ Square بعملية الدفع على Terminal مدة 30 يومًا، ويحتفظ Adminium بنسخته الخاصة مما تم تحصيله. ولا تُتاح Square في ألمانيا؛ استخدم هناك قارئ Stripe عبر Card payments بدلًا منها. ليست له شاشات خاصة به ولا جداول خاصة به، ويعمل مع كل تطبيق. ويحتاج إلى Adminium 0.3.60 أو أحدث.

بماذا ترتبط

وهذه لا ترتبط بتطبيق بعينه. تعمل داخل Adminium نفسه، وفي أي تطبيق يستضيف الإضافات.

ما الذي يتيحه لها الربط

يحتاج إلى رمز وصول من حسابك أنت في Square: رمز بيئة الاختبار للدفعات التجريبية ورمز بيئة الإنتاج للدفعات الحقيقية. ويُحفظ كلاهما مشفّرًا على خادمك، ولا يصل أي جزء من الإضافة إلى المتصفح أبدًا. ويفتح الرمز الحساب كله في Square، لأن Square لا تقدّم رمزًا أضيق لتطبيق خاص بك؛ فاحفظه في Studio وحدها، وأنشئ رمزًا جديدًا في Square Developer Console إن تسرّب يومًا. ولا يأتي بجداول خاصة به. ويجوز لنصفه الخادم نداء العنوانين أدناه، أحدهما للاختبار والآخر للإنتاج، ولا شيء غيرهما.

العناوين التي يجوز لشيفرتها على الخادم الوصول إليها

  • connect.squareupsandbox.com
  • connect.squareup.com

هذه القائمة هي القائمة كاملةً: أي اتصال بعنوان آخر يُرفض ويُسجَّل.

ما يلزم للربط

مفتاح API

ما الذي تضيفه

أين تظهر ٤
  • في Adminium: بطاقته في صفحة المدفوعات في Studio، حيث تلصق رمز الوصول لبيئة الاختبار أو للإنتاج، ويخبرك «تحقّق» لمن يعود حساب Square هذا
  • في Adminium: المدفوعات، قسم Card readers، حيث يمنح «اقرن قارئًا» القارئ اسمًا ويعرض رمز جهاز تكتبه على Square Terminal
  • عند الصندوق: يذهب المبلغ إلى Square Terminal، ويقرّب الزبون بطاقته أو يُدخلها ويمكنه إضافة بقشيش، ويعرض الصندوق ما تم تحصيله، مع البقشيش على حدة ونوع البطاقة وآخر أربعة أرقام؛ وتنتهي عملية الدفع إما محصَّلة وإما ملغاة مع السبب الذي تذكره Square
  • المبالغ المستردة: المبلغ المسترد من Adminium يعود عبر Square، ما عدا دفعة Interac (كندا) فلا تُسترد إلا على Terminal؛ وما يُجرى في Square Dashboard من مبالغ مستردة ونزاعات يظهر في المدفوعات، قسم النشاط
الجداول التي تجلبها ٠

لا شيء — لا تجلب جداول خاصة بها.

الإعدادات التي تضبطها ١
  • رمز الوصول

إذا أوقفتها

فصل الإضافة يزيل واجهاتها. ولا يُسقط أبدًا الجداول التي أنشأتها، ولا يحذف الملفات التي كتبتها، ولا يزيل السجلات التي أضافتها — كل ما كتبته يبقى في قاعدة بياناتك. بيانات الاعتماد التي أُعطيت لها تُلغى وتُحذف معها.

ما يبقى

تبقى كل دفعة جرى تحصيلها مسجَّلة عند سجلها، مع البقشيش على حدة ونوع البطاقة وآخر أربعة أرقام. ويحتفظ Adminium بنسخته الخاصة، فتبقى الدفعة مقروءة كاملة بعد الأيام الثلاثين التي تحتفظ فيها Square بعملية الدفع على Terminal. ولم تأتِ بجداول خاصة بها. ويبقى حسابك في Square والمال فيه كما هما.

ما يزول

تختفي Card readers من صفحة المدفوعات في Studio، ولا يستطيع الصندوق بعد ذلك وضع مبلغ على Terminal. ولا يُقرأ بعد ذلك ما يُجرى في Square Dashboard من مبالغ مستردة ونزاعات. ولا تملك Square طريقة لفك اقتران Terminal من خارجه، فسجّل الخروج على كل جهاز Terminal من الجهاز نفسه.

عن العرض التوضيحي

لا يُجري أي عرض توضيحي على هذا الموقع اتصالًا حقيقيًا بخدمة جهة أخرى. كل إضافة تأتي بناقل بديل يجيب من بيانات مدمجة، وهو مُفعَّل منذ البداية. أما بيانات الاعتماد الحقيقية فهي خيار الاستضافة الذاتية، وموصوفة في ملف README الخاص بالإضافة.

كيف تشغّلها لا يتضمنه أي من العروض التجريبية على هذا الموقع. في Adminium الخاص بك (0.3.60 أو أحدث)، ثبّت Card readers من الإضافات، وافتح صفحة المدفوعات في Studio، ووصّله برمز وصول sandbox من حسابك أنت في Square لتجرّب دفعات الاختبار قبل أن تستخدم رمز الإنتاج. وتُقرَن القارئات في المدفوعات، قسم Card readers.

Adminium ليست تابعة لهذه الشركة.