> ## Documentation Index
> Fetch the complete documentation index at: https://help.kwentra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kwentra Pay — تكامل Hyperpay

> اربط Hyperpay لترسل روابط دفع بالريال السعودي من الحجوزات وتتابع كل معاملة. للعقارات في السعودية فقط.

اربط Hyperpay لترسل روابط دفع بالريال السعودي من الحجوزات وتتابع كل معاملة. هذا التكامل للعقارات في السعودية فقط.

### **القيمة العملية**

* أرسل روابط الدفع من الحجوزات. يدفع النزلاء بمدى أو Visa أو Mastercard.
* يُؤخذ اسم النزيل وبريده وجواله والمبلغ من الحجز تلقائياً.
* تُرحَّل المبالغ المدفوعة إلى الحجز تلقائياً. لا إدخال يدوي.
* تظهر معاملات Hyperpay في سجلات Kwentra Pay مع البوابات الأخرى.
* أعدّ أقسام دفع كثيرة، لكل منها عملتها ونص زرها.

### **حالات الاستخدام**

* موظف الاستقبال يرسل رابط عربون إلى جوال النزيل أو بريده من الحجز.
* فريق الحسابات يفلتر سجلات Kwentra Pay حسب Hyperpay وDetails ليجد معاملة.
* مسؤول الفندق يُعدّ بطاقتي دفع، كل منهما مربوطة بقسم ائتمان مختلف.

### **كيف يعمل**

#### **1. شاشة الإعدادات**

| **Where:** Front Office → Settings → Integrations → Kwentra Pay → Hyperpay |
| - |

| **مهم:** يعمل Hyperpay فقط للعقارات التي بلدها السعودية. |
| - |

**بيانات الدخول (Access Credentials)**

| **الحقل** | **التفاصيل** |
| - | - |
| Email Address | إلزامي. البريد الإلكتروني لحساب Hyperpay. |
| Password | إلزامي. للأمان، يكون مخفياً عند تحميل الصفحة. |

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/ff1c9f8b01.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=7db409edb2317e2c19d3cf66ef81271a" alt="بيانات الدخول إلى Hyperpay" width="1916" height="420" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/ff1c9f8b01.png" />

**إعدادات الدفع (Payment Settings)**

اضغط **Add** لإعداد بطاقة دفع أو أكثر. كل بطاقة تحتاج:

| **الحقل** | **التفاصيل** |
| - | - |
| Payment Department | قائمة أقسام من نوع ائتمان. تربط المدفوعات بالقسم المحاسبي الصحيح. |
| Currency | تُملأ من عملة القسم المختار. |
| Button Label | النص الذي يراه المستخدم لبدء دفع Hyperpay، مثل "Pay Now". |
| Allowed Modules | اختر Front Office ليظهر خيار الدفع هناك. يمكنك اختيار أكثر من وحدة. |

| **ملاحظة:** إذا لم يكن للقسم عملة، لا يمكنك الحفظ. تظهر الرسالة: "Cannot save the form as the department \[NAME] does not include a currency. Please set a default currency for the department or select a different department." |
| - |

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/84096b5bcd.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=38553f81035c95a2e759534768c0ca07" alt="بطاقة إعدادات الدفع في Hyperpay" width="1780" height="570" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/84096b5bcd.png" />

**تفعيل التكامل**

1. املأ بيانات الدخول. أعدّ بطاقة دفع واحدة على الأقل.
2. اضغط **Save**.
3. اضغط **Enable Integration**. يتحقق النظام من بياناتك مع Hyperpay.
4. إذا كانت صحيحة، يُفعَّل التكامل.
5. إذا كانت خاطئة، تظهر الرسالة: "Wrong Credentials — Data is not saved & integration is not enabled."

| **ملاحظة:** بعد التفعيل، يتغير الزر إلى **Disable Integration**. اضغطه في أي وقت لإيقاف التكامل. |
| - |

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/eec92e1b75.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=be4ea5db53e7b01cd7ec15cca3cea6fc" alt="زر Enable Integration في Hyperpay" width="406" height="222" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/eec92e1b75.png" />

