لاستخدام نظام الدفع Mercado Pago، أكمل الإعدادات أدناه في لوحة تحكم Mercado Pago Developers ثم أدخل التفاصيل في إعدادات التكامل.
التطبيق ورمز الوصول
- سجّل الدخول إلى Mercado Pago وافتح قسم المطورين (Developers / Suas integrações).
- أنشئ تطبيقًا (Your integrations → Create application) إذا لم يكن لديك واحد بعد.
- انسخ رمز الوصول للإنتاج أو رمز الوصول للاختبار — سيُستخدم هذا الرمز كرمز API الرئيسي.
للحصول على معلومات حول أنواع الرموز وأين تجدها، راجع: Credentials.
Webhooks (إشعارات الدفع)
- في إعدادات التكامل، افتح قسم Webhooks / уведомления (راجع: Webhooks).
- عيّن رابط الإشعار:
https://chatter.mavibot.ai/mercado_pago_callback/result
- اشترك في أحداث Payments لتلقي الإشعارات حول إنشاء الدفع وتحديثات الحالة.
- احفظ سر Webhook — يجب إدخاله في إعدادات التكامل.
الاتصال بـ Mavibot
في قسم الاستحواذ (Acquiring)، اختر Mercado Pago.
ثم أدخل:
- رمز الوصول — الرمز الذي نسخته.
- سر Webhook — السر المستخدم للتحقق من webhooks.
إنشاء رابط الدفع
دالة الآلة الحاسبة:
get_mercado_pago_payment_url(amount, description, currency, customer_email, product_name)
ترجع الدالة رابط دفع.
الدفع عبر الزر
لإرسال زر دفع عبر Mercado Pago، اختر نوع زر مع دعم الدفع في منشئ الأزرار واختر Mercado Pago كنظام دفع. أدخل المبلغ والوصف والعملة إذا لزم الأمر.
ردود الاتصال في الحوار بعد الدفع
الدفع الناجح
بعد أن يتبع العميل الرابط ويكمل الدفع بنجاح، قد يتم إرسال رد اتصال إلى الحوار بالتنسيق التالي:
<أول_10_أحرف_من_سر_Webhook>_success <المبلغ>
مثال:
gltubgnDle_success 100 — حيث البادئة هي أول 10 أحرف من سر Webhook الخاص بك، و100 هو مبلغ الدفع.
كيفية إضافة رد فعل على الدفع الناجح
لإرسال رسالة إلى عميلك بعد الدفع الناجح (على سبيل المثال، "تم الدفع بنجاح" أو أي رسالة أخرى)، تحتاج إلى إعداد رد فعل باستخدام كتلة مع مشغل ورد اتصال.
الخطوة 1
أنشئ كتلة بشرط (كتلة البداية أو كتلة المشغل).
الخطوة 2
حدد جزءًا من رد الاتصال (إذا كنت بحاجة إلى التفاعل مع جميع المدفوعات، على سبيل المثال عندما يكون لديك عدة منتجات مختلفة)، أو رد الاتصال الكامل (إذا كنت تريد إعداد رد فعل فقط لبيع منتج معين).
الخطوة 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_payment_id | معرف الدفع في Mercado Pago |