ميركادو باجو

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

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

1. سجّل الدخول إلى Mercado Pago وافتح قسم المطورين (المطورون / عمليات التكامل الخاصة بك).

2. أنشئ تطبيقًا (عمليات التكامل الخاصة بك → إنشاء تطبيق) إذا لم يكن لديك واحد بعد.

3. انسخ رمز الوصول للإنتاج أو رمز الوصول للاختبار — سيتم استخدام هذا الرمز كرمز API الرئيسي.

للحصول على معلومات حول أنواع الرموز وأين تجدها، راجع: بيانات الاعتماد.

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

1. في إعدادات التكامل، افتح Webhooks / الإشعارات القسم (انظر: Webhooks).

2. عيّن عنوان URL للإشعارات:

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

1. اشترك في المدفوعات الأحداث حتى تتمكن من تلقي إشعارات حول إنشاء الدفع وتحديثات الحالة.

2. احفظ سر Webhook — يجب إدخاله في إعدادات التكامل.

الاتصال بـ Mavibot

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

ثم أدخل:

• رمز الوصول — الرمز الذي نسخته.

• سر Webhook — السر المستخدم للتحقق من Webhooks.

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

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

المعلمات	الوصف
! المبلغ	مبلغ الدفع. هذه معلمة مطلوبة.
الوصف	وصف الدفع. هذه معلمة اختيارية.
العملة	رمز العملة ISO (مثل BRL، ARS، MXN، USD، EUR، CLP، COP، PEN، UYU) — اختياري؛ القيمة الافتراضية هي BRL.
البريد الإلكتروني للعميل	بريد العميل الإلكتروني — اختياري.
اسم المنتج البديل	اسم منتج بديل — اختياري؛ إذا لم يتم توفيره، فسيتم استخدام الوصف بدلاً من ذلك.

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

يوضح هذا المثال كيفية تمرير المعلمات إلى الدالة وإرسال رابط الدفع في رسالة.

الدفع عبر زر

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

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

الدفع الناجح

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

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

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

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

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

الخطوة 1

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

هذه هي كتلة البدء مع استدعاء في حقل المشغل

هذه هي كتلة المشغل مع استدعاء في حقل المشغل

الخطوة 2

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

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

الخطوة 3

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

الدفع الفاشل

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

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

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

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

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

يتم إعداد رد الفعل للدفع الفاشل بنفس طريقة إعداد الدفع الناجح.

الخطوة 1

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

الخطوة 2

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

الخطوة 3

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

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

المتغيرات	الوصف
mercado_pago_callback_data	معلومات الدفع المستلمة من نظام الدفع.
mercado_pago_payment_completed	«True» — تمت معالجة الدفع على أنه ناجح.
معرّف دفع Mercado Pago	معرّف الدفع في Mercado Pago