إلى المحتوى
Perly
ابدأابدأ مجانًا

الأدلة

WooCommerce

طريقة دفع لـ WooCommerce: البيتكوين وUSDC/USDT مباشرةً إلى محفظتك، ويعلّم ويب هوك موقّع الطلب مدفوعًا.

افتح بصيغة Markdown

تضيف إضافة Perly Pay العملات المشفرة إلى صفحة إتمام الطلب الكلاسيكية وإلى كتلة Checkout. يصبح كل طلب فاتورة في Perly Pay؛ يدفعها المشتري فوق المتجر أو في صفحة مستقلة؛ ويعلّم ويب هوك موقّع الطلب مدفوعًا. WordPress 6.5+، وWooCommerce 8.6+، وPHP 8.1+. لا شيء لتثبيته على الخادم: PHP SDK موجودة بالداخل.

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

التثبيت

  1. 1

    احصل على ملف zip

    الإضافة في طريقها إلى WordPress.org. وحتى تصل، راسلنا للحصول على perly-pay-woocommerce.zip.

  2. 2

    ثبّت

    في WordPress: الإضافات ← أضف جديدًا ← رفع إضافة، اختر ملف zip، وفعّلها. يجب أن يكون WooCommerce مفعّلًا.

  3. 3

    افتح الإعدادات

    WooCommerce ← الإعدادات ← المدفوعات ← Perly Pay.

الإعداد

الحقلما تكتبه
المفتاح السريDashboard → Developers → API keys. sk_test_… لـوضع الاختبار، وsk_live_… للأموال الحقيقية. تُظهر الإعدادات الوضع الذي أنت فيه.
سر توقيع الويب هوكwhsec_…. يملؤه إعداد الويب هوك تلقائيًا.
صفحة الدفعنافذة تفتح الدفع فوق المتجر (pay.js). انتقال يوجّه المشتري إلى صفحتها. على الهواتف تُفتح الصفحة نفسها دائمًا.
الحالة بعد الدفعكما يقرر WooCommerce (قيد التنفيذ؛ مكتمل للتنزيلات)، أو قيد التنفيذ دائمًا، أو مكتمل دائمًا.
الاسم، الوصفما يراه المشترون عند إتمام الطلب.
سجل التصحيحالأحداث والأخطاء في WooCommerce ← الحالة ← السجلات. لا مفاتيح ولا أسرار ولا بيانات مشترين أبدًا.
  1. 1

    الصق المفتاح

    واضغط اختبر الاتصال: سترى هل يعمل المفتاح، ووضعه، وهل يوجد ويب هوك لهذا المتجر في Perly Pay.

  2. 2

    أعدّ الويب هوك

    اضغط إعداد الويب هوك. يضيف عنوان المتجر (فوق الأزرار، …/wp-json/perly-pay/v1/webhook) إلى Perly Pay ويحفظ السر. أو أضفه بنفسك في Developers → Webhooks والصق السر.

  3. 3

    اسمح بالنافذة

    في Dashboard → Settings أضف عنوان المتجر إلى Sites that may embed the checkout. بدون ذلك ستعرض النافذة فتح الدفع في علامة تبويب جديدة.

  4. 4

    فعّلها

    حدد قبول العملات المشفرة عبر Perly Pay واحفظ.

الاختبار

بمفتاح sk_test_… أتمّ طلبًا في متجرك واختر Perly Pay. ينتظر الطلب بحالة في انتظار الدفع. ادفع الفاتورة بعملات تجريبية أو عبر API — معرّفها في ملاحظات الطلب:

bash
curl -X POST https://pay.perly.io/api/v1/invoices/inv_…/simulate \
  -H "Authorization: Bearer $PERLY_PAY_SECRET_KEY" -H "Content-Type: application/json" -d '{}'

خلال ثوانٍ يصبح الطلب قيد التنفيذ، مع ملاحظة: الشبكة والمبلغ ورابط المعاملة. {"outcome":"short"} و{"outcome":"over"} يختبران الحالات الأخرى، حين تكون العملة قد اختيرت في صفحة الفاتورة.

كيف تتبع الطلبات المدفوعات

في Perly Payالطلب
مدفوعة، وفُحص المُرسل (invoice.fulfilled)مدفوع: الحالة المختارة، وتخفيض المخزون، ورسالة للمشتري. ملاحظة بكل تحويل ومعاملته.
مرصودة، مدفوعة جزئيًا، مدفوعة وما زالت قيد الفحصملاحظة. يبقى بالانتظار.
محتجزة للمراجعةمعلّق، مع السبب. قرّر في Perly Pay.
منتهية أو ملغاة، بلا أي دفعملغى.
منتهية، مدفوعة جزئيًامعلّق: استرد أو اقبل في Perly Pay.
مستردةمسترد بالكامل، أو ملاحظة عن الجزء.

يُطبَّق كل حدث مرة واحدة، على الطلب الذي أُنشئ له، ولا يلغي «انتهت» المتأخر أي دفعة أبدًا. إن عاد المشتري إلى صفحة الشكر قبل الويب هوك، تستعلم الإضافة من API وتحدّث الطلب فورًا.

الاستردادات

استرد كالمعتاد، من صفحة الطلب: تفتح الإضافة استردادًا في Perly Pay بالعملة التي دُفع بها (وجزءًا منها للاسترداد الجزئي). يطلب Perly Pay من المشتري عنوانًا بالبريد ويفحصه؛ وتقول ملاحظات الطلب ماذا ترسل وإلى أين. ترسل من محفظتك وتلصق معرّف المعاملة في Perly Pay — Perly Pay لا يحتفظ بالأموال أبدًا.

الإطلاق

  • فعّل الوضع الحقيقي في Perly Pay واربط المفاتيح العامة للمحفظة.
  • الصق مفتاح sk_live_…. المفاتيح والويب هوك الحقيقية منفصلة عن الاختبارية: اضغط إعداد الويب هوك مرة أخرى.
  • أضف عنوان https للمتجر الحقيقي إلى Sites that may embed the checkout في الوضع الحقيقي.
  • نفّذ طلبًا حقيقيًا صغيرًا واسترده.