Telr

05-08-2026

في هذه الصفحة

ربط Telr

لاستخدام نظام الدفع Telr في MaviBot، يجب الحصول على بيانات اعتماد متجرك من حساب Telr الخاص بك وإدخالها في إعدادات نظام الدفع.

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

في المتاجر → تفاصيل المتجر، انسخ القيم التالية:

حقل Telr	حقل MaviBot
معرف المتجر	معرف المتجر
مفتاح المصادقة	مفتاح المصادقة

افتح صفحة الدفع (أو الأمان) → إشعار المعاملة وحدد عنوان URL للإشعار التالي:

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

حدد أنواع المعاملات التي ترغب في تلقي الإشعارات بشأنها.

في نفس القسم، انسخ المفتاح السري. يُستخدم هذا المفتاح للتحقق من توقيعات الإشعارات.

مهم! تكوين إشعار المعاملة إلزامي. بدونه، لن يتلقى MaviBot إشعارات الدفع، ولن يتم إرسال أي رد اتصال إلى البوت.

افتح أنظمة الدفع في إعدادات مشروعك، واختر Telr، واملأ الحقول التالية:

الحقل	الوصف
معرف المتجر	المعرف الرقمي لمتجر Telr الخاص بك.
مفتاح المصادقة	يُستخدم لإنشاء روابط الدفع.
المفتاح السري	يُستخدم للتحقق من توقيعات إشعارات الدفع. بدونه، سيتم رفض إشعارات الدفع.
وضع الاختبار	يتيح إجراء مدفوعات اختبارية باستخدام بطاقات اختبار Telr دون خصم أموال حقيقية. قم بتعطيل هذا الخيار لقبول المدفوعات الحقيقية.

بمجرد اكتمال جميع الحقول، يكون التكامل جاهزًا للاستخدام.

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

get_telr_payment_url(amount, description, currency, product_name)

المعامل	الوصف
`amount`	مبلغ الدفع. مطلوب.
`description`	وصف الدفع. اختياري. الحد الأقصى للطول: 63 حرفًا.
`currency`	رمز العملة المكون من ثلاثة أحرف (`AED`، `SAR`، `USD`، `EUR`، `GBP`، وعملات أخرى متاحة لحساب Telr الخاص بك). اختياري. القيمة الافتراضية: `AED`.
`product_name`	اسم المنتج. اختياري.

تقوم الدالة بإرجاع رابط الدفع.

مهم! تظل روابط الدفع صالحة لفترة زمنية محدودة. أرسل الرابط إلى العميل فور إنشائه.

مثال

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

بعد أن يكمل العميل الدفع، يتلقى MaviBot تلقائيًا رد اتصال.

مثال:

SDJ91MTKTT_success 100

حيث:

مثال:

SDJ91MTKTT_fail 100

إذا تم تفويض الدفع ولكن تم تعليقه من قبل البنك للتحقق الإضافي، فلن يتم إرسال أي رد اتصال حتى اكتمال المراجعة.

بمجرد موافقة البنك على المعاملة أو رفضها، يرسل Telr إشعارًا، ويتم تسليم رد الاتصال إلى MaviBot تلقائيًا.

المتغير	الوصف
`telr_callback_data`	معلومات الدفع المستلمة من نظام دفع Telr.
`telr_payment_completed`	`"True"` إذا تمت معالجة الدفع بنجاح.
`telr_tran_ref`	مرجع معاملة Telr (`tran_ref`).