> For the complete documentation index, see [llms.txt](https://docs.mavibot.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mavibot.ai/doc/ar/integrations/payment/myrkadw-bajw.md).

# ميركادو باجو

لاستخدام نظام الدفع Mercado Pago، أكمل الإعدادات أدناه في لوحة معلومات Mercado Pago Developers الخاصة بك ثم أدخل التفاصيل في إعدادات التكامل.

## التطبيق ورمز الوصول

1. سجّل الدخول إلى Mercado Pago وافتح قسم المطورين (**المطورون / عمليات التكامل الخاصة بك**).
2. أنشئ تطبيقًا (**عمليات التكامل الخاصة بك → إنشاء تطبيق**) إذا لم يكن لديك واحد بعد.
3. انسخ **رمز الوصول للإنتاج** أو **رمز الوصول للاختبار** — سيتم استخدام هذا الرمز كرمز API الرئيسي.

<div data-with-frame="true"><figure><img src="/files/0b3c2243d4fdb1e6171caf0466b93bc11ecf27a8" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
للحصول على معلومات حول أنواع الرموز وأين تجدها، راجع: [بيانات الاعتماد.](https://www.mercadopago.com.br/developers/en/docs/your-integrations/credentials)
{% endhint %}

## Webhooks (إشعارات الدفع)

1. في إعدادات التكامل، افتح **Webhooks / الإشعارات** القسم (انظر: [**Webhooks**](https://www.mercadopago.com.br/developers/en/docs/your-integrations/notifications/webhooks)).
2. عيّن عنوان URL للإشعارات:

`https://chatter.mavibot.ai/mercado_pago_callback/result`

3. اشترك في **المدفوعات** الأحداث حتى تتمكن من تلقي إشعارات حول إنشاء الدفع وتحديثات الحالة.
4. احفظ **سر Webhook** — يجب إدخاله في إعدادات التكامل.

<div data-with-frame="true"><figure><img src="/files/18e387fb7dda14790e1845e1c7cd6e229c5ef381" alt=""><figcaption></figcaption></figure></div>

## الاتصال بـ Mavibot

في قسم Acquiring، اختر **Mercado Pago**.

<div data-with-frame="true"><figure><img src="/files/ad91843581e15c0b783b720d3f8cf2e60e0fe1b2" alt=""><figcaption></figcaption></figure></div>

ثم أدخل:

* **رمز الوصول** — الرمز الذي نسخته.
* **سر Webhook** — السر المستخدم للتحقق من Webhooks.

<div data-with-frame="true"><figure><img src="/files/70083eb66386fdeefdc685f3c293f1d44fde7398" alt=""><figcaption></figcaption></figure></div>

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

دالة الحاسبة:\
`get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)`

<table data-header-hidden><thead><tr><th width="241.3828125"></th><th></th></tr></thead><tbody><tr><td>المعلمات</td><td>الوصف</td></tr><tr><td><mark style="color:$danger;"><strong>!</strong></mark><strong> المبلغ</strong></td><td><p><strong>مبلغ الدفع.</strong></p><p>هذه معلمة مطلوبة.</p></td></tr><tr><td><strong>الوصف</strong></td><td><p><strong>وصف الدفع.</strong> </p><p>هذه معلمة اختيارية.</p></td></tr><tr><td><strong>العملة</strong></td><td><strong>رمز العملة ISO</strong> (مثل BRL، ARS، MXN، USD، EUR، CLP، COP، PEN، UYU) — اختياري؛ القيمة الافتراضية هي BRL.</td></tr><tr><td><strong>البريد الإلكتروني للعميل</strong></td><td><strong>بريد العميل الإلكتروني</strong> — اختياري.</td></tr><tr><td><strong>اسم المنتج البديل</strong></td><td><p><strong>اسم منتج بديل</strong> — اختياري؛ </p><p>إذا لم يتم توفيره، فسيتم استخدام الوصف بدلاً من ذلك.</p></td></tr></tbody></table>

تعيد الدالة رابط دفع.

<div data-with-frame="true"><figure><img src="/files/9a1a1d64b7f63e46de0de4889fdabc4ee635c216" alt=""><figcaption><p>يوضح هذا المثال كيفية تمرير المعلمات إلى الدالة وإرسال رابط الدفع في رسالة.</p></figcaption></figure></div>

## الدفع عبر زر

لإرسال زر دفع عبر Mercado Pago، اختر نوع زر يدعم الدفع في منشئ الأزرار واختر **Mercado Pago** كنظام الدفع. أدخل المبلغ والوصف والعملة إذا لزم الأمر.

<div data-with-frame="true"><figure><img src="/files/3350dfa321f243e035594239315ed0f09c15919c" alt=""><figcaption></figcaption></figure></div>

## الاستدعاءات في الحوار بعد الدفع

### **الدفع الناجح**

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

`<أول_10_أحرف_من_سر_Webhook>_success <المبلغ>`

<div data-with-frame="true"><figure><img src="/files/c07f29b33b3a3bdc58047c1eabf0b1fffffa0c19" alt="" width="524"><figcaption></figcaption></figure></div>

**مثال:**\
`gltubgnDle_success 100` — حيث تكون البادئة هي أول 10 أحرف من سر Webhook الخاص بك، و `100` هو مبلغ الدفع.

### كيفية إضافة رد فعل على دفعة ناجحة

لإرسال رسالة إلى عميلك بعد نجاح الدفع (على سبيل المثال، “تمت عملية الدفع بنجاح” أو أي رسالة أخرى)، تحتاج إلى إعداد رد فعل باستخدام كتلة تحتوي على مشغل واستدعاء.

#### الخطوة 1

أنشئ كتلة تحتوي على شرط (كتلة البدء أو كتلة المشغل).

<div data-with-frame="true"><figure><img src="/files/a82e360c01dd2ea2469e00934ab468f07a33f06b" alt=""><figcaption><p>هذه هي كتلة البدء مع استدعاء في حقل المشغل</p></figcaption></figure></div>

<div data-with-frame="true"><figure><img src="/files/67e012ef7d47e079b44336606a22c0cbc8d33c65" alt=""><figcaption><p>هذه هي كتلة المشغل مع استدعاء في حقل المشغل</p></figcaption></figure></div>

#### الخطوة 2

حدد جزءًا من الاستدعاء (إذا كنت بحاجة إلى التفاعل مع جميع المدفوعات، على سبيل المثال عندما يكون لديك عدة منتجات مختلفة)، أو الاستدعاء الكامل (إذا كنت تريد إعداد رد فعل فقط لبيع منتج معين).

<div data-with-frame="true"><figure><img src="/files/422ba62fc1a26e935773a03125f11f24027db94e" alt=""><figcaption><p>إذا كنت بحاجة إلى إعداد رد على أي مدفوعات في المشروع، <br>فاترك جزءًا من الاستدعاء وحدد نوع المطابقة "تطابق الكلمات المفتاحية"</p></figcaption></figure></div>

#### الخطوة 3

الخطوة 3. اكتب رسالة الرد على الدفع الناجح واحفظ الكتلة.

<div data-with-frame="true"><figure><img src="/files/72006c20458e7278a866a16a3cae017aa2223ddc" alt=""><figcaption></figcaption></figure></div>

### الدفع الفاشل

إذا لم تكن عملية الدفع ناجحة (مرفوضة، ملغاة، إلخ، حسب الحالة في API)، فقد يتم إرسال استدعاء بالتنسيق التالي:

`<أول_10_أحرف_من_سر_Webhook>_fail <المبلغ>`

<div data-with-frame="true"><figure><img src="/files/40acc32c776117511387ba46e51639642dec7a20" alt="" width="563"><figcaption></figcaption></figure></div>

**مثال:**\
`gltubgnDle_fail 100` — حيث تكون البادئة هي أول 10 أحرف من سر Webhook الخاص بك، و `100` هو المبلغ.

#### كيفية إضافة رد فعل على دفع فاشل

لإرسال رسالة إلى عميلك بعد عملية دفع غير ناجحة (على سبيل المثال، “فشل الدفع” أو أي رسالة أخرى)، تحتاج إلى إعداد رد فعل باستخدام كتلة تحتوي على مشغل واستدعاء.

{% hint style="info" %}
[يتم إعداد رد الفعل للدفع الفاشل بنفس طريقة إعداد الدفع الناجح.](#how-to-add-a-reaction-to-a-successful-payment)
{% endhint %}

#### الخطوة 1

أنشئ كتلة تحتوي على شرط (كتلة البدء أو كتلة المشغل).

#### الخطوة 2

حدد جزءًا من الاستدعاء (إذا كنت بحاجة إلى التفاعل مع جميع المدفوعات، على سبيل المثال عندما يكون لديك عدة منتجات مختلفة)، أو الاستدعاء الكامل (إذا كنت تريد إعداد رد فعل فقط لبيع منتج معين).

#### الخطوة 3

اكتب رسالة الرد على الدفع الفاشل واحفظ الكتلة.

### متغيرات العميل بعد الدفع الناجح

| المتغيرات                         | الوصف                                   |
| --------------------------------- | --------------------------------------- |
| mercado\_pago\_callback\_data     | معلومات الدفع المستلمة من نظام الدفع.   |
| mercado\_pago\_payment\_completed | «True» — تمت معالجة الدفع على أنه ناجح. |
| معرّف دفع Mercado Pago            | معرّف الدفع في Mercado Pago             |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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/myrkadw-bajw.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.