تطبيق Shopify المخصص

نموذج التكامل

يستخدم تكامل Shopify تدفق تطبيق Shopify V2 Dev Dashboard. يوفر التاجر رمز Shopify Partner CLI مرة واحدة حتى يتمكن MakeCrypto من إنشاء تطبيق MakePay الثابت في Shopify Dev Dashboard باستخدام Shopify CLI. يقرأ MakeCrypto معرف العميل الذي تم إنشاؤه تلقائيًا. لا يزال Shopify يكشف سر العميل فقط داخل Dev Dashboard، لذا يقوم التاجر بنسخ هذا السر إلى MakeCrypto قبل النشر.

بعد نشر التطبيق وتثبيته، يقوم Shopify بتشغيل MakeCrypto باستخدام رمز مميز للجلسة. يقوم MakeCrypto بالتحقق من صحة هذا الرمز المميز باستخدام سر العميل واستبداله برمز API المميز للمسؤول غير المتصل بالإنترنت. يتم تشفير هذا الرمز المميز في حالة عدم النشاط واستخدامه لنفس سير عمل طلب MakePay كما كان من قبل: مزامنة الطلب، وروابط الدفع المستضافة، والملاحظات/العلامات، وwebhooks، والأتمتة الاختيارية المدفوعة الأجر.

لم يعد إعداد رمز وصول المشرف القديم API مدعومًا لاتصالات Shopify الجديدة. يجب إعادة الاتصال بالمتاجر الموجودة المرتبطة بالتدفق القديم من خلال إعداد V2.

تطبيق Shopify Dev Dashboard

يقوم MakeCrypto بإنشاء تطبيق Dev Dashboard تلقائيًا من رمز Partner CLI المميز. اسم التطبيق هو دائمًا MakePay. بعد الإنشاء، افتح إعدادات تطبيق MakePay في Dev Dashboard وانسخ سر العميل إلى MakeCrypto.

نطاقات API المطلوبة للمسؤول:

• read_customers
• write_customers
• read_products
• write_products
• read_orders
• write_orders
• read_draft_orders
• write_draft_orders
• read_themes
• write_themes

اسم التطبيق Shopify الذي تم نشره هو دائمًا MakePay.

إعداد MakeCrypto

افتح MakeCrypto، واختر الشركة، ثم انتقل إلى التجارة الإلكترونية > Shopify. إضافة متجر يحتوي على:

• سبيكة تخزين Shopify، وهي الجزء قبل .myshopify.com
• رمز Shopify Partner CLI لمرة واحدة
• Shopify سر العميل، الذي تم نسخه بعد إنشاء MakeCrypto للتطبيق
• اسم طريقة الدفع اليدوية

يتم تشفير رمز Partner CLI المميز حتى يقوم MakeCrypto بإنشاء التطبيق ونشره وتثبيته، ثم يتم مسحه. أثناء إنشاء التطبيق، يكتشف MakeCrypto أيضًا معرف مؤسسة Shopify Dev Dashboard من الرمز المميز. يتم تشفير سر العميل والرمز المميز للمسؤول غير المتصل API في حالة عدم النشاط.

لإنشاء رمز شريك CLI المميز، افتح إعدادات بوابة الشريك Shopify، وقم بالتمرير إلى CLI Token، وإدارة الرموز المميزة، وإنشاء رمز مميز جديد. ويمكن إبطاله بعد نجاح تثبيت تطبيق MakePay.

تثبيت وكتل checkout

عندما يظهر النشر على أنه منشور، افتح بوابة شريك Shopify، وحدد التطبيق، وانتقل إلى التوزيع > التوزيع المخصص، وقم بتثبيت التطبيق في المتجر. يقوم Shopify بإعادة التوجيه إلى MakeCrypto بعد التثبيت.

ثم افتح مشرف Shopify وانتقل إلى الإعدادات > الخروج > تخصيص. أضف كتلة MakePay إلى صفحة "شكرًا لك" وصفحة "حالة الطلب"، ثم احفظها.

تتحقق كتلة MakePay من رمز جلسة Shopify، وتطلب من MakeCrypto رابط الدفع المطابق، وتعرض زر الدفع الآن. إذا كان الأمر webhook لا يزال قيد المعالجة، فستنتظر الكتلة لفترة وجيزة بينما يقوم MakePay بتحضير الارتباط.

طريقة الدفع اليدوي

في مسؤول Shopify، افتح الإعدادات > المدفوعات > طرق الدفع اليدوية وقم بإنشاء طريقة دفع مخصصة. يجب أن يتطابق اسمه تمامًا مع اسم طريقة الدفع للاتصال MakeCrypto. اتصالات MakePay الجديدة الافتراضية هي:

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

عندما يختار العملاء هذه الطريقة، تقوم Shopify بإنشاء الطلب على أنه غير مدفوع. تقوم مزامنة MakePay بإرفاق checkout URL المستضاف بمذكرة الطلب ويمكنها إرسال بريد إلكتروني لطلب الدفع MakePay عند تمكينه.

خطافات الويب والمزامنة

يسجل MakeCrypto طلب الإنشاء/التحديث وإلغاء تثبيت التطبيق webhooks بعد اكتمال تثبيت V2. تقوم المزامنة المجدولة أيضًا بفحص المتاجر المتصلة مؤخرًا، لذلك لا يزال يتم التقاط الطلبات إذا تأخر تسليم Shopify webhook.

يتم التحقق من توقيعات Shopify webhook الواردة قبل قبول الحمولة. يتم الاحتفاظ بسجلات الطلب وwebhook على صفحة الاتصال لاستكشاف الأخطاء وإصلاحها.

رسم خرائط الحالة

عندما يكون طلب Shopify معلقًا من خلال طريقة الدفع اليدوية MakePay، تقوم MakePay بإنشاء رابط دفع MakePay أو إعادة استخدامه لإجمالي الطلب والبريد الإلكتروني للعميل.

عندما تصل دفعة MakePay إلى complete، تضيف MakePay ملاحظة/علامة مدفوعة وتستخدم Shopify Admin API orderMarkAsPaid عند تمكين العلامة المدفوعة تلقائيًا.

عندما تصل دفعة MakePay إلى failed أو expired أو cancelled، تضيف MakePay ملاحظة حالة وتترك طلب Shopify غير مدفوع لمراجعة التاجر.

استكشاف الأخطاء وإصلاحها

إذا فشل إنشاء التطبيق أو نشره، فتأكد من أن الرمز المميز لـ Partner CLI يبدأ بـ atkn_ ولم يتم إبطاله قبل بدء المهمة، ثم أعد المحاولة من MakeCrypto.

إذا فشل التثبيت، فتأكد من إنشاء تطبيق Shopify بواسطة نفس إعداد MakeCrypto ومن تكوين التطبيق MakeCrypto الذي تم إنشاؤه بواسطة URL بواسطة النشر.

إذا فشل اختبار الاتصال، فتأكد من أن التطبيق يحتوي على جميع النطاقات المطلوبة وأعد تثبيت التطبيق أو إعادة نشره.

إذا ظلت كتلة الدفع الآن في حالة الإعداد، فتأكد من تثبيت كتلة MakePay على صفحتي checkout وأن أمر Shopify يستخدم اسم طريقة الدفع اليدوي الدقيق.