Shopify
اقبل كي-نت ومدى والبطاقات وApple Pay في متجرك على Shopify عبر تطبيق تيرا باي.
لم يُطلق بعد
اكتمل تطوير تطبيق تيرا باي لمنصة Shopify، وهو بانتظار مراجعة Shopify لتطبيقات الدفع، لذا لم يُتح بعد في متجر تطبيقات Shopify. تشرح هذه الصفحة طريقة الإعداد لتستعد مسبقًا. راسل support@teyra.co للانضمام إلى قائمة الوصول المبكر.
يضيف تطبيق تيرا باي لـ Shopify تيرا باي كخيار دفع في صفحة الدفع بمتجرك. يُوجَّه العملاء إلى صفحة الدفع المستضافة في تيرا باي ليدفعوا بكي-نت ومدى والبطاقات وApple Pay وغيرها من الوسائل المفعّلة، ثم يعودون إلى صفحة تأكيد الطلب في Shopify. يتحقق التطبيق من كل عملية دفع عبر واجهة تيرا باي البرمجية قبل أن يعلّم Shopify الطلب كمدفوع. تظهر المدفوعات التي تتم عبر التطبيق في لوحة تحكم تيرا باي مع القيمة shopify في channel، ومعرّف الدفع في Shopify في reference.
قبل أن تبدأ
- حساب في تيرا باي. وضع الاختبار يعمل فورًا، أما المدفوعات الحية فتتطلب حسابًا معتمدًا.
- متجر Shopify بخطة تدعم تطبيقات الدفع الخارجية، وصلاحيات موظف تسمح بتثبيت التطبيقات.
- أن تكون عملة متجرك من العملات التي تدعمها تيرا باي (
KWDوSARوAEDوQARوBHDوOMRوJODوEGP). - أن تكون طريقة تحصيل الدفعات في Shopify تلقائية (Settings ← Payments ← Payment capture method). تخصم تيرا باي المبلغ من العميل عند الدفع، والتحصيل اليدوي غير مدعوم.
الإعداد
ثبّت التطبيق
ابحث عن Teyra Pay في متجر تطبيقات Shopify واضغط Install، ثم وافق على الصلاحيات التي يطلبها التطبيق. يفتح Shopify بعدها صفحة Connect Teyra Pay في التطبيق.
اربط حسابك في تيرا باي
ألصق مفتاح API سريًا من المطورون ← مفاتيح API في لوحة تحكم تيرا باي. ابدأ بمفتاح اختبار (sk_test_…). يتحقق التطبيق من المفتاح لدى تيرا باي قبل حفظه.
اترك حقل Webhook signing secret فارغًا، فالتطبيق يسجّل نقطة الـ Webhook الخاصة به في حسابك تلقائيًا (ستجدها في المطورون ← Webhooks). املأه فقط إذا أنشأت النقطة بنفسك بالرابط الظاهر في الصفحة.
اضغط Save and continue. يبلغ التطبيق Shopify بأنه جاهز ويعيدك إلى إعدادات الدفع في Shopify.
فعّل وسيلة الدفع
في لوحة إدارة Shopify افتح Settings ← Payments، وابحث عن Teyra Pay ضمن وسائل الدفع الإضافية وفعّلها. شغّل وضع الاختبار ما دمت تستخدم مفتاح اختبار.
يجب أن يطابق وضع الاختبار مفتاحك
وضع الاختبار في Shopify يعمل مع مفتاح اختبار (sk_test_…) فقط، والدفع الحي يعمل مع مفتاح حي (sk_live_…) فقط. إذا لم يتطابقا ترفض تيرا باي الدفع عند الشراء، حتى لا تُعلَّم طلبات حقيقية كمدفوعة بمدفوعات تجريبية.
نفّذ طلبًا تجريبيًا
أنشئ طلبًا في متجرك، واختر تيرا باي عند الدفع، وادفع ببطاقة اختبار في صفحة الدفع التجريبية. تأكد أن الطلب أصبح Paid في Shopify وأنه ظهر في لوحة تحكم تيرا باي.
انتقل إلى الوضع الحي
بعد اعتماد حسابك في تيرا باي، افتح التطبيق من Settings ← Payments ← Teyra Pay، واحفظ مفتاحًا حيًا (sk_live_…)، ثم أوقف وضع الاختبار في Shopify.
ما يراه العملاء والطلبات
| عملية الدفع في تيرا باي | عند الدفع | الطلب في Shopify |
|---|---|---|
succeeded | العودة إلى صفحة تأكيد الطلب | Paid |
failed | العودة إلى صفحة الدفع مع رسالة رفض الدفع، ويمكن للعميل اختيار وسيلة أخرى | لا يُنشأ طلب |
processing | العودة إلى Shopify | Pending حتى تؤكد تيرا باي، ثم Paid (أو يُرفض الدفع) |
canceled أو expired أو غادر العميل صفحة الدفع | العودة إلى صفحة الدفع للمحاولة مجددًا | لا يُنشأ طلب |
الاسترداد
الاستردادات التي تنفّذها من صفحة الطلب في Shopify تُرسل إلى تيرا باي تلقائيًا، كاملة أو جزئية. يعرض Shopify الاسترداد كمعلّق حتى تؤكده تيرا باي، وعادةً يحدث ذلك فورًا. إذا تعذّر الاسترداد (مثلًا إذا تجاوز المبلغ المتبقي) يعرضه Shopify كاسترداد فاشل مع السبب. تظهر الاستردادات أيضًا في لوحة تحكم تيرا باي.
إلغاء التثبيت
يؤدي إلغاء تثبيت التطبيق إلى إزالة تيرا باي من صفحة الدفع، ولن تتمكن بعدها من استرداد طلبات تيرا باي السابقة من Shopify، فاستردها من لوحة تحكم تيرا باي. يحذف التطبيق البيانات التي خزّنها عن متجرك بعد 48 ساعة من إلغاء التثبيت، وتبقى مدفوعاتك في حسابك لدى تيرا باي.
حل المشكلات
| المشكلة | ما الذي تتحقق منه |
|---|---|
| لا تظهر تيرا باي في صفحة الدفع | أن وسيلة الدفع مفعّلة في Shopify وأن عملة المتجر مدعومة. |
| تظهر رسالة بتعذّر معالجة الدفع مباشرةً عند الشراء | أن وضع الاختبار في Shopify يطابق مفتاحك (مفتاح اختبار ↔ وضع اختبار)، وأن تحصيل الدفعات تلقائي، وأن المفتاح مربوط في التطبيق. |
| تبقى الطلبات Pending | حالة عملية الدفع في لوحة تحكم تيرا باي، وعمليات تسليم الـ Webhook الخاصة بالتطبيق في المطورون ← Webhooks. لا تحذف النقطة التي سجّلها التطبيق، وإن حذفتها فاحفظ مفتاحك مجددًا في التطبيق. |
تفشل المدفوعات الحية بالخطأ merchant_not_active | حسابك في تيرا باي لم يُعتمد بعد. استخدم مفتاح اختبار. |