المطورون/المنظومة والموارد
CardV Gift Cards لـ WooCommerce
بِع بطاقات الهدايا الرقمية من CardV في متجر WooCommerce الخاص بك. اختر البطاقات التي تريد بيعها، فتُنشئ الإضافة المنتجات، وعندما يدفع العميل تُشترى الأكواد من رصيدك في CardV وتُسلَّم في صفحة الطلب وفي البريد الإلكتروني الخاص بالطلب.
التثبيت من WordPress.org ↗احصل على مفاتيح API ↗
#ما الذي تقدّمه
- الاستيراد من الكتالوج. تصفّح كتالوج CardV من لوحة تحكم WordPress وأضف البطاقات إلى متجرك بنقرة واحدة.
- مبالغ ثابتة ومبالغ مخصّصة. تصبح البطاقات ذات القيمة الثابتة منتجًا واحدًا مع خيار لاختيار المبلغ. أما البطاقات ذات المبلغ المخصّص فتحصل على حقل لإدخال المبلغ مع معاينة فورية للسعر.
- أسعار تحمي هامش ربحك. حدّد نسبة زيادة للمتجر كله أو لكل بطاقة. لا تنخفض الأسعار أبدًا عن الحد الأدنى لهامشك، فلا يدفعك ارتفاع التكلفة إلى البيع بخسارة.
- مزامنة مجدولة. تُزامَن بيانات الكتالوج والتكلفة والتوفر وفق الجدول الذي تختاره (كل 6 ساعات افتراضيًا).
- تسليم تلقائي وفق قواعدك. بعد الدفع تُسلَّم الأكواد تلقائيًا، أو تُحجز لمراجعتك بناءً على طريقة الدفع، وحجم الطلب، وعدد الطلبات لكل عميل ولكل عنوان IP، وحدّ الطلب الأول، والتحقق من الدولة.
- أكواد محفوظة بأمان. تُخزَّن الأكواد مشفّرة ولا تظهر إلا للعميل الذي اشتراها. ولا تحتوي رسائل البريد الموجّهة إلى المسؤول على أي أكواد.
- بيئة Sandbox. اختبر العملية كاملة بمفاتيح Sandbox ومن دون أموال حقيقية.
#المتطلبات
| WordPress | الإصدار 6.5 أو أحدث |
| WooCommerce | مثبّت ومفعّل |
| PHP | الإصدار 7.4 أو أحدث |
| حساب CardV | حساب تاجر معتمد مع مفاتيح API |
| الرصيد | رصيد CardV مدفوع مسبقًا؛ تُدفع الطلبات منه |
أنت البائع المسؤول أمام عملائك: تحدّد أسعارك، وتقرّر أي الطلبات تُسلَّم تلقائيًا، وتتولّى دعم عملائك وعمليات الاسترداد.
#التثبيت
من لوحة تحكم WordPress (موصى به). افتح الإضافات > أضف جديد (Plugins > Add New)، وابحث عن CardV Gift Cards، ثم ثبّت الإضافة وفعّلها.
رفع ملف zip. نزّل الإضافة من WordPress.org، ثم افتح الإضافات > أضف جديد > رفع إضافة (Plugins > Add New > Upload Plugin)، واختر ملف zip، ثم ثبّته وفعّله.
#الإعداد
- قدّم طلبًا للحصول على حساب تاجر في CardV. تُراجَع الحسابات قبل أن تتمكن من تقديم الطلبات.
- في البوابة، أنشئ مفتاح API لبيئة Sandbox واحفظ معرّف المفتاح وسرّ التوقيع وسرّ Webhook.
- افتح CardV > Settings، واختر Sandbox، والصق القيم الثلاث ثم احفظ. تختبر الإضافة الاتصال. تُدخَل المفاتيح في هذه الصفحة وتُخزَّن مشفّرة، ولا تحتاج أبدًا إلى تعديل
wp-config.php. - انسخ عنوان URL الخاص بـ Webhook الظاهر في صفحة Settings إلى البوابة.
- افتح CardV > Products، واختر البطاقات التي تريد بيعها واستوردها.
- راجع قواعد التسعير والتسليم، وقدّم طلبًا تجريبيًا، ثم أضف مفاتيح Live وانتقل إلى Live.
#آلية العمل
المنتجات. تصبح كل بطاقة من CardV منتجًا واحدًا في WooCommerce. تحصل البطاقات ذات القيمة الثابتة على خيار لاختيار المبلغ، وتحصل البطاقات ذات المبلغ المخصّص على حقل لإدخال المبلغ، ويُحسب السعر وفق المبلغ الذي يُدخله العميل.
الأسعار والمزامنة. في كل مزامنة تُحدّث الإضافة التكلفة والسعر والتوفر. ولا تستبدل أبدًا عناوين منتجاتك أو أوصافها أو صورها.
التسليم. الطلبات المدفوعة بطرق الدفع التي تختارها، والتي تجتاز قواعد التسليم لديك، تُسلَّم تلقائيًا. أما بقية الطلبات فتنتظر في CardV > Orders حتى توافق عليها أو ترفضها. وإذا كان رصيدك في CardV غير كافٍ، يُوقَف الدفع لبطاقات الهدايا مؤقتًا حتى يغطي الرصيد قيمة السلة، فلا يُحاسَب العملاء أبدًا على بطاقات لا يمكنك تسليمها.
بيانات عملائك. لا ترسل الإضافة إلى CardV إلا ما يلزم لشراء الأكواد: المنتجات، والمبالغ، والكميات، والسعر المتوقع، ومرجع الطلب. ولا ترسل أبدًا أسماء عملائك أو عناوين بريدهم الإلكتروني أو عناوينهم البريدية أو عناوين IP أو بيانات الدفع. التفاصيل في سياسة الخصوصية.
#لقطات الشاشة

- نظرة عامة على الرصيد والمنتجات والطلبات التي تحتاج إلى إجراء منك.

- استيراد المنتجات من كتالوج CardV.

- اختيار المبلغ في صفحة المنتج.

- أكواد بطاقات الهدايا في صفحة الطلب.

- قواعد التسعير والتسليم.
#الأسئلة الشائعة
هل أحتاج إلى حساب CardV؟ نعم. تبيع الإضافة منتجات CardV وتدفع ثمنها من رصيدك في CardV.
هل يمكنني تغيير عناوين المنتجات وأوصافها وصورها؟ نعم. المزامنة تُحدّث التكلفة والسعر والتوفر فقط.
هل يمكن لقالبي تغيير طريقة عرض الأكواد؟ نعم. انسخ أي ملف من مجلد templates في الإضافة إلى yourtheme/cardv-gift-cards/ وعدّله.
ما الذي يُحذف عند حذف الإضافة؟ الإعدادات، والأسرار المشفّرة، والمهام المجدولة، وسجل النشاط. تبقى منتجاتك وطلباتك في WooCommerce، وتبقى الأكواد المسلَّمة مشفّرة في الطلبات.
#الدعم
الإضافة مجانية ومرخّصة بموجب رخصة GNU General Public License، الإصدار 2 أو أحدث. ويخضع استخدامك لخدمة CardV إلى شروط الخدمة. للحصول على المساعدة، راسل [email protected] مع ذكر Merchant ID ورقم الطلب.
هل لديك سؤال حول التكامل؟ راسلنا على [email protected] مع ذكر Merchant ID ومعرّف الطلب أو الاستدعاء.