# Coinpayments

* [كيفية الربط](#podklyuchenie) رابط How to connect
* [كيفية إنشاء رابط للدفع](#kak-sformirovat-ssylku-na-oplatu) رابط How to generate a payment link
* [كيفية معالجة النتيجة](#obrabotka-rezultata) رابط How to process the result
* [كيفية التحقق من حالة الدفع](#proverka-statusa-platezha) رابط How to check the payment status

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

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

انتقل إلى الحساب الشخصي في Coinpayments -> إعدادات الحساب <https://www.coinpayments.net/index.php?cmd=acct_settings>

![](https://lh3.googleusercontent.com/xACTDovKtHxhj7vrWkS0u2TpAy_mK1VU7fR7k2KAD_6lL9OHyKsn4Np54iD4jb7Gjackry858WfaABz37i6tkfn5HZW94n4SKqDq3ooRToxaeXQPRbhvgnKG-KrAssSlHy2lrSSQ)

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

![](/files/b0234270679482f20697555b9fbfa523110e9d05)

بعد ذلك، انتقل إلى تبويب "إعدادات البائع" وأنشئ وأدخل مفتاحًا سريًا لـ IPN - **سر IPN** (يُستخدم هذا للتحقق من أن خطاف الويب قادم منا). استخدم سلسلة آمنة ومعقدة يصعب تخمينها

رابط IPN - هو عنوان URL لخطافات الويب، أضف ما يلي: **<https://chatter.salebot.pro/coinpayments\\_callback/result>**

![](https://lh6.googleusercontent.com/K939LTpXmntuJKU1tTN6NTBgl2ziiQTG7okWMRAdOMMQa0K7LbH0X3l7FWmd74FPqY9NOOGl89tbK99fgCpFLva4NJ8VVZVwwGfaE9YYKQ5EOkkb72Qz3FO5jPisxWxrAX8Ac94p)

بعد ذلك، انتقل إلى قسم مفاتيح API وأنشئ زوج مفاتيح للوصول إلى API.

![](https://lh6.googleusercontent.com/4Y9V4YRgYAvMJNelxlO5bhynVt1er0a5F-QNnOitbBrWFfOLPwJpOM8BHKgMcXxlKzwE9rc32Coxo-iVB_kvGRrgf0XXEjSsop5Uic8CP-8ey8Ll7a_CkvB7D3tcpcEgUo0Dbz7N)

احفظ جميع الإعدادات، وانسخ البيانات وانتقل إلى الإعدادات في Mavibot. افتح قسم "Acquiring"، واختر Coinpayments.

<figure><img src="/files/f7768e81a32d6b0aa1400ab07c054be36dbb0239" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/3b7b4cd62b189d5e5bf9238441a38ad535d6713b" alt="" width="563"><figcaption></figcaption></figure>

لإنشاء رابط دفع، تحتاج إلى تعيين قيمة المتغيرات المطلوبة:

<table><thead><tr><th width="201">المتغيرات</th><th width="228">قيمة المتغير</th><th>ملاحظة</th></tr></thead><tbody><tr><td> <strong>original_currency</strong> </td><td>العملة الأصلية للمعاملة.</td><td></td></tr><tr><td><strong>sending_currency</strong></td><td>العملة التي سيرسلها العميل.</td><td>على سبيل المثال، إذا كانت أسعار منتجاتك بالدولار الأمريكي، لكنك تستلم BTC، فيجب عليك استخدام original_currency = USD و sending_currency = BTC. يمكن أن تكون لدى original_currency و sending_currency قيمة واحدة إذا لم تكن هناك حاجة إلى تحويل العملة.</td></tr><tr><td><strong>buyer_email</strong> </td><td>عنوان البريد الإلكتروني للعميل.</td><td>لإرسال إشعارات إذا كان مبلغ الدفع أقل ويحتاج إلى استكماله، أو لعمليات الاسترداد. إذا لم يتم تعيين هذا المتغير، فسيتم أخذ البريد تلقائيًا من متغير email، إذا كان لدى المستخدم واحد في Mavibot.</td></tr></tbody></table>

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

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

**payment\_description** - سيظهر اسم المنتج في صفحة معلومات الدفع وفي IPN للمعاملة.

**buyer\_name** - اسم العميل

هذا هو شكل صفحة الدفع.

![](https://lh3.googleusercontent.com/Yn1a6_JOW4wkj2SqNwkkJYMBZoh4JcR1HEinzP67O6WmYBcCV3IdRw_JCEQI0L7OV-8IuH_JdMEdOaduymc0vs5QAmpfcgrU0tFD9ZrT6V_B8vvQqe-sQcUDMsd9PJRa_uUsJAsX)

## كيفية إنشاء رابط دفع

أنشئ رابط دفع بمبلغ 0.0256

<figure><img src="/files/56fa8dcde27354e83d6c748274cd8050a471d7e7" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
**انتبه:** \
\- أولًا، حدّد عنوان البريد الإلكتروني\
\- ثم المعلمات الاختيارية التالية  **first\_name, payment\_description** وغير ذلك.\
\- أخيرًا، عيّن قيمة لـ **payment\_sum** .
{% endhint %}

يرجى ملاحظة أننا نضبط أولًا متغيرات الإعدادات، ثم **payment\_sum.** يمكن تعيين المتغيرات في وقت أبكر ضمن السلسلة، بدلًا من ذلك في كتلة واحدة، وهذا مثال.

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

<figure><img src="/files/5fc58d01e557182f9c350acff0ce822a72b51eba" alt="" width="563"><figcaption></figcaption></figure>

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

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

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

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

{% hint style="danger" %}
يجب أن يكون نوع المقارنة "Complete Match"
{% endhint %}

أيضًا، بعد الدفع الناجح، يتم تعيين المتغير coinpayments\_payment\_completed إلى True.

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

<figure><img src="/files/f968c36d45c51fd8fe0941752470eed541a89c0b" alt=""><figcaption></figcaption></figure>

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

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

للتحقق من حالة الدفع، استخدم **coinpayments\_get\_payment\_status()** الطريقة في حقل Calculator.

مثال:

<figure><img src="/files/2426bf475d722da08c087c03c7d6ebd318484d53" alt="" width="563"><figcaption></figcaption></figure>

> **مثال على الحالة**:
>
> في انتظار أموال المشتري...
>
> تم استلام الأموال وسيتم تأكيد الإرسال إليك قريبًا…
>
> مكتمل


---

# 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/aldfa/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.