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

# أتمتة مدفوعات SellAuth

> اقبل المزيد من العملات المشفرة في متجر SellAuth الخاص بك خلال نحو 5 دقائق مع NowPayments أو Heleket أو Cryptomus.

هل تريد قبول المزيد من مدفوعات العملات المشفرة في متجر SellAuth الخاص بك؟ يمكنك إعداد ذلك بنفسك في نحو **5 دقائق**. لا تحتاج إلى خادم ولا تكتب أي كود. تملأ نموذجًا قصيرًا واحدًا، وأنا أشغّل صفحة الدفع الخاصة بك وأُبقيها متصلة.

* **صفحة دفع بالعملات المشفرة** لمتجر SellAuth الخاص بك
* اختيارك بين **Heleket أو Cryptomus أو NowPayments**
* **معالج دفع واحد في كل مرة**. بدّل إلى آخر متى شئت.
* لوحة تحكم بسيطة بحالتك و**سجلات مباشرة**

![صفحة الترخيص تعرض معالجًا قيد التشغيل وتفاصيل الترخيص ورابطي الدفع وwebhook](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-09-live.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=777b90af5fca72a76d66882aeffa185c)

صفحة الدفع الخاصة بك تعمل: حالة التشغيل ورابطاك

## يستغرق 3 خطوات

**1. احصل على ترخيصك**

اشترِ ترخيصًا. تتلقى مفتاحًا يبدو مثل `ECHO-XXXX-XXXX-XXXX-XXXX`.

**2. أنشئ حسابك واربط معالجًا**

سجّل بمفتاحك واختر معالجًا واملأ نموذجًا واحدًا.

**3. الصق رابطين. انتهى.**

انسخ رابط الدفع إلى SellAuth ورابط webhook إلى معالجك. يقبل متجرك الآن العملات المشفرة.

