# Coinpayments

* [كيفية الربط ](#how-to-connect)
* [كيفية إنشاء رابط للدفع ](#how-to-create-a-link-to-payment)
* [كيفية معالجة النتيجة ](#how-to-process-the-result)
* [كيفية التحقق من حالة الدفع](#how-to-check-the-payment-status)

## كيفية الربط 

لربط نظام الدفع Coinpayments ستحتاج إلى 4 قيم: معرّف البائع، سر IPN (للـ webhooks)، مفتاح API الخاص ومفتاح API العام، وكذلك إعداد عنوان URL للـ webhook. 

اذهب إلى حساب Coinpayments -> الإعدادات 

<https://ww.coinpayments.net/index.php?cmd=acct_settings>

![](/files/8e97ead67f487c8cf50168223c2c94aacb92166b)

في التبويب الأول، انسخ معرّف البائع **(معرّف البائع)**

ثم انتقل إلى تبويب الإعدادات الخاص بالبائع، وقم بإنشاء وإدخال المفتاح السري IPN - سر IPN (يُستخدم هذا للتأكد من أن الـ webhook يأتي منا، استخدم سلسلة معقدة موثوقة سيكون من الصعب تخمينها.)&#x20;

**ربط IPN** - عنوان URL للـ webhooks، أضف ما يلي: <https://chatter.salebot.pro/coinpayments_callback/result>

ثم انتقل إلى **مفاتيح API** القسم وقم بإنشاء زوج مفاتيح للوصول إلى الـ api.

![](/files/cd685991ed2b1cf56b10a34977d63e328943f1e2)

**حفظ** جميع الإعدادات، انسخ البيانات وانتقل إلى الإعدادات في Salebot. افتح قسم أنظمة الدفع، واختر **Coinpayments**.

&#x20;                                            ![](/files/8b1cab97f658d1f74f9471210b9387d3f931d4d3)

نحتاج إلى إدخال البيانات.

![](/files/307540c07107186021554bd1bba1d4831359ddc9)

لإنشاء رابط للدفع، تحتاج إلى تعيين قيمة المتغيرات المطلوبة: **original\_currency** - العملة الأصلية للمعاملة. **sending\_currency** - العملة المرسلة من قبل المشتري. على سبيل المثال، إذا كانت أسعار منتجاتك بالدولار الأمريكي لكنك تتلقى BTC، فيجب أن تستخدم original\_currency = USD و sending\_currency = BTC. يمكن أن تكون original\_currency و sending\_currency بالقيمة نفسها إذا لم تكن هناك حاجة لتحويل العملة.

**buyer\_email** هو عنوان البريد الإلكتروني للمشتري. لإرسال إشعارات إذا كان الدفع أقل وتحتاج إلى دفع مبلغ إضافي أو في حالة الاسترداد. إذا لم يتم تحديد هذا المتغير، فسيتم أخذ البريد تلقائيًا من متغير email، إذا كان لدى المستخدم واحد في salebot.&#x20;

بعد ذلك، يجب عليك تعيين قيمة **payment\_sum** المتغير (على سبيل المثال، 10 أو 0.0055 (**باستخدام فاصلة عشرية!**))، وبعد ذلك مباشرةً **paycoinments\_pay\_url** سيظهر المتغير. يمكن عرض هذا المتغير كرابط أو وضعه على زر بالنص "Pay". الرابط هو: **<https://www.coinpayments.net/index.php?cmd=checkout\\&id=CPFK5QZ3FKSNWHI75CO8M4BRVkey\\&e7782d2ce24f7d03815606a5c4a882eb>**

أيضًا، قبل تعيين قيمة payment\_sum، يمكنك تحديد المتغيرات الاختيارية التالية لتكوين الدفع.&#x20;

**payment\_description** - اسم المنتج، وسيظهر في صفحة معلومات الدفع وفي IPN الخاصة بالمعاملة.&#x20;

**buyer\_name** - اسم المشتري&#x20;

## كيفية إنشاء رابط للدفع&#x20;

إنشاء رابط لدفع 0.44444

&#x20;                                ![](/files/8726df8678e403c5f23b1c334ac3813825d1ac2d)

{% hint style="info" %}
يرجى الملاحظة:

* أولاً حدِّد البريد الإلكتروني
* الخيارات الاختيارية التالية **first\_name, payment\_description**، إلخ.
* وأخيرًا، عيّن قيمة **payment\_sum** variable
  {% endhint %}

ملاحظة: أولًا نعيّن المتغيرات الخاصة بالإعدادات، ثم payment\_sum. يمكنك تعريف المتغيرات في وقت أبكر ضمن السلسلة، وليس في كتلة واحدة؛ هذا مثال.&#x20;

بعد ذلك، في المكان المناسب، اطبع المتغير **coinpayments\_pay\_url** الذي يحتوي على الرابط

&#x20;                                              ![](/files/f5855032e6ad945f772ef781e10bd396150d9be5)

{% hint style="warning" %}
لإجراء دفعة متكررة، يجب إعادة تعيين payment\_sum، والرابط الذي تم إنشاؤه مسبقًا، وبعد إعادة تعيين المتغير payment\_sum ستحصل على رابط جديد
{% endhint %}

## كيفية معالجة النتيجة&#x20;

بعد نجاح الدفع في البوت ستصل kolbeks، والتي يمكنك من خلالها فهم أن الدفع قد تم بنجاح. هذه الكولبيكات في النظام تراها كرسائل من المستخدم، لذلك لا يمكن إرسالها من قبل المستخدم، وهي تتكون من أول 10 أحرف من المفتاح السري مع الإشارة \_success، على سبيل المثال: 16831CF4b5\_success

{% hint style="success" %}
هذه الكولبيكات لا يراها المستخدم، بل تظهر فقط للمشغّل.
{% endhint %}

{% hint style="danger" %}
يجب أن يكون نوع المطابقة "Full match"
{% endhint %}

كما يتم أيضًا بعد نجاح الدفع تعيين المتغير coinpayments\_payment\_completed إلى true&#x20;

على سبيل المثال، يمكنك إنشاء كتلة معالجة دفع ناجحة مع شرط وطباعة الرسالة المناسبة للمستخدم:

&#x20;

![](/files/418e6177cc03d818120a12731039fb1e0399b94e)

عند اكتمال الدفع، **coinpayments\_payment\_callback** إضافة المتغير إلى العميل، ويتضمن بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات اللازمة من القاموس باستخدام **get** .

## كيفية التحقق من حالة الدفع&#x20;

للتحقق من حالة الدفع، تحتاج إلى استدعاء **coinpayments\_get\_payment\_status()** في حقل Calculator&#x20;

مثال:

&#x20;                                           ![](/files/d2173f17f6422f3ed1560dc9bb1db34d5d21c816)

&#x20;                                          ![](/files/cf54d70f2e87fbaaeccf85a016e8ed1786103327)

أمثلة على الحالات:

*في انتظار أموال المشتري...*&#x20;

*تم استلام الأموال وسيتم تأكيد الإرسال إليك قريبًا…*&#x20;

*مكتمل*&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/integrations/payment/coinpayments.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.