=== Daftar Cash - Payment Gateway for WooCommerce ===
Contributors: daftarcash
Tags: woocommerce, payment gateway, vodafone cash, instapay, egypt
Requires at least: 6.0
Tested up to: 6.7
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

بوابة دفع دفتر كاش (Daftar Cash) لـ WooCommerce - الدفع بالمحافظ الإلكترونية المصرية (فودافون كاش، أورنج كاش، اتصالات كاش، وي باي) وإنستاباي مع تأكيد فوري تلقائي.

== Description ==

بوابة دفع **دفتر كاش (Daftar Cash)** تتيح لأصحاب متاجر ووردبريس وWooCommerce استقبال المدفوعات من عملائهم في مصر عبر المحافظ الإلكترونية وشبكة المدفوعات اللحظية (InstaPay) بأمان تام وبدون أي عمولات وسيطة.

= كيف تعمل البوابة؟ =
1. يختار العميل خيار الدفع عبر "دفتر كاش" عند صفحة الدفع (Checkout).
2. يُوجَّه العميل لصفحة دفع مخصصة وآمنة (Hosted Checkout) تعرض رقم المحفظة والمبلغ بدقة وعداد وقت للتحويل.
3. يقوم العميل بتحويل المبلغ من محفظته أو عبر تطبيق إنستاباي.
4. فور وصول رسالة التحويل على هاتف التاجر، يتعرف النظام تلقائياً على العملية ويُرسل إشعار Webhook موقّع ومشفّر إلى المتجر.
5. يتحول الطلب في ووردبريس تلقائياً وفورياً إلى حالة "مكتمل" (Processing / Completed) دون أي تدخل يدوي من التاجر أو العميل.

= المميزات الرئيسية =
* **تأكيد دفع آلي وفوري:** لا حاجة لمراجعة سكرين شوت أو مطابقة إشعارات يدوية.
* **دعم كافة المحافظ وشبكات الدفع المصرية:** فودافون كاش، أورنج كاش، اتصالات كاش، وي باي (WE Pay)، وتطبيق إنستاباي (InstaPay).
* **توافق تام مع WooCommerce HPOS:** متوافق مع نظام التخزين عالي الأداء للطلبات (High-Performance Order Storage).
* **أمان متقدم:** توقيع رقمي مشفّر (HMAC-SHA256) لكل إشعار دفع لمنع التلاعب والتزييف.
* **إلغاء تلقائي للطلبات غير المدفوعة:** في حال انتهاء مهلة الدفع، تعود المنتجات للمخزون تلقائياً.

== External Services ==

This plugin relies on the **Daftar Cash** cloud service to process payments, generate hosted checkout pages, and dispatch secure webhook notifications for payment confirmation.

* **Service Homepage:** https://daftarcash.com
* **Terms of Service:** https://daftarcash.com/terms/
* **Privacy Policy:** https://daftarcash.com/privacy/

When an order is placed, the plugin transmits the order total, order ID, and billing phone number to the configured Daftar Cash server API endpoint to create a secure checkout session. No customer passwords, credit card numbers, or sensitive identity documents are collected or transmitted by this plugin.

== Installation ==

1. قم بتحميل وتثبيت الإضافة من لوحة تحكم ووردبريس (الإضافات -> أضف جديد) أو ارفع مجلد `daftarcash-gateway` إلى مسار `/wp-content/plugins/`.
2. قم بتفعيل الإضافة من صفحة "الإضافات".
3. اذهب إلى **WooCommerce -> الإعدادات -> المدفوعات -> دفتر كاش**.
4. قم بتفعيل الخيار وأدخل بيانات الربط من لوحة تحكم تاجر دفتر كاش:
   * **مفتاح التاجر (Merchant API Key)**
   * **المفتاح السري للتوقيع (Signature Secret Key)**
5. انسخ رابط الـ Webhook الموضح في الإعدادات، وضعه في حساب التاجر على منصة دفتر كاش.

== Frequently Asked Questions ==

= هل يتطلب المتجر وجود إضافة WooCommerce؟ =
نعم، هذه الإضافة مصممة خصيصاً للعمل كبوابة دفع لمتاجر WooCommerce.

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

= هل تدعم الإضافة نظام HPOS الجديد في ووردبريس؟ =
نعم، الإضافة مصممة بالكامل لتتوافق مع معمارية High-Performance Order Storage (HPOS).

== Screenshots ==

1. صفحة إعدادات بوابة دفتر كاش في لوحة تحكم WooCommerce.
2. خيار الدفع المعروض للعميل في صفحة إنهاء الطلب.

== Changelog ==

= 1.0.0 =
* الإصدار الرسمي الأول.
* دعم الدفع عبر كافة المحافظ الإلكترونية المصرية وإنستاباي.
* التوجيه لصفحة دفع مستضافة (Hosted Checkout) مع تأكيد تلقائي.
* تأكيد آمن عبر Webhook موقّع بـ HMAC-SHA256.
* التوافق التام مع ووردبريس 6.0+ وWooCommerce HPOS.