#### **2. إنشاء رابط دفع**

| **Where:** Front Office → Individual Reservations → Billing → Tools Menu → Payment → Kwentra Pay, or Front Office → Paymaster → Billing |
| - |

ينشئ Hyperpay الرابط من بيانات الحجز عند استخدام زر Kwentra Pay.

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/8a00a5978e.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=45185be709454748c702fd39bf2509be" alt="خيار Payment في قائمة أدوات الفوترة" width="564" height="487" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/8a00a5978e.png" />

1. اختر **Kwentra Pay**.

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/8c1e86025c.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=c2dbc054bd9c0f277ea46439bf404193" alt="خيار الدفع Kwentra Pay" width="830" height="302" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/8c1e86025c.png" />

2. اختر قسم الدفع الذي يسجّل الدفعة. أدخل المبلغ.

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/be61b4d6ce.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=a3f3b184d91e9b0eb1d30c76300d2d13" alt="قسم الدفع والمبلغ لرابط الدفع" width="843" height="623" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/be61b4d6ce.png" />

3. انسخ الرابط، أو أرسله عبر WhatsApp.

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/dfd2f94ebb.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=b2e8911e647d3700518baaed57164196" alt="رابط الدفع مع خياري النسخ وWhatsApp" width="749" height="559" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/dfd2f94ebb.png" />

يرى النزيل شاشة الدفع:

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/52104a6ef4.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=022a3fd59f4f959203c9d383be337c11" alt="شاشة الدفع في Hyperpay" width="1251" height="899" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/52104a6ef4.png" />

ثم يُدخل بيانات البطاقة:

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/9db5724400.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=44cd192c539dddc9e11418de92cd8b7c" alt="شاشة بيانات بطاقة الائتمان في Hyperpay" width="1652" height="678" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/9db5724400.png" />

**البيانات المُرسَلة إلى Hyperpay**

| **الحقل المُرسَل إلى Hyperpay** | **مصدره في Kwentra** |
| - | - |
| Guest Name | ملف النزيل الرئيسي: First Name + Last Name (أو اسم Paymaster) |
| Email | ملف النزيل الرئيسي → Email (قيمة بديلة إذا كان فارغاً) |
| Mobile | ملف النزيل الرئيسي → Mobile (قيمة بديلة إذا كان فارغاً) |
| Amount | إجمالي المبلغ المستحق على الحجز |
| Currency | عملة قسم الدفع |
| Language | لغة الحجز: "ar" للعربية، و"en" للإنجليزية (الافتراضي) |
| Payment Type | دائماً "DB" (خصم) |

* يقبل الرابط **مدى وVisa وMastercard**.
* يفتح النزيل الرابط ويدفع.
* يُبلغ Hyperpay نظام Kwentra (webhook). تُرحَّل الدفعة إلى الحجز تلقائياً.

| **ملاحظة:** إذا لم يكن للنزيل بريد أو جوال، يرسل النظام قيمة بديلة. واجهة Hyperpay تحتاجها. لا تؤثر على الدفع. |
| - |

#### **3. سجلات المعاملات**

| **Where:** Front Office → Settings → Integrations → Kwentra Pay → Logs |
| - |

تُحفظ كل معاملات Hyperpay في سجلات Kwentra Pay. أصبح في شاشة السجلات:

* **Payment Gateway Name:** اختر بوابة أو أكثر. اختر Hyperpay لترى معاملاته فقط.
* **عمود Details:** يعرض بيانات المعاملة التي يرسلها Hyperpay.
* **فلتر Details:** ابحث في السجلات بأي نص موجود في حقل Details.

<img src="https://mintcdn.com/kwentra/nLl32P6nCdmcaVke/images/compliance-integrations/kwentra-pay-hyperpay-integration/5dcacaf8f6.png?fit=max&auto=format&n=nLl32P6nCdmcaVke&q=85&s=1376efb12b11e1a171b90aae68db3071" alt="سجلات Kwentra Pay مفلترة حسب Hyperpay" width="1781" height="823" data-path="images/compliance-integrations/kwentra-pay-hyperpay-integration/5dcacaf8f6.png" />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.