تحضير أنظمتك لـ Shop Cash

قبل إطلاق مسارات عمل Shop Cash مع الأنظمة التابعة لجهات خارجية، تأكد من المتطلبات التالية:

• يمكن لأنظمة تخطيط موارد المؤسسات (ERP) وإدارة الطلبات (OMS) وتنفيذ الطلبات والمحاسبة والإرجاع لديك قبول أكثر من طريقة دفع واحدة للطلب الواحد.
• يتم تعيين shop_cash كطريقة دفع حيثما تتوفر قيم البوابة.
• لا يُعامل Shop Cash كخصم أو بطاقة هدية أو رصيد متجر.
• تُخزن قيمة التفويض كسلسلة نصية مبهمة متغيرة الطول لا تقل عن 1024 حرفًا. وإذا أمكن، استخدم حقل نص غير مقيد.
• يتم تحديد عمليات التحصيل والإلغاء والاسترداد بواسطة مُعرّف المعاملة بدلاً من قيمة التفويض. تستخدم عمليات التحصيل والإلغاء في Admin API parentTransactionId، بينما تستخدم عمليات الاسترداد parentId.
• لا تقوم أنظمتك بتحليل، أو فك تشفير، أو تسوية، أو تشفير، أو اقتطاع قيم تفويض Shop Cash.
• يمكن لأنظمتك التعامل مع الدفعات المُجمّعة، حيث يمكن لصف shop_cash_credit واحد أن يمثل طلبات متعددة.
• لا يفترض مسار عمل تسوية الحسابات لديك أن الطلب الواحد يساوي صف دفعة واحدًا.
• يمكن لمسار عمل تسوية الحسابات لديك التعامل مع تسوية الجزء الخاص بـ Shop Cash والجزء الخاص بالبطاقة أو تقسيط Shop Pay في دفعات مختلفة.
• يمكن لمسار عمل الاسترداد معالجة عمليات الاسترداد الجزئية عبر البطاقة أو تقسيط Shop Pay وShop Cash.
• يمكن لتطبيقات الاسترداد استرداد معاملة تحصيل Shop Cash، وليس معاملة التفويض.
• إذا قمت بتشغيل Shop Campaigns قبل يناير 2026، فإن مسار العمل المالي لديك يتعامل مع shop_cash_campaign_billing_debit السابقة وصفوف فوترة الحملة ذات الصلة بشكل منفصل عن إيرادات الطلبات. وبدلاً من ذلك، تُفرض رسوم تكاليف الحملة بدءًا من يناير 2026 فصاعدًا على فاتورة Shopify الخاصة بك.

توجد قيود على اختبار Shop Cash لأنه يعتمد على حسابات المشترين في Shop، وأرصدة Shop Cash، وShopify Payments، والبنية التحتية لتسوية Shop Cash.

الطريقة الأكثر موثوقية للتحقق من صحة دمج المؤسسة من البداية إلى النهاية هي تقديم طلب إنتاج منخفض القيمة من خلال Shop، ثم استرداد قيمته. يُنشئ هذا معاملات طلبات شبيهة بالإنتاج، وبيانات تحصيل، ونشاط دفعات، ومعاملات استرداد، ونشاط خصم استرداد يتدفق عبر لوحة إدارة متجر Shopify، وبيانات Admin API، وعمليات تصدير الدفعات، وبيانات API الدفعات.

يمكن للمتاجر قيد التطوير المساعدة في التحقق من أشكال بعض حقول واجهة برمجة التطبيقات (API) ومنطق التعيين، لكنها لا تُجري بشكل موثوق تدفق الدفع، ورصيد المشتري، والتسوية الكاملة الصادرة من Shop. لا يُنشئ وضع الاختبار وبوابة الدفع الوهمية (Bogus) صفوف دفعات Shop Cash شبيهة بالإنتاج لأنها لا تستخدم تدفق تسوية Shopify Payments مباشرًا.

يمكنك عادةً اختبار مسارات العمل التالية باستخدام طلب إنتاج منخفض القيمة يتم إجراؤه من Shop:

• استيعاب الطلبات لطلب متعدد طرق الدفع يتضمن Shop Cash وShop Pay أو تقسيط Shop Pay.
• التعيين لنظام تخطيط موارد المؤسسات (ERP) أو نظام إدارة الطلبات (OMS) لـ shop_cash.
• تخزين قيمة تفويض Shop Cash الكاملة.
• عمليات الاسترداد الكاملة والجزئية للطلب.
• استيعاب نشاط الدفعة shop_cash_refund_debit.
• تسوية الدفعات لأرصدة Shop Cash الدائنة.
• سلوك الطلب المسبق أو التحصيل عند تنفيذ الطلب، إذا كان متجرك يستخدم التحصيل المتأخر.
• معالجة تطبيق الإرجاع للطلبات التي تحتوي على أكثر من طريقة دفع واحدة.

عند إجراء الاختبار في بيئة الإنتاج، استخدم طلبًا منخفض القيمة واتبع إجراءات الطلبات الاختبارية والاسترداد الداخلية الخاصة بمتجرك.

تواصل مع دعم Shopify إذا كنت بحاجة إلى مساعدة في أي من السيناريوهات التالية:

• مراجعة توفر Shop Cash لسوق يتم الطرح التدريجي فيها.
• التحقيق في فشل عملية تحصيل أو استرداد Shop Cash.
• التحقيق في معاملة دفعة Shop Cash مفقودة بعد وتيرة الدفعات المعتادة بالإضافة إلى دورة دفعات إضافية واحدة.
• مراجعة إمكانية إعادة تفويض تفويض Shop Cash ملغى أو منتهي الصلاحية.
• التخطيط لإطلاق مسار عمل معقد لنظام تخطيط موارد المؤسسات (ERP)، أو نظام إدارة الطلبات (OMS)، أو الطلبات المسبقة، أو تنفيذ الطلبات.

قبل توسيع نطاق حجم طلبات Shop Cash، أكمل الفحوصات التالية:

• تم نشر والتحقق من تعيين طريقة الدفع لنظام تخطيط موارد المؤسسات (ERP) ونظام إدارة الطلبات (OMS) لـ shop_cash.
• تم استيعاب عينة من طلب Shop Cash من البداية إلى النهاية، بما في ذلك معاملات التفويض والتحصيل.
• تمت تسوية عينة من رصيد دائن لدفعة Shop Cash مع الطلب أو الطلبات المصدر.
• تمت معالجة عينة من استرداد Shop Cash وتسويتها مع خصم الاسترداد.
• يتم دعم صفوف دفعات Shop Cash المُجمّعة أو أن لها عملية تسوية يدوية.
• يُفهم تخصيص الاسترداد الجزئي من قِبل فرق الدعم والمالية لديك.
• تم التحقق من سلوك الطلب المسبق والتحصيل اليدوي والتحصيل عند تنفيذ الطلب، إن أمكن.
• يمكن لتطبيقات الإرجاع تحديد معاملة تحصيل Shop Cash الصحيحة واستردادها.
• تعرف فرق الدعم والمالية الفرق بين رصيد Shop Cash للعميل، وعروض Shop، ونشاط فوترة Shop Campaign.

لمتطلبات بيانات واجهة برمجة التطبيقات (API) والطلبات، راجع بيانات طلبات Shop Cash وعمليات الدمج التابعة لجهات خارجية. لمتطلبات الدفعات، راجع تسوية دفعات Shop Cash.