يتيح لك تكامل PayTR قبول المدفوعات عبر PayTR، وهو مزود خدمة دفع تركي. يكمل العملاء مدفوعاتهم على صفحة الدفع الآمنة لـ PayTR، حيث يمكنهم استخدام البطاقات المصرفية التركية وطرق الدفع المحلية الأخرى.

الحصول على بيانات اعتماد التكامل

قبل توصيل PayTR، قم بتوقيع اتفاقية مع PayTR واحصل على الوصول إلى حساب التاجر الخاص بك.

في القائمة اليسرى، افتح Bilgi (معلومات) وابحث عن قسم API Entegrasyon Bilgileri. انسخ القيم التالية:

لوحة تحكم PayTR حقل Mavibot
Mağaza No معرف التاجر (merchant_id)
Mağaza Anahtarı مفتاح التاجر (merchant_key)
Mağaza Şifresi ملح التاجر (merchant_salt)

ملاحظة: بيانات الاعتماد هذه متاحة فقط لـ المستخدم الرئيسي (Ana Kullanıcı) والمسؤول الفني (Teknik Sorumlu). إذا لم تتمكن من رؤية هذا القسم، فاطلب من مالك الحساب الرئيسي منحك الأذونات المطلوبة.

لا تحتاج إلى تكوين عنوان URL لإشعار الدفع (رد الاتصال) في لوحة تحكم PayTR. يرسل Mavibot تلقائيًا عنوان URL لرد الاتصال مع كل طلب رابط دفع.

توصيل PayTR

افتح إعدادات الاستحواذ (Acquiring) في Mavibot واختر PayTR.

أدخل بيانات الاعتماد التالية:

  • معرف التاجر (merchant_id) — Mağaza No الخاص بك
  • مفتاح التاجر (merchant_key) — Mağaza Anahtarı الخاص بك
  • ملح التاجر (merchant_salt) — Mağaza Şifresi الخاص بك

احفظ الإعدادات لإكمال التكامل.

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

استخدم وظيفة الآلة الحاسبة:

get_paytr_payment_url(amount, description, currency, customer_email, product_name, expired, language)

المعلمات

المعلمة مطلوب الوصف
amount ✅ مبلغ الدفع.
description لا وصف الدفع (المنتج أو الخدمة). يظهر على صفحة دفع PayTR.
currency لا عملة الدفع: TL، USD، EUR، GBP، أو RUB. الافتراضي: TL.
customer_email لا عنوان البريد الإلكتروني للعميل.
product_name لا اسم المنتج المعروض على صفحة الدفع.
expired لا عمر رابط الدفع بالثواني. إذا تم حذفه، لا ينتهي صلاحية الرابط أبدًا.
language لا لغة صفحة الدفع: tr (تركية) أو en (إنجليزية). الافتراضي: tr.

تقوم الوظيفة بإرجاع عنوان URL للدفع.

ملاحظات

  • يتم تحويل رمز العملة TRY تلقائيًا إلى TL.
  • إذا تم تحديد عملة غير مدعومة، يتم استخدام TL تلقائيًا.
  • يجب أن يحتوي اسم المنتج على 4–200 حرف.
    • يتم تبطين الأسماء الأقصر من 4 أحرف بنقاط (.).
    • يتم اقتطاع الأسماء الأطول من 200 حرف تلقائيًا.

مثال

الخطوة 1

أنشئ رسالة تطلب من العميل إدخال عنوان بريده الإلكتروني.

الخطوة 2

أنشئ الكتلة التالية أسفل الرسالة وافتح إعدادات السهم.

قم بتكوين الاتصال على النحو التالي:

  • نوع المطابقة: تعبير عادي
  • قم بتمكين خيار إدخال المستخدم للبيانات.
  • أدخل اسم المتغير: customer_email

احفظ إعدادات الاتصال.

الخطوة 3

أدخل معلمات الوظيفة في الآلة الحاسبة.

إنشاء زر دفع

لإرسال زر دفع في Mavibot:

  1. أنشئ الكتلة التي تحتوي على زر.

  1. اختر نوع الفوترة (Billing).
  2. اختر PayTR كمزود الدفع.
  3. حدد:
    • اسم المنتج
    • مبلغ الدفع
    • العملة
  4. اختياريًا، قدم المتغير الذي يحتوي على عنوان البريد الإلكتروني للعميل.

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

بعد أن يكمل العميل الدفع، يتلقى Mavibot رد اتصال وينشره في المحادثة.

الدفع الناجح

SDJ91MTKTT_success 100

حيث:

  • SDJ91MTKTT هي أول 10 أحرف من مفتاح التاجر (merchant_key) الخاص بك.
  • 100 هو مبلغ الدفع.

للتفاعل مع المدفوعات الناجحة أو الفاشلة، انسخ قيمة رد الاتصال وأنشئ كتلة بدء (Start) (أو كتلة مشغل).

أدخل نص رد الاتصال في المشغل.

ثم أنشئ رسالة تخبر العميل ما إذا كان الدفع ناجحًا أم فاشلاً.

من هذه الكتلة، يمكنك متابعة تدفق chatbot الخاص بك حسب الحاجة.

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

الدفع الفاشل

SDJ91MTKTT_fail 100

ملاحظة: روابط دفع PayTR هي للاستخدام الفردي. بعد الدفع الناجح، يتم إلغاء تنشيط الرابط تلقائيًا. قم بإنشاء رابط دفع جديد لكل دفعة جديدة.

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

المتغير الوصف
paytr_callback_data معلومات الدفع المستلمة من PayTR.
paytr_payment_completed "True" إذا تمت معالجة الدفع بنجاح.
paytr_merchant_oid معرف معاملة PayTR (merchant_oid).