لاستخدام PagBank كموفر دفع في Mavibot، تحتاج إلى الحصول على رمز وصول (access token) من حساب PagBank الخاص بك وإدخاله في إعدادات الدفع.

الحصول على رمز

بيئة الإنتاج: سجل الدخول إلى حساب PagBank الخاص بك من جهاز كمبيوتر، وانتقل إلى Vendas → Integrações (المبيعات → التكاملات)، وانقر على Gerar token (إنشاء رمز).

بيئة الاختبار (sandbox): سجل الدخول إلى بوابة مطوري PagBank، وافتح علامة التبويب Tokens، وانسخ رمز الاختبار الخاص بك.

يتم عرض الرمز مرة واحدة فقط. قم بتخزينه في مكان آمن: إذا فقدته، ستحتاج إلى إنشاء رمز جديد، وسيتوقف الرمز القديم عن العمل.

لا تحتاج إلى تكوين عنوان URL لإشعار الدفع في حساب PagBank الخاص بك — يوفر Mavibot ذلك تلقائيًا عند إنشاء كل دفعة.

الإعداد

في إعدادات نظام الدفع، حدد PagBank وأدخل:

  • Token — رمز الوصول إلى API من حساب PagBank الخاص بك.
  • وضع الاختبار — قم بتمكين هذا إذا قمت بإدخال رمز اختبار. في وضع الاختبار، يتم إرسال الطلبات إلى sandbox.api.pagseguro.com، ولا يتم خصم أي أموال حقيقية.

اكتمل الإعداد.

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

دالة الآلة الحاسبة:

get_pagbank_payment_url(amount, description, product_name, customer_email, customer_phone, full_name, identity_number)

المعاملات

المعامل الوصف
amount مبلغ الدفع. مطلوب. الحد الأدنى: 1 ريال برازيلي؛ الحد الأقصى: 9,999,999 ريال برازيلي. أدخل المبلغ كـ 100.55، وليس 10055.
description وصف الدفع. اختياري، حتى 255 حرفًا. سيراه العميل على صفحة الدفع.
product_name اسم المنتج، حتى 100 حرف. اختياري؛ يتم استخدام description افتراضيًا.
customer_email عنوان البريد الإلكتروني للعميل. اختياري؛ يتم ملؤه مسبقًا على صفحة الدفع.
customer_phone رقم هاتف العميل. اختياري؛ يتم ملؤه مسبقًا على صفحة الدفع. يقبل PagBank أرقام الهواتف المحمولة البرازيلية فقط: رمز البلد 55، ورمز منطقة مكون من رقمين، ورقم مكون من تسعة أرقام يبدأ بـ 9 (على سبيل المثال، +55 11 99999-8888).
full_name الاسم الأول والأخير للعميل. اختياري؛ يتم ملؤه مسبقًا على صفحة الدفع.
identity_number رقم CPF الخاص بالعميل (11 رقمًا) أو CNPJ (14 رقمًا). اختياري؛ يتم ملؤه مسبقًا على صفحة الدفع.

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

يقبل PagBank تفاصيل العميل فقط كمجموعة كاملة: يجب تقديم الاسم والبريد الإلكتروني ورقم الهاتف وCPF/CNPJ جميعًا. إذا كان أي من هذه الحقول الأربعة مفقودًا، أو إذا كان رقم الهاتف ليس رقم هاتف محمول برازيلي صالحًا، فلن يرسل Mavibot أيًا من تفاصيل العميل إلى PagBank. سيقوم العميل ببساطة بملئها على صفحة الدفع. هذا لا يؤثر على الدفع نفسه.

رابط الدفع في زر

لإرسال زر مع رابط دفع، حدد نوع زر الدفع واختر PagBank كنظام دفع. أدخل اسم المنتج ومبلغ الدفع. إذا لزم الأمر، حدد المتغيرات التي تحتوي على اسم العميل وعنوان بريده الإلكتروني ورقم هاتفه.

ردود الاتصال بعد الدفع

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

A1B2C3D4E5_success 100.55

هنا، A1B2C3D4E5 هي أول 10 أحرف من الرمز الخاص بك، و100.55 هو مبلغ الدفع.

إذا فشل الدفع، سيتم إرسال رد الاتصال التالي:

A1B2C3D4E5_fail 100.55

يتم إرسال رد اتصال الفشل فقط عندما لا يمكن استخدام رابط الدفع بعد الآن: قام البنك برفض الدفع أو إلغائه بشكل دائم، أو انتهت صلاحية رابط الدفع. لا يتم إرسال أي رد اتصال أثناء مراجعة الدفع، أو انتظار دفع boleto، أو تفويضه ولكن لا يزال معلقًا على البطاقة، نظرًا لأن رابط الدفع لا يزال نشطًا. لا يحتوي رابط الدفع منتهي الصلاحية على دفعة مرتبطة به، لذلك لن يتضمن رد الاتصال مبلغًا.

للتعامل مع الدفع الناجح أو الفاشل، اتبع هذه الخطوات:

  1. قم بإنشاء كتلة مع مشغل (كتلة Trigger رمادية أو كتلة Start خضراء — استخدم الكتلة الخضراء إذا كنت تريد متابعة بناء مسار التحويل بعد الدفع).
  2. في حقل Trigger، أدخل رد الاتصال بدون مبلغ الدفع:
A1B2C3D4E5_success

استخدم هذا الخيار إذا كنت تريد أن تتفاعل الكتلة مع كل دفعة ناجحة.

اضبط نوع المطابقة على Keyword Match.

بدلاً من ذلك، أدخل رد الاتصال الكامل:

A1B2C3D4E5_success 100.55

استخدم هذا الخيار إذا كنت تريد أن تتفاعل الكتلة فقط مع دفعة بمبلغ محدد.

اضبط نوع المطابقة على Exact Match.

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

المتغير القيمة
pagbank_callback_data معلومات الدفع المستلمة من نظام الدفع
pagbank_payment_completed "True" — تمت معالجة الدفع بنجاح
pagbank_order_id معرف طلب PagBank (ORDE_…)
pagbank_charge_id معرف الشحنة PagBank (CHAR_…)
pagbank_payment_method طريقة الدفع: CREDIT_CARD، DEBIT_CARD، PIX، أو BOLETO