> [!TIP]
>
> انتقل إلى: [أنشئ حسابك](#1-أنشئ-حسابك)، [اربط معالجًا](#2-اربط-معالجًا)، [رابطاك](#3-رابطاك-ودفعة-اختبار)، [بدّل المعالج](#4-بدّل-المعالج)، [أضف ترخيصًا آخر](#5-أضف-ترخيصًا-آخر)، [التجديد](#6-التجديد-والانتهاء)، [الأسئلة الشائعة](#الأسئلة-الشائعة).

## ما الذي تحتاجه

> [!NOTE]
>
> **جهّز ما يلي:**
>
> * **مفتاح الترخيص** من عملية الشراء
> * **معرّف متجر SellAuth** و**مفتاح API لـ SellAuth**
> * حساب لدى **Heleket أو Cryptomus أو NowPayments** مع بيانات API الخاصة به

> [!NOTE]
>
> تستخدم لقطات الشاشة بيانات مثال وهمية (معرّف المتجر `12345` ومفاتيح مثل `test-api-key-xxxx`). استخدم قيمك الخاصة ولا تشاركها أبدًا.

## 1. أنشئ حسابك

**1. افتح صفحة التسجيل**

افتح صفحة التسجيل في لوحة التحكم. هل سجّلت من قبل؟ انقر على **Sign in** بدلًا من ذلك.

**2. املأ النموذج**

اختر اسم مستخدم وأضف بريدك الإلكتروني واختر كلمة مرور من 10 أحرف على الأقل. الصق مفتاح الترخيص في الأسفل ثم انقر على **Create account**.

![نموذج Create your account مع اسم المستخدم والبريد الإلكتروني وكلمة المرور ومفتاح ترخيص نموذجي](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-02-register.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=de5d4ca59d962cf12845af6d8fb11f03)

سجّل بمفتاح الترخيص الخاص بك (المفتاح الظاهر هنا مجرد نموذج)

**3. لقد دخلت**

تم تسجيل دخولك فورًا. ترخيصك نشط ويبدأ وقتك الآن.

> [!WARNING]
>
> يعمل كل مفتاح **مرة واحدة** فقط. إذا ظهرت لك رسالة "This license key is invalid or has already been used"، فتحقق من المفتاح بحثًا عن أخطاء مطبعية. إذا استمر الفشل، فاسأل الدعم. أبقِ مفتاحك سريًا.

## 2. اربط معالجًا

المعالج هو الخدمة التي تتولى دفعة العملات المشفرة. اختر **واحدًا**. يمكنك التبديل لاحقًا.

**1. افتح ترخيصك**

انقر على **Licenses** في الأعلى، ثم على ترخيصك، ثم على **Set up processor**.

**2. اختر معالجًا**

![صفحة Choose a processor تعرض Heleket وCryptomus وNowPayments](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-12-swap-pick.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=37c8d5376e810510e3154b83a831249d)

اختر NowPayments أو Heleket أو Cryptomus

**3. املأ النموذج**

يطلب كل نموذج **معرّف متجر SellAuth** و**مفتاح API لـ SellAuth** (النطاقات المطلوبة: Invoice Read وUpdate وProcess) وبيانات اعتماد معالجك. انظر التبويب أدناه.

**4. انقر على الزر الأخضر**

يستغرق الإعداد حتى دقيقة. أبقِ الصفحة مفتوحة حتى ينتهي. بعدها ترى حالتك ورابطيك.

> [tab] NowPayments
>
> تحتاج إلى **مفتاح API لـ NowPayments** و**IPN secret لـ NowPayments**.
>
> ![نموذج إعداد NowPayments مع معرّف المتجر ومفتاح API لـ SellAuth ومفتاح API لـ NowPayments وIPN secret](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-07-form-nowpayments.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=39fed9e70b8671401993c77d8b68de88)
>
> نموذج إعداد NowPayments

> [tab] Heleket
>
> تحتاج إلى **مفتاح API لـ Heleket** و**معرّف التاجر (merchant ID) لـ Heleket**.
>
> ![نموذج إعداد Heleket مع معرّف المتجر ومفتاح API لـ SellAuth ومفتاح API لـ Heleket ومعرّف التاجر](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-05-form-heleket.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=bc33047c3633b689a025a94a80352bad)
>
> نموذج إعداد Heleket

> [tab] Cryptomus
>
> تحتاج إلى **مفتاح API لـ Cryptomus** و**معرّف التاجر (merchant ID) لـ Cryptomus**.
>
> ![نموذج إعداد Cryptomus مع معرّف المتجر ومفتاح API لـ SellAuth ومفتاح API لـ Cryptomus ومعرّف التاجر](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-06-form-cryptomus.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=be948733d2644f3232a5e31bb93118e2)
>
> نموذج إعداد Cryptomus

> [!NOTE]
>
> ابحث عن بيانات اعتماد API في لوحة تحكم معالجك نفسها. قد تبدو أسماء القوائم مختلفة من وقت لآخر. يصبح معرّف متجر SellAuth **مقفلًا على ترخيصك** بعد الإعداد الأول، لذا استخدم المتجر الذي تريد البيع عليه فعلًا.

> [!WARNING]
>
> **أخطاء شائعة:** خطأ مطبعي في مفتاح API لـ SellAuth أو معرّف المتجر، والخلط بين مفتاح API ومعرّف التاجر (أو IPN secret)، ومسافات منسوخة في بداية المفتاح أو نهايته. إذا فشل الإعداد ترى رسالة حمراء ويحتفظ النموذج بما كتبته. أدخل مفاتيحك السرية مرة أخرى.
>
> ![نموذج الإعداد مع رسالة خطأ حمراء حول مفتاح متجر SellAuth](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-08-setup-error.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=4651d603206104f9347e9b7a7cad394d)
>
> مثال على خطأ: مفتاح SellAuth كان خاطئًا

## 3. رابطاك ودفعة اختبار

هذه هي الخطوة الأخيرة. تعرض صفحة ترخيصك **رابطين**. كل واحد منهما يوضع في مكان مختلف.

![بطاقة Your URLs مع رابط الدفع ورابط webhook، لكل منهما زر Copy](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-10-urls.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=d99a12e3fa909c00b4e3b5d9d9ece4b3)

استخدم أزرار Copy

| الرابط | وظيفته | أين تلصقه |
| - | - | - |
| **Pay URL** | يوجّه المشتري إلى صفحة الدفع بالعملات المشفرة. | في SellAuth، كرابط إعادة توجيه لطريقة الدفع |
| **Webhook URL** | يخبر المعالج عند اكتمال الدفعة، ليُعلَّم الطلب كمدفوع. | في لوحة تحكم معالجك، كرابط callback أو IPN |

**1. الصق رابط الدفع في SellAuth**

انقر على **Copy** بجانب **Pay URL**. في SellAuth افتح طرق الدفع الخاصة بك واضبط رابط إعادة التوجيه عليه. تقول لوحة التحكم: *SellAuth, Payment methods, redirect URL*.

**2. الصق رابط webhook في معالجك**

انقر على **Copy** بجانب **Webhook URL**. في لوحة تحكم معالجك اضبط رابط callback أو IPN عليه. تقول لوحة التحكم مثلًا: *NowPayments dashboard, callback / IPN URL*.

**3. تحقق من الحالة**

تعرض بطاقة المعالج في صفحة ترخيصك شارة خضراء **running**.

![بطاقة معالج نشط مع شارة خضراء running وأزرار Swap processor وStart وStop وRestart](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-11-status.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=2e12cc1d83c2ff0ab711fe0c9c175f1f)

معالج قيد التشغيل

**4. أجرِ طلب اختبار صغيرًا**

اشترِ أحد منتجاتك بالعملات المشفرة بمبلغ صغير. مرّر إلى **Logs** في صفحة ترخيصك. تظهر أسطر جديدة مباشرةً عند وصول طلب دفع. بعد تأكيد الدفعة، يُعلَّم الطلب كمدفوع ويُسلَّم.

> [!NOTE]
>
> قد تبدو أسماء القوائم في SellAuth وفي لوحة تحكم معالجك مختلفة قليلًا عما كُتب هنا. ابحث عن رابط إعادة التوجيه ورابط callback أو IPN.

> [!WARNING]
>
> أبقِ `{unique_id}` في رابط الدفع **تمامًا كما هو مكتوب**. يملؤه SellAuth لكل طلب.

إذا بدا أن شيئًا ما عالق، فجرّب **Restart** في صفحة ترخيصك أولًا.

## 4. بدّل المعالج

يمكنك استخدام **معالج واحد في كل مرة** لكل ترخيص والتبديل متى شئت، مثلًا من NowPayments إلى Heleket.

* **يبقى كما هو:** ترخيصك وتاريخ انتهائه ومعرّف متجر SellAuth ومفتاحه.
* **يتغير:** تُدخل بيانات اعتماد المعالج الجديد وتحصل على **روابط جديدة** تلصقها من جديد.

**1. انقر على Swap processor**

افتح ترخيصك وانقر على **Swap processor** واختر المعالج الجديد.

**2. املأ النموذج الجديد**

يحذّرك النموذج من أن صفحة الدفع الحالية ستتوقف عند تشغيل الجديدة. أدخل بيانات الاعتماد الجديدة وضع علامة في المربع للتأكيد.

![نموذج إعداد Heleket مع تحذير التبديل ومربع تأكيد](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-08-swap-heleket-form.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=0b1ba849c6addc55ea760a6675ffc7b2)

التبديل من NowPayments إلى Heleket

**3. الصق الروابط الجديدة**

ترى *Swap complete*. حدّث رابط إعادة التوجيه في SellAuth ورابط callback أو IPN في المعالج الجديد.

> [!WARNING]
>
> بعد التبديل، **تتوقف الروابط القديمة عن العمل فورًا**. حدّث SellAuth بسرعة حتى لا يصل المشترون إلى رابط ميت.

> [!TIP]
>
> الأمر آمن. تبدأ صفحة الدفع الجديدة أولًا ويجب أن تعمل قبل أن يتغير أي شيء. إذا فشل التبديل ترى رسالة تفيد بأن صفحة الدفع القديمة **لا تزال نشطة**. لا يضيع شيء. أصلح المشكلة وحاول مرة أخرى.

## 5. أضف ترخيصًا آخر

يمنحك كل ترخيص **خانة معالج واحدة**. أضف ترخيصًا آخر لـ **متجر SellAuth ثانٍ** أو **معالج ثانٍ** في الوقت نفسه.

**1. انقر على Add license**

استخدم **Add license** في القائمة العلوية. الصق المفتاح الجديد واختر **Add as new license**.

![نموذج Add license مع مفتاح نموذجي وخيارات للإضافة كترخيص جديد أو تمديد ترخيص موجود](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-13-add-license.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=14b2d3b92a2864aae399a966fdd550e0)

أضف ترخيصًا (مفتاح نموذجي)

**2. أعدّه**

تسرد لوحة التحكم كل ترخيص بحالته وتاريخ انتهائه. افتح الترخيص الجديد واربط معالجًا. لكل ترخيص متجره الخاص وروابطه الخاصة.

![لوحة تحكم تسرد ترخيصي عملات مشفرة مع الحالة وتاريخ الانتهاء](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/n-14-dashboard.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=af3a32d6459ba6339956c335debd28e1)

لوحة تحكم بعدة تراخيص

تخص التراخيص اليوم مدفوعات **العملات المشفرة**. تظهر الفئات الأخرى، مثل skins والدفع بالبطاقات، بعبارة **coming soon** ولا يمكن استخدامها بعد.

## 6. التجديد والانتهاء

تأتي التراخيص لمدة **1 أو 3 أو 6 أو 12 شهرًا**. يبدأ الوقت عندما **تسجّل أو تستبدل المفتاح**، وليس عند الشراء. تحصل على **يومين إضافيين** فوق كل استبدال، للإعداد والاختبار. يظهر تاريخ انتهائك أعلى صفحة ترخيصك وفي لوحة التحكم.

عند انتهاء الترخيص:

* **تتوقف** صفحة الدفع مؤقتًا. لا يستطيع المشترون الدفع بالعملات المشفرة حتى تجدد.
* **لا يُحذف شيء.** تبقى إعداداتك وسجلاتك.

![صفحة الترخيص مع شارة expired ورسالة لاستبدال مفتاح التجديد](https://mintcdn.com/echoauth/e76GE4c5Q1nkWlMv/images/payment-provisioner/cust-16-expired.png?fit=max\&auto=format\&n=e76GE4c5Q1nkWlMv\&q=85\&s=97ca7e9f755a852e93465194003b0691)

ترخيص منتهٍ مع طلب تجديد

**1. احصل على مفتاح تجديد**

اشترِ مفتاح ترخيص جديدًا.

**2. استبدله**

انقر على **Redeem a renewal key**، أو **Extend with a new key** في صفحة ترخيصك، والصق المفتاح.

**3. انتهى**

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

> [!TIP]
>
> يمكنك التجديد **قبل** الانتهاء. يُضاف الوقت الجديد إلى تاريخ انتهائك الحالي، فلا تخسر شيئًا.

> [!WARNING]
>
> عامل مفتاح الترخيص كأنه كلمة مرور. لا تنشره علنًا. تعرض لوحة التحكم آخر 4 أحرف فقط. يمكنك تغيير كلمة المرور من **Settings**.

## الأسئلة الشائعة

> [accordion] مفتاح الترخيص الخاص بي غير صالح أو مستخدم من قبل
>
> تحقق من الأخطاء المطبعية والمسافات الزائدة. يعمل كل مفتاح **مرة واحدة**. إذا سجّلت به من قبل فسجّل الدخول. وإذا كنت متأكدًا من أنه جديد فاسأل Echo.

> [accordion] يعرض الإعداد خطأً أحمر
>
> في الغالب يكون السبب مفتاح API لـ SellAuth أو معرّف متجر أو بيانات اعتماد معالج خاطئة. افحص كل حقل وأزل المسافات وحاول مرة أخرى. يعرض النموذج آخر أسطر السجل من المحاولة الفاشلة للمساعدة.

> [accordion] يبقى الطلب غير مدفوع بعد أن دفع المشتري
>
> تحقق من **رابط webhook** في لوحة تحكم معالجك. يجب أن يكون الرابط الموجود في صفحة ترخيصك تمامًا. ثم ابحث عن الأخطاء في **Logs** في صفحة ترخيصك.

> [accordion] يصل المشترون إلى صفحة خطأ عند الدفع
>
> تحقق من **رابط إعادة التوجيه** في SellAuth. يجب أن يكون رابط الدفع الخاص بك مع بقاء `{unique_id}` كما هو. وتحقق أيضًا من أن ترخيصك نشط وأن الشارة تقول **running**.

> [accordion] بدّلت المعالج وتوقفت صفحة الدفع
>
> الصق **الروابط الجديدة** بعد التبديل. تتوقف الروابط القديمة عن العمل.

> [accordion] فشل التبديل لدي
>
> إعدادك القديم **محفوظ ولا يزال نشطًا**. اقرأ الرسالة الحمراء وصحّح بيانات الاعتماد وحاول مرة أخرى.

> [accordion] لا أستطيع تسجيل الدخول
>
> بعد عدة كلمات مرور خاطئة تُحظر لفترة. **انتظر نحو 15 دقيقة** وحاول مرة أخرى. تحقق من اسم المستخدم أو البريد الإلكتروني.

> [accordion] تظهر لي رسالة تطلب المحاولة لاحقًا
>
> هناك حد لعدد مرات الإعداد أو التبديل أو تغيير بيانات الاعتماد في الساعة. انتظر قليلًا وحاول مرة أخرى.

> [accordion] أريد تغيير متجر SellAuth الخاص بي
>
> المتجر مقفل على الترخيص بعد الإعداد الأول. اطلب من الدعم تغييره، أو استخدم ترخيصًا آخر للمتجر الآخر.

> [accordion] نسيت كلمة المرور
>
> لا يُرسل أي بريد إلكتروني. اطلب من الدعم إعادة تعيين كلمة المرور. يمكنك تغيير كلمة المرور لاحقًا في **Settings**.

> [accordion] انتهى ترخيصي
>
> صفحة الدفع الخاصة بك متوقفة مؤقتًا ولم يضع شيء. استبدل مفتاح تجديد. انظر [التجديد والانتهاء](#6-التجديد-والانتهاء).

ما زلت عالقًا؟ افتح تذكرة في [خادم الدعم](https://discord.echoauth.dev) الخاص بي.


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