# Odoo (/ar/plugins/odoo)

نزّل موديول XPay لـ Odoo، اربط حسابك، واقبل المدفوعات في Odoo.

موديول XPay بيضيف XPay كمزوّد دفع في Odoo. العميل بيدفع في حقول دفع آمنة جوّه موقعك، وOdoo بيأكّد الطلب أو الفاتورة أول ما XPay يبلّغ بالدفع. نزّله من [Odoo Apps Store](https://apps.odoo.com/apps/modules/19.0/xpay_payment).

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

## تقدر تعمل إيه [#تقدر-تعمل-إيه]

<Cards>
  <Card icon="<ShoppingCart />" title="صفحة دفع المتجر الإلكتروني">
    العملاء بيدفعوا طلبات الموقع بطرق الدفع اللي على حسابك في XPay.
  </Card>

  <Card icon="<Link />" title="روابط الدفع والفواتير">
    روابط الدفع بتاعة Odoo والفواتير اللي بتتدفع أونلاين بتعدّي على XPay برضه.
  </Card>

  <Card icon="<Wallet />" title="طرق الدفع والعملات اللي على حسابك">
    البطاقات بكل عملة حسابك بيقبلها، وValU وفوري بالجنيه المصري لو حسابك فيه الطرق دي.
  </Card>

  <Card icon="<Undo2 />" title="رد المبالغ من Odoo">
    استرداد كامل أو جزئي من عملية الدفع. والمبالغ اللي بترجّعها من لوحة تحكم XPay بتظهر في Odoo.
  </Card>
</Cards>

محتاج Odoo 18 أو 19، Community أو Enterprise، شغّال على السيرفر بتاعك أو على Odoo.sh. Odoo Online مش بيسمح بموديولات خارجية. موقعك لازم يكون شغّال على عنوان HTTPS عام.

## نزّل الموديول واربط حسابك [#نزّل-الموديول-واربط-حسابك]

<Steps>
  <Step>
    ### نزّل الموديول [#نزّل-الموديول]

    نزّل الموديول لنسخة Odoo بتاعتك من [Odoo Apps Store](https://apps.odoo.com/apps/modules/19.0/xpay_payment) وفكّه جوّه مسار الـ addons بتاع Odoo. اعمل restart لـ Odoo، حدّث قائمة التطبيقات، وبعدين سطّب **XPay Payment Provider** من **Apps**.
  </Step>

  <Step>
    ### افتح مزوّد XPay [#افتح-مزوّد-xpay]

    روح على **Website** ← **Configuration** ← **eCommerce** ← **Payment Providers**، أو **Invoicing** ← **Configuration** ← **Online Payments** ← **Payment Providers**، وافتح **XPay**.
  </Step>

  <Step>
    ### اربط حسابك على XPay [#اربط-حسابك-على-xpay]

    اضغط **Connect with XPay**، سجّل دخولك على XPay ووافق. هترجع وانت مربوط بحساب الاختبار، والمزوّد في **Test Mode** والـ webhook بتاعه متظبط. الربط محتاج أدمن Odoo.
  </Step>

  <Step>
    ### اعمل طلب تجريبي [#اعمل-طلب-تجريبي]

    في **Test Mode**، Odoo بيعرض XPay وقت الدفع للأدمن بس، فاعمل الطلب التجريبي وانت مسجّل دخول. ادفع بـ [بطاقة اختبار](/get-started/test-mode) واتأكد إن الطلب اتأكّد.
  </Step>
</Steps>

## طرق الدفع والعملات [#طرق-الدفع-والعملات]

الموديول بيقرا طرق الدفع والعملات من حسابك على XPay لما تربط. لما XPay يشغّل حاجة جديدة لحسابك، اضغط **Refresh account** في المزوّد. علشان تقبل عملات أقل، قلّل قائمة **Currencies** في تبويب **Configuration** بتاع المزوّد. **Refresh account** بيرجّعها لكل العملات اللي حسابك بيدعمها.

## اتحوّل للحساب الفعلي [#اتحوّل-للحساب-الفعلي]

لازم حسابك على XPay يكون [متوافق عليه للمدفوعات الفعلية](/get-started/onboarding) الأول. في المزوّد، اضغط **Go live** ووافق على حسابك الفعلي في XPay. الربط الفعلي بياخد مكان ربط الاختبار، والمزوّد بيتحوّل لـ **Enabled** ويتنشر لكل العملاء.

علشان ترجع للاختبار، اضغط **Switch to a test account**. **Disconnect** بيشيل الربط ويقفل XPay.

## رد المبالغ [#رد-المبالغ]

افتح عملية الدفع من الطلب أو الفاتورة واضغط **Refund**، للمبلغ كله أو جزء منه. XPay بيأكّد كل استرداد، وOdoo بيسجّله على الطلب. المبالغ اللي بترجّعها من لوحة تحكم XPay بتتنقل لـ Odoo بنفس الطريقة. مدفوعات ValU ما ينفعش تترد عن طريق XPay.

## لما حاجة ما تشتغلش [#لما-حاجة-ما-تشتغلش]

فورم المزوّد فيه سطرين للحالة. **Connection** بيقول أنهي حساب XPay مربوط، وهل هو اختبار ولا فعلي. **Webhook** بيقول هل XPay قادر يوصل لمتجرك.

| اللي بتشوفه                  | معناه                                                      | تعمل إيه                                                                                   |
| ---------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| XPay مش ظاهر في صفحة الدفع   | المزوّد في **Test Mode**، أو العملة مش في القائمة بتاعته.  | سجّل دخول كأدمن، أو خلّي المزوّد **Published**. راجع قائمة **Currencies**.                 |
| حقول الدفع مش بتحمّل         | إضافة تسريع، أو أداة موافقة، أو سياسة أمان بتمنع XPay.     | اسمح بالسكريبتات والـ frames من `https://checkout.xpay.app`.                               |
| العميل دفع والطلب ما اتأكّدش | **Webhook** مكتوب فيه **Not set up** أو **Failing since**. | اضغط **Reconfigure webhook**. الـ **Domain** بتاع موقعك لازم يكون عنوان HTTPS العام بتاعه. |
| **Go live** مرفوض            | حسابك على XPay لسه مش متوافق عليه للمدفوعات الفعلية.       | كمّل [الانضمام](/get-started/onboarding)، وبعدين اضغط **Go live** تاني.                    |
| طلب فوري لسه معلّق           | العميل لسه ما دفعش كود فوري.                               | مش محتاج تعمل حاجة. Odoo بيأكّد الطلب لما XPay يبلّغ إنه اتدفع.                            |

## رايح فين بعد كده [#رايح-فين-بعد-كده]

<Cards>
  <Card icon="<Puzzle />" title="الإضافات" href="/plugins">
    كل إضافة من إضافات XPay بتعمل لك إيه، وتنزّلها منين.
  </Card>

  <Card icon="<FlaskConical />" title="وضع الاختبار" href="/get-started/test-mode">
    بطاقات اختبار لكل نتيجة دفع.
  </Card>

  <Card icon="<FileText />" title="المدفوعات غير المتزامنة" href="/integrate/asynchronous-payments">
    مدفوعات فوري بتكتمل إزاي بعد صفحة الدفع.
  </Card>

  <Card icon="<WooCommerceIcon />" title="WooCommerce" href="/plugins/woocommerce">
    عندك متجر على WooCommerce كمان؟ اربطه بنفس الطريقة.
  </Card>
</Cards>