Prodamus (KZ)

كيفية ربط بروداموس

لربط Prodamus، ستحتاج إلى عنوان URL لنموذج الدفع والمفتاح السري.

يتم إصدار عنوان URL لنموذج الدفع بعد التسجيل، ومثاله: demo.payform.ru.

يمكن الحصول على المفتاح السري من الحساب الشخصي، وهناك أيضًا يجب تحديد عنوان URL الذي ستُرسل إليه الإشعارات (notification).

المفتاح السري في إعدادات نموذج الدفع داخل الحساب الشخصي لنظام الدفع «بروداموس»

دليل مفصل حول كيفية القيام بذلك

عنوان الإشعارات: https://chatter.mavibot.ai/prodamus_callback/result

يجب تحديد هذا العنوان في الإعدادات في مكانين.

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

يجب تحديد عنوان الإشعارات في إعدادات نظام الدفع في مكانين: «إعداد النموذج» في تبويب — للمدفوعات لمرة واحدة (العادية) و «الاشتراكات» في تبويب — لمدفوعات الاشتراك.

عنوان الإشعارات: https://chatter.mavibot.ai/prodamus_callback/result

لإعداد العمل مع مدفوعات الاشتراك، «الاشتراكات» اذهب إلى التبويب وحدد عنوان الإشعارات:

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

انتبه! بعد إدخال عنوان URL، لا بد من «حفظ» الضغط على الزر.

لربط Prodamus، «التحصيل» يجب الانتقال إلى قسم.

بعد ذلك يكفي إدخال البيانات المذكورة أعلاه في النموذج:

مهم! عند تحديد عنوان URL لنموذج الدفع، https:// لا تضف.

بهذا يكتمل الربط. الآن لنرَ كيف نستخدم هذه الوظيفة.

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

زر مع وظيفة «الدفع»

يمكن إنشاء رابط للدفع في زر يحتوي على وظيفة «الدفع».

تم شرح كيفية إنشاء مثل هذا الزر في هذه المقالة.

والآن لنستعرض جميع الإعدادات الممكنة لهذا الزر.

الإعدادات الإلزامية لزر «الدفع» في Prodamus

لإنشاء رابط للدفع يجب تحديد الإعدادات الإلزامية في إعدادات الزر: «المبلغ»، «اسم المنتج»، وكذلك خيار «المحتوى المدفوع» — إذا لم يكن لديك صندوق نقدي إلكتروني خاص بك وتريد الحصول على إيصال من Prodamus.

عند الانتقال إلى صفحة إتمام الطلب، تُعرض مسبقًا معلومات المنتج وسعره، بينما يُدخل العميل بيانات الاتصال الخاصة به فقط.

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

نافذة إعدادات الزر

حقل «النص» — سيظهر هذا النص في الرسالة على الزر الذي يحتوي على رابط الدفع.

حقل «الوظيفة» — لإنشاء زر يوفّر رابط دفع نختار وظيفة «الدفع».

حقل «نظام الدفع» — ستظهر أنظمة الدفع المتصلة بالمشروع في القائمة. إذا لم تكن أي منظومة دفع متصلة بالمشروع، فسيكون هذا النوع من الأزرار غير متاح.

حقل «اسم المنتج» (إلزامي) — يجب تحديد الاسم الدقيق للمنتج. مثال: ليس «هاتف»، بل «هاتف Xiaomi، الموديل …». ملاحظة: لا يجوز استخدام علامات الاقتباس المزدوجة في اسم المنتج؛ احذفها أو استبدلها بعلامة اقتباس مفردة.

حقل «المبلغ» (إلزامي) — نحدد سعر المنتج.

قائمة «معلومات إضافية» — عند النقر على هذا الزر تُفتح حقول إضافية لإنشاء الرابط:

• وصف الطلب

• الخصم بالروبل

• متغير بريد Email للمشتري

• متغير رقم هاتف المشتري

• مدة صلاحية الرابط

• معرّف المنتج للاشتراك (للتحصيل التلقائي)

• المحتوى المدفوع

خانة اختيار «إشعار عند النقر» — يمكن تحديدها لمراقبة الانتقال إلى رابط الدفع. في هذه الحالة، عند الضغط على الزر تصل رسالة إلى محادثة العميل في SAILBOT تفيد بأنه تم الانتقال إلى الرابط.

بناءً على هذه الرسالة يمكن إعداد منطق العمل اللاحق للروبوت. تدعم العديد من أنظمة الدفع صناديق النقد السحابية عبر الإنترنت، وهي مطلوبة وفقًا لمتطلبات 54-ФЗ.

اقرأ على موقع نظام الدفع المختار عن خصائص إصدار الإيصالات، حتى لا تقع في مشاكل مع مصلحة الضرائب.

هكذا تبدو صفحة الدفع التي تُفتح عند الانتقال عبر الرابط في زر «الدفع»:

صفحة الدفع: في الزر تم ملء الإعدادات الأساسية فقط

إعدادات إضافية لإنشاء رابط دفع

حقل «وصف الطلب» — ستظهر المعلومات المُدخلة في هذا الحقل في صفحة الدفع البيانات الإضافية الحقل.

حقل «الخصم» — هنا يمكن تحديد مبلغ الخصم بالروبل أو بالروبل والكوبيك. وللإشارة إلى الكوبيك استخدم النقطة كفاصل: 50.99 في صفحة الدفع، المبلغ المستحق سيُعرض مع احتساب الخصم، بينما سيُشطب سعر المنتج الأساسي.

حقل «متغير بريد Email للمشتري» (اختياري إذا تم تحديد رقم الهاتف) — هنا يُكتب بريد Email الخاص بالمستخدم (العميل). يمكن أيضًا استخدام متغير محفوظ للبريد، مثل: #{email}

حقل «متغير رقم هاتف المشتري» (اختياري إذا تم تحديد Email) — هنا يمكن استخدام متغير يحتوي على رقم هاتف المشتري، بالصيغة: 79000000000، مثل: #{phone} يجب أن يكون هناك بريد Email و/أو رقم هاتف بالضرورة.

حقل «مدة صلاحية الرابط» — يمكن تحديد التاريخ بصيغة dd.mm.yyyy hh:mm (مثلًا، 25.01.2021 11:00) أو تعيين انتهاء الرابط عبر متغير. مثلًا: #{link_expired}

حقل «معرّف المنتج للاشتراك» — أدخل قيمة معرّف المنتج لإنشاء التحصيل التلقائي. لإنشاء الاشتراك يجب إنشاء منتج اشتراكي. دليل كامل: إنشاء وإعداد اشتراكات Prodamus إذا تم تمرير معرّف المنتج للاشتراك، فلن يُؤخذ مبلغ الدفع بعين الاعتبار. تُؤخذ معلومات المنتج من بطاقة المنتج في حساب Prodamus. رقم الهاتف المحدد في الدفع سيكون مطلوبًا لإدارة الاشتراك. إذا تم تمرير معرّف المنتج للاشتراك، فسيتم تمرير معرّف هذا المنتج في callback عند نجاح الدفع.

حقل «المحتوى المدفوع» (إلزامي بشكل مشروط) — هذه البيانات مطلوبة لفَسْلَنة الدفع عبر Prodamus إذا لم يكن لديك صندوق نقدي إلكتروني خاص بك. في هذا الحقل تُذكر وصف عملية الشراء والسعر ورابط المحتوى. مثلًا: دورة «جدل الضفائر»، السعر 3000 روبل، رابط صفحة الدورة: https://nbu.su/krasota/master-po-pleteniyu-kos/?yclid=13602995275739430911

زر مع وظيفة «الدفع»

إذا حددت مدة صلاحية الرابط، فسيحدث ما يلي: إذا طلب المستخدم رابط الدفع خلال فترة صلاحيته (أي قبل انتهاء وقت الرابط) وكان داخل المحادثة، فلن يكون الدفع ممكنًا، وستظهر له الرسالة التالية:

يجب أن تكون مدة صلاحية الرابط بعد التاريخ الحالي، وإلا فلن يتمكن العميل من الدفع عبر هذا الرابط.

2. عندما يطلب المستخدم الرابط، إذا لم يكن نشطًا حاليًا في هذه الحالة لن يظهر الزر ببساطة. في متغيرات العميل "error_payment_button" سيظهر المتغير، وستكون قيمته كالتالي: "خطأ: يجب أن تكون مدة صلاحية الرابط بعد التاريخ الحالي".

حتى يتمكن المستخدم من إتمام الدفع بشكل صحيح، يُنصح بمعالجة مثل هذه الحالة بشكل إضافي.

أنشئ كتلة شرطية من هذا النوع: إذا وصلت الرسالة التالية: error_payment_button == "خطأ: يجب أن تكون مدة صلاحية الرابط بعد التاريخ الحالي"

فأظهر النص التالي: "عذرًا، لم تتمكن من الدفع في الوقت المحدد، كان رابط الدفع غير صالح".

متغيرات العميل التي تُنشأ تلقائيًا عند استخدام زر بوظيفة «الدفع»

عندما يحصل المستخدم على كتلة تحتوي على زر «الدفع»، تُنشأ تلقائيًا متغيرات للعميل:

متغير عميل خدمي __payments — هذا المتغير يخزن المبلغ ومعرّف الرابط الذي تم إنشاؤه، وهو ضروري لتحديد الـ webhook القادم من نظام الدفع.

متغير عميل خدمي __paymentsلا يجوز حذفه أو تغييره!

error_payment_button متغير العميل يُنشأ تلقائيًا إذا حدث خطأ عند إنشاء الزر. في هذا المتغير يُكتب نص الخطأ أو الرد الخطأ القادم من نظام الدفع.

تكون قيم المتغيرات محدثة عند الانتقال إلى الكتلة التالية.

كيف نعالج النتيجة

دفع ناجح بعد نجاح الدفع، يصل إلى الروبوت CALLBACK تلقائي يتكوّن من أول 10 أحرف من المفتاح السري لنظام الدفع، _success وكلمة وومبلغ الدفع. يكفي نسخه لاستخدامه في إعداد المخطط.

مثال: ovg58keefc_success 44، حيث:

• ovg58keefc — أول 10 أحرف من المفتاح السري لنظام الدفع

• _success — نتيجة معالجة الطلب (دفع ناجح)

• 44 — مبلغ الدفع

المستخدم لا يرى callbacks. فهي تظهر فقط في «العملاء» وتكون مرئية للمشغّل.

مثال على الاستخدام: الخطوة 1. نضيف الأزرار ذات وظيفة «الدفع» إلى كتلة «زر مع الدفع». الخطوة 2. في حقل شرط الربط الذي ينتقل من هذه الكتلة إلى كتلة «الدفع الناجح»، نحدد callback. وبالمثل، إذا حددت callback الدفع الناجح في شرط كتلة «الشرط الابتدائي»، فسيتم التنفيذ بالطريقة نفسها.

مهم: اختيار «تطابق تام» أو «حسب وجود الكلمات الأساسية».

❗️إذا قررت التحقق من الدفع في السهم المحدد بالشرط نفسه، ففكّر جيدًا في منطق المخطط الخاص بك. إذا غادر العميل الكتلة التي يجب أن يمر منها وفقًا للـ callback، فلن يحدث الانتقال إلى الكتلة. من الأفضل استخدام هذا النوع من التحقق فقط عندما لا يغيّر العميل موقعه في القمع.

في المخططات التي يتحرك فيها العميل بين الكتل، يكون من الأنسب استخدام «الشرط الابتدائي» مع تحديد callback في الكتلة.

Callback للدفعة الناجحة في حقل شرط الكتلة.

دفع ناجح للمنتجات ذات الاشتراك التلقائي

بعد نجاح الدفع، يصل إلى الروبوت CALLBACK تلقائي يتكوّن من أول 10 أحرف من المفتاح السري لنظام الدفع، _success وكذلك من معرّف منتج الاشتراك.

مثال: 214009eefc_success 618117، حيث:

• 009eefc — أول 10 أحرف من المفتاح السري لنظام الدفع

• _success — نتيجة معالجة الطلب (دفع ناجح)

• 618117 — معرّف منتج الاشتراك

مثال على callback من Prodamus للمنتجات ذات الاشتراك التلقائي

دفع خاطئ في حالة حدوث خطأ أثناء تنفيذ الدفع، يصل إلى الروبوت CALLBACK تلقائي يتكوّن من أول 10 أحرف من المفتاح السري لنظام الدفع، _fail وكلمة ومبلغ الدفع.

مثال: ovg58keefc_fail 44، حيث:

• ovg58keefc — أول 10 أحرف من المفتاح السري لنظام الدفع

• _fail — نتيجة معالجة الطلب (لم يتم الدفع أو حدث خطأ)

• 44 — مبلغ الدفع

هذا يعتمد على نظام الدفع. ليست كل أنظمة الدفع ترسل callback خاصًا بخطأ الدفع.

إذا كان المبلغ المحدد في إعدادات الزر يختلف عن المبلغ الذي دفعه العميل، فسيصل إلى الروبوت CALLBACK تلقائي يصل. ويتكوّن من أول 10 أحرف من المفتاح السري لنظام الدفع، _different_amounts وكلمة ومعرّف الدفع الفريد.

مثال: ovg58keefc_different_amounts 123456، حيث:

• ovg58keefc — أول 10 أحرف من المفتاح السري لنظام الدفع

• _different_amounts — نتيجة معالجة الطلب (مبلغ الدفع يختلف عن مبلغ الرابط)

• 123456 — معرّف الدفع الفريد

في الحاسبة get_prodamus_payment_url الدالة

لإنشاء رابط الدفع في كتلة الحاسبة get_prodamus_payment_url الدالة يمكن استخدامها. في حقل الحاسبة نُسند إلى المتغير قيمة هذه الدالة: get_prodamus_payment_url.

يمكنك اختيار اسم المتغير بنفسك. وتُعرض في لقطات الشاشة أمثلة على تسمية المتغيرات.

يُكتب في هذا المتغير رابط الدفع. ويمكن عرض المتغير كرابط في الرسالة أو وضعه في زر يحتوي على نص «الدفع».

مثال على رابط الدفع: https://payform.kz/7p3JR8/

الحاسبة

مثال 1:

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

مثال

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

يُكتب الخطأ في الحاسبة وفقًا لآخر دالة.

payment_sum إنشاء الرابط عبر المتغير والمعلمات الإضافية

انتبه: payment_sum تُسند القيمة إلى المتغير من آخر متغير، أي بعد المتغيرات غير الإلزامية: payment_description, product_name وغيرها.

لإنشاء رابط الدفع في حقل الحاسبة payment_sum يكفي تعيين قيمة المتغير. بعد ذلك، تلقائيًا prodamus_pay_url سيظهر المتغير.

مثال على رابط الدفع: https://payform.ru/7p3JR8/

يمكن عرض هذا المتغير كرابط في الرسالة أو وضعه في زر يحتوي على نص «الدفع».

payment_sum قبل الإعلان عن المتغير، يمكن تحديد المتغيرات غير الإلزامية التالية:

معلمات الدالة	وصف المعلمة
product_name	اسم المنتج (إذا لم يُذكر، فسيُملأ تلقائيًا بـ "دفع الفاتورة order_id'، ويوضح لقطة الشاشة أدناه أين يظهر).
payment_description	وصف المنتج (إذا لم يُذكر، فسيُملأ تلقائيًا بـ 'دفع الفاتورة order_id' سيُملأ) – وتوضح لقطة الشاشة أدناه أين يظهر.
discount_value	مقدار الخصم (مثلًا، discount_value = 25 أو discount_value = 50.25)
customer_phone	رقم هاتف المشتري — اختياري إذا تم تمرير معلمة أخرى.
customer_email	بريد Email الخاص بالمشتري
link_expired	مدة صلاحية رابط الدفع — بصيغة dd.mm.yyyy (مثلًا، 25.01.2021). كما يمكن، الحاسبة في الحقل link_expired = current_date + 2 (سيكون الرابط صالحًا لمدة يومين حتى الساعة 00:00).
link_expired	كما يمكن تحديد وقت دقيق، الصيغة: بصيغة dd.mm.yyyy hh:mm (مثلًا، 25.01.2021 12:23). يمكن أيضًا استخدام المتغيرات القياسية، مثل تعيين صلاحية الرابط لمدة 30 دقيقة: time = current_time + 30 link_expired = "#{current_date} #{time}"
currency	عملة الدفع، افتراضيًا "rub". القائمة الكاملة للوسائط: rub usd eur kzt يجب تمرير هذه المعلمة بأحرف صغيرة.
payment_title	عنوان الدفع (حتى 127 حرفًا). إذا لم يُذكر، فسيُملأ تلقائيًا بالنص التالي: “دفع الفاتورة payment_id” (payment_id — معرّف الطلب في MaviBot).
payment_description	وصف مختصر للدفع (حتى 127 حرفًا)
locale	لغة صفحة الدفع — en-US, fr-XC وغيرها من الصيغ. القيمة الافتراضية هي ru-RU. يمكن الاطلاع على القائمة الكاملة عبر هذا الرابط
products_for_receipt	سلسلة من 50 إلى 4000 حرف بصيغة "وصف الطلب - السعر - رابط المورد الذي يتم شراؤه". مثلًا: “دورة ‘صيد البلم’, السعر 4999 تينغي، رابط صفحة الدورة: https://www.lovilescha.ru/courses/poimai_kilogram/" هذه معلمة إلزامية مطلوبة لفَسْلَنة الدفع عبر Prodamus إذا لم يكن لديك صندوق نقدي إلكتروني خاص بك.
payment_sum	(إلزامي) مبلغ الدفع

discount_value, customer_phone, customer_email و link_expired المتغيرات ذات صلة أيضًا بالاشتراكات.

مثال على التنفيذ. في الكتلة الأولى نحدد مبلغ الدفع:

في الخطوة التالية، في المكان المطلوب prodamus_pay_url نعرض الرابط:

prodamus_available_payment_methods المتغير payment_sum يُعرَّف قبل الإعلان عن. القيم الممكنة:

AC	الدفع باستخدام بطاقة صادرة في روسيا
ACkz	الدفع باستخدام بطاقة كازاخستانية
ACf	الدفع باستخدام بطاقات دول رابطة الدول المستقلة، باستثناء روسيا
ACEURNMBX	الدفع باستخدام بطاقات EUR لجميع البلدان باستثناء روسيا وروسيا البيضاء
SBP	دفع سريع دون إدخال بيانات البطاقة. للبطاقات الروسية
QW	محفظة Qiwi
PC	Юmoney
GP	طرفية دفع
sbol	سبيربنك أونلاين
invoice	الدفع وفقًا للفاتورة
installment	التقسيط عبر Prodamus
installment_5_21	تقسيط لمدة 3 أشهر عبر Prodamus
installment_6_28	تقسيط لمدة 6 أشهر عبر Prodamus
installment_10_28	تقسيط لمدة 10 أشهر عبر Prodamus
installment_12_28	تقسيط لمدة 12 شهرًا عبر Prodamus
installment_0_0_3	التقسيط لمدة 3 أشهر عبر Tinkoff
installment_0_0_4	تقسيط لمدة 4 أشهر عبر Tinkoff
installment_0_0_6	تقسيط لمدة 6 أشهر عبر Tinkoff
installment_0_0_10	تقسيط لمدة 10 أشهر عبر Tinkoff
installment_0_0_12	تقسيط لمدة 12 شهرًا عبر Tinkoff
installment_0_0_24	تقسيط لمدة 24 شهرًا عبر Tinkoff
installment_0_0_36	تقسيط لمدة 36 شهرًا عبر Tinkoff
credit	قرض عبر Tinkoff
vsegdada_installment_0_0_4	تقسيط لمدة 4 أشهر عبر «ВсегдаДа» (لا يعمل مع available_payment_methods)
vsegdada_installment_0_0_6	تقسيط لمدة 6 أشهر عبر «ВсегдаДа»
vsegdada_installment_0_0_10	تقسيط لمدة 10 أشهر عبر «ВсегдаДа»
vsegdada_installment_0_0_12	تقسيط لمدة 12 شهرًا عبر «ВсегдаДа»
vsegdada_installment_0_0_24	تقسيط لمدة 24 شهرًا عبر «ВсегдаДа»
vsegdada_installment_0_0_36	تقسيط لمدة 36 شهرًا عبر «ВсегдаДа»
sbrf_installment_0_0_6	تقسيط لمدة 6 أشهر عبر سبيربنك
sbrf_installment_0_0_10	تقسيط لمدة 10 أشهر عبر سبيربنك
sbrf_installment_0_0_12	تقسيط لمدة 12 شهرًا عبر سبيربنك
sbrf_installment_0_0_24	تقسيط لمدة 24 شهرًا عبر سبيربنك
sbrf_installment_0_0_36	تقسيط لمدة 36 شهرًا عبر سبيربنك
otp_installment_0_0_6	تقسيط لمدة 6 أشهر عبر «بنك OTP»
otp_installment_0_0_10	تقسيط لمدة 10 أشهر عبر «بنك OTP»
otp_installment_0_0_12	تقسيط لمدة 12 شهرًا عبر «بنك OTP»
otp_installment_0_0_24	تقسيط لمدة 24 شهرًا عبر «بنك OTP»
otp_installment_0_0_36	تقسيط لمدة 36 شهرًا عبر «بنك OTP»
mts_installment_0_0_6	تقسيط لمدة 6 أشهر عبر «بنك MTS»
mts_installment_0_0_10	تقسيط لمدة 10 أشهر عبر «بنك MTS»
mts_installment_0_0_12	تقسيط لمدة 12 شهرًا عبر «بنك MTS»
mts_installment_0_0_24	التقسيط لمدة 24 شهرًا عبر «بنك MTS»
mts_installment_0_0_36	التقسيط لمدة 36 شهرًا عبر «بنك MTS»
monetaworld	بطاقات البنوك العالمية، باستثناء روسيا
sbrf_bnpl	التقسيط عبر سبير

قيمة متعددة بواسطة الخط العمودي يُسمح بالتقسيم. مثال:

prodamus_available_payment_methods = "AC|PC|QW"

prodamus_currency — هذا معلمة إضافية أخرى تتيح عرض المبلغ بعملة معينة.

العملات الممكنة:

• kzt — للتيينغي

• eur — لليورو

• usd — للدولار

وبالتالي، سيكون المبلغ المحدد في الرابط بالعملة المختارة.

Callback payment_callback عند الاستلام currency و currency_sum يجب الانتباه إلى المعلمات، حيث يتم فيها تحديد العملة والمبلغ.

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

كيف نعالج النتيجة

دفع ناجح

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

تبدو ردود callback في النظام مثل الرسائل الواردة من المستخدم، لكن المستخدم لا يمكنه إرسالها. تكون على شكل تركيبة من المفتاح السري والحالة. مثال:

453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_success

أو

453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66_fail

بعد الدفع الناجح prodamus_payment_completed المتغير True تلقائيًا.

ملاحظة: تصل ردود callback متأخرة قليلًا، لذا من الأفضل بعد إرسال الرابط إلى المستخدم إرسال رسالة:

“بعد إجراء الدفع، انتظر حتى يكتمل الدفع بنجاح.”

---

بنية الـ callback

بالنسبة للروابط المنشأة عبر زر الدفع أو عبر دالة في الحاسبة، تصل إلى البوت callback تلقائيًا بعد الدفع. ويتكون من:

<secret_key>_success <payment_amount>

مثال:

ovg58keefc_success

• ovg58keefc — المفتاح السري الكامل لنظام الدفع

• _success — نتيجة معالجة الطلب (دفع ناجح)

---

الاستخدام العملي

يمكن معالجة الدفع الناجح عبر كتلة شرطية وعرض الرسالة المناسبة للمستخدم.

يجب أن يكون نوع المقارنة "Full match" / "تطابق كامل"

لإجراء دفعة جديدة، يجب بالضرورة payment_sum تصفير المتغير وحذف الرابط الذي تم إنشاؤه سابقًا. بعد ذلك فقط payment_sum يمكن تعيين قيمة جديدة للمتغير والحصول على الرابط المحدّث.

إلغاء تفعيل/إعادة تفعيل الاشتراك

كما توجد في نظام Prodamus إشعارات عن تفعيل الاشتراك أو إيقافه:

«تم إيقاف الاشتراك من قبل المستخدم» — إذا تم إيقاف الاشتراك يدويًا (على سبيل المثال، عند إلغاء الاشتراك). قد تصل هذه الرسالة قبل انتهاء الفترة المدفوعة الحالية. الإجراء يعتمد على قرارك: تجاهلها، أو أخذها بعين الاعتبار، أو محاولة استعادة المستخدم.

«تم إعادة تفعيل الاشتراك من قبل المستخدم» — تم استعادة الاشتراك. قد تصل هذه الرسالة إذا استعاد المستخدم الاشتراك قبل انتهاء الفترة المدفوعة الحالية. الإجراء يعتمد على قرارك: تجاهلها أو إزالتها من قائمة المراقبة.

«إلغاء تفعيل الاشتراك» — إذا تم إيقاف الاشتراك بعد عدة محاولات دفع فاشلة.

حفظ القيم من callback

بعد وصول إشعار الدفع الناجح، payment_callback يتم كتابة callback من Prodamus في المتغير، والذي يحتوي على جميع بيانات الدفع. يمكن حفظ هذه البيانات واستخدامها بالشكل الذي تحتاجه.

مثال على callback:

{
  "date": "2021-03-30T11:44:43+03:00",
  "order_id": "757679",
  "order_num": "",
  "domain": "demo.payform.ru",
  "sum": "14.50",
  "customer_phone": "[phone]",
  "customer_extra": "Товар",
  "payment_type": "بطاقة بلاستيكية Visa, MasterCard, МИР",
  "commission": "3.5",
  "commission_sum": "0.51",
  "attempt": "1",
  "discount_value": "10.5",
  "products[0][name]": "الوصول إلى المواد التعليمية",
  "products[0][price]": "14.50",
  "products[0][quantity]": "1",
  "products[0][sum]": "14.50",
  "payment_status": "success",
  "payment_status_description": "دفع ناجح",
  "payment_init": "manual"
}

عند إنشاء الرابط product_name و payment_description يمكن تحديد المتغيرات. عند وصول الـ callback يمكن الحصول عليها هكذا:

product = get(payment_callback,'products[0][name]')
description = get(payment_callback,'customer_extra')

انتبه: payment_sum يُعطى المتغير من المتغيرات غير الإلزامية، payment_description, product_name.

بعدها:

summa = get(payment_callback, 'sum')

ردود callback المتاحة

إضافة إلى ردود callback الأساسية للدفع الناجح، تظهر في الدردشة الرسائل التالية التي لا يراها المستخدم:

callbacks

• ألغى المشترك الاشتراك (المزيد هنا)

• أعاد المشترك تفعيل الاشتراك (المزيد هنا)

• تم إنهاء الاشتراك

• دفع غير ناجح - مع ملاحظة توضيحية (في لقطة الشاشة أعلاه)

• إشعار بخصم قادم - تاريخ ووقت الخصم القادم

• طلب تقسيط بحالة

أمثلة على callback في الحوار مع العميل

• ألغى المشترك الاشتراك

• أعاد المشترك تفعيل الاشتراك

• تم إنهاء الاشتراك

• دفع غير ناجح - لا توجد أموال كافية.

• دفع غير ناجح - انتهت صلاحية البطاقة.

• دفع غير ناجح - تم تجاوز حد البطاقة.

• دفع غير ناجح - البطاقة مفقودة

• دفع غير ناجح - خطأ في النظام

• دفع غير ناجح - تم رفض العملية. يرجى التواصل مع البنك المصدر للبطاقة.

• دفع غير ناجح - رفض تنفيذ العملية من قبل البنك المُصدر.

• دفع غير ناجح - رفض تنفيذ العملية من قبل البنك.

• إشعار بخصم قادم - dd.mm.yyyy hh:mm

• تمت الموافقة على طلب التقسيط

• تم إلغاء طلب التقسيط

• تم رفض طلب التقسيط

يمكنك، حسب رغبتك، إعداد إرسال أي رسالة إلى المستخدم. على سبيل المثال، إرسال إشعار عند فشل الدفع التلقائي.

يمكن إعداد كتل الرد على الإشعارات وفقًا لسبب محدد لفشل الدفع كما يلي:

لإرسال إشعار لكل المدفوعات الفاشلة بغض النظر عن السبب، يمكن إعدادها كما يلي:

في جميع callbacks، إذا كان النص يحتوي على «الدفع فشل» فسيتم إرسال رسالة إلى المستخدم بالنص الذي تحدده.

كيفية إجراء الدفع بالاشتراك

كيفية إنشاء اشتراك

لإنشاء اشتراك، يجب أولًا إنشاء منتج اشتراك . التعليمات الكاملة: كيفية إنشاء وإعداد اشتراك

ثم نقوم بنسخ معرّف منتج الاشتراك. على سبيل المثال، يظهر أدناه من أين يمكن الحصول عليه:

إنشاء منتج اشتراك

لإنشاء رابط دفع الاشتراك، prodamus_subscription للمتغير معرّف يجب تعيين معرّف منتج الاشتراك. بعد ذلك سيتم تلقائيًا prodamus_pay_url سيظهر المتغير.

الترجمة إلى اللغة العربية (أسلوب رسمي):

prodamus_pay_url يمكن عرض المتغير كرابط على الشاشة أو وضعه على زر يحمل نص «ادفع». مثال على الرابط: https://payform.kz/7p3JR8/

تتم معالجة النتيجة كما في الدفع لمرة واحدة (كما قرأت أعلاه).

بعد الاشتراك الناجح، يتم إرفاق customer_phone المتغير الذي تم إدخاله أثناء الدفع. رقم الهاتف ضروري لإدارة الاشتراك.

إذا لم يتم توفير customer_email فإنه لإدارة الاشتراك، customer_phone إلزامي.

get_prodamus_subscription_url كيفية إنشاء رابط للاشتراك باستخدام الدالة

لننظر إلى طريقة أخرى لإنشاء رابط دفع لمنتج بالاشتراك.

1. يتم إنشاء منتج اشتراك من لوحة Prodamus. يمكن الاطلاع على التعليمات الكاملة عبر الرابط: كيفية إنشاء وإعداد اشتراك

2. ثم نقوم بنسخ معرّف منتج الاشتراك. على سبيل المثال، يظهر أدناه من أين يمكن الحصول عليه:

إنشاء منتج اشتراك

للحصول على رابط الدفع لمنتج بالاشتراك في الحاسبة نحدد الدالة

get_prodamus_subscription_url(subscription_id, product_name, expired, customer_phone, customer_email, discount, description, extra_params, products_for_receipt)

الحاسبة

مثال 1: رابط الدفع لمنتج بالاشتراك

وصف المعلمة

مثال على كود للنسخ

إذا حدث خطأ في الكتلة عند الحصول على الرابط عبر عدة دوال، قيمة الخطأ error_payment_func في المتغير تُسجَّل.

يُكتب الخطأ في الحاسبة وفقًا لآخر دالة.

كيفية إدارة حالة الاشتراك

هذه الطريقة مخصصة للاشتراكات الفعلية فقط، ولا يوجد ربط بطاقة في وضع العرض التجريبي.

لإدارة الاشتراك، يجب بالضرورة customer_phone أو customer_email أن تُمرَّر إحدى معلمات

لإخراج المستخدم من الاشتراك، يجب إنشاء كتلة واستدعاء الدالة التالية: delete_subscription_prodamus

مثال على المعلمات:

{
  "customer_phone": "#{customer_phone}",
  "id_subscription":"#{prodamus_subscription}",
  "url":"https://demo.payform.ru/",
  "secret_key":"453e8fba8b7cef9ce58dc6e18e25b39ad5a05748175a3f205f2b084acbfc3b66",
  "switcher":"0",
  "profile_id":"12345"
}

• url — رابط نموذج الدفع، مأخوذ من إعدادات المُنشئ

• secret_key — المفتاح السري المأخوذ من الإعدادات

• id_subscription — معرّف منتج الاشتراك

• customer_phone — هاتف صاحب الاشتراك

• switcher — إدارة الاشتراك: 0 — إيقاف الاشتراك، 1 — إعادة تفعيل الاشتراك

• profile_id — معرّف الملف الشخصي في نظام Prodamus

ملاحظة: إذا جاء معرّف الملف الشخصي، فسيتم حفظه في profile_id المتغير. profile_id إلى الدالة customer_phone أو customer_email يمكن تمريره بدلًا من ذلك وإيقاف الاشتراك.

مثال: إعداد كتل الاشتراك

لاحظ أن الدالة status تُرجع، ويمكنك حفظها ومعالجتها كما تريد. عند إيقاف الاشتراك أو إعادة تفعيله بنجاح، status = ok تكون.

دالة لإدارة الاشتراك

prodamus_subscription_switch_status(subscription_id, switcher, customer_phone, customer_email, profile_id) المعلمات:

subscription_id – معرّف منتج الاشتراك

switcher – إدارة الاشتراك: 0 – إيقاف الاشتراك، 1 – إعادة تفعيل الاشتراك

customer_phone – هاتف صاحب الاشتراك؛ غير إلزامي إذا تم تحديد customer_email

customer_email – البريد الإلكتروني لصاحب الاشتراك؛ غير إلزامي إذا تم تحديد customer_phone

profile_id – معرّف الملف الشخصي في نظام Prodamus

مثال على استخدام الدالة prodamus_subscription_switch_status

الترجمة إلى اللغة العربية (أسلوب رسمي):

مثال 1: customer_phone تم توفير المعلمة، customer_email تم تجاوزها:

stat = prodamus_subscription_switch_status('618117', '0', '75431312321')

مثال 2: customer_email تم توفير المعلمة، customer_phone تم تجاوزها:

stat = prodamus_subscription_switch_status('618117', '0', '', '[email protected]')

إذا اكتملت جميع العمليات بنجاح، فإن الدالة ok تُرجع، أو تُرجع وصف الخطأ في حال حدوثه.

إدارة الخصومات في الاشتراك

تقوم هذه الدالة بضبط مقدار الخصم على المدفوعات القادمة في الاشتراك. ويمكن أن يكون الخصم محدودًا أو غير محدود بعدد المدفوعات.

prodamus_subscription_discount(subscription_id, discount, customer_phone, num, profile_id)

المعلمات:

• subscription_id — معرّف الاشتراك

• discount — عدد عشري بدقة رقمين بعد الفاصلة؛ يجب أن تكون القيمة أكبر من صفر وألا تتجاوز القيمة الأساسية للاشتراك

• customer_phone — رقم هاتف العميل، بالصيغة: [phone] (غير إلزامي إذا كان customer_email المتغير موجودًا؛ يظهر بعد الدفع الأول)

• num — عدد المدفوعات التي سيُطبق عليها الخصم (غير إلزامي؛ إذا لم يُحدد، فسيُطبق الخصم على جميع المدفوعات)

• profile_id — معرّف الملف الشخصي في نظام Prodamus

إذا تم تنفيذ الطلب بنجاح، فإن الدالة 'ok' تُرجع؛ وإذا حدث خطأ، فتُرجع وصف الخطأ.

لن تتم إعادة كتابة مقدار الخصم والفاصل الزمني إلا إذا أعدت استدعاء الدالة بقيم جديدة!

أمثلة:

1. منح خصم 1₽ على جميع المدفوعات التلقائية القادمة (لا يتم تحديد رقم الهاتف، لأنه يُؤخذ تلقائيًا من customer_phone المتغير؛ ويُطبق مبلغ الخصم افتراضيًا على كامل مدة الاشتراك):

r = prodamus_subscription_discount('624034', '1')

2. مثال على منح خصم 2₽ على الدفعات الثلاث القادمة (يُمرَّر رقم الهاتف بين علامتي اقتباس فارغتين، لأنه يُؤخذ تلقائيًا من customer_phone المتغير):

r = prodamus_subscription_discount('624034', '2', '', '3')

3. مثال على عرض الخصم كعدد عشري (الفاصل هو النقطة، وتُعرض القيم بدون علامات اقتباس)، ويمكن تمرير رقم الهاتف عبر متغير.

r = prodamus_subscription_discount(#{prodamus_subscription}, 10.25, #{customer_phone}, 3)

كيفية ضبط تاريخ الدفعة القادمة في الاشتراك

تتيح هذه الطريقة نقل تاريخ الدفعة التالية في الاشتراك. لا يمكن نقل التاريخ إلا من تاريخ الدفعة التالية الحالي «إلى المستقبل» ، وبذلك يمكن زيادة مدة المشاركة في النادي.

على سبيل المثال، يمكن استخدامه كهدية للمشتركين.

لذلك يجب استخدام الدالة التالية:

prodamus_subscription_payment_date(subscription_id, date, customer_phone, profile_id)

المعلمات:

• subscription_id — معرّف الاشتراك

• date — تاريخ بصيغة dd.mm.yyyy hh:mm أو dd.mm.yyyy؛ وإذا أُعطي dd.mm.yyyy فقط، فسيكون الوقت 00:00

• customer_phone — غير إلزامي؛ وإذا لم يُذكر، customer_phone فسيُؤخذ من المتغير؛ وإذا لم يُعثر عليه فلن تعمل الدالة

• profile_id — معرّف الملف الشخصي في نظام Prodamus

كيفية إرسال المعلمات إلى Prodamus

لإرسال المعلمات المطلوبة (مثل تاريخ بدء الاشتراك، إيقاف التقسيط، إلخ) إلى نظام Prodamus، أضف إلى اسم المتغير prodamus_ السابقة.

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

كيفية اختبار الدفع

نختبر الدفع فقط!

حتى لا يتم خصم أموال من حسابك أثناء إعداد التكامل ومسارات الدفع، يمكن استخدام بطاقات اختبار.

أولًا، غيّر صفحة الدفع الخاصة بك إلى وضع DEMO ⤵ ولا تنسَ الضغط على زر «حفظ».

يمكن استخدام حسابات اختبار لإجراء دفع تجريبي.

بطاقات سبير الاختبارية:

МИР رقم البطاقة: 2202 2050 0001 2424 تاريخ الانتهاء: 05/35 رمز التحقق على ظهر البطاقة (CVV): 669

MasterCard رقم البطاقة: 5469 9801 0004 8525 تاريخ الانتهاء: 05/26 رمز التحقق على ظهر البطاقة (CVV): 041 رمز التحقق 3-D Secure: 111111

Visa رقم البطاقة: 4006 8009 0096 2514 تاريخ الانتهاء: 05/26 رمز التحقق على ظهر البطاقة (CVV): 941 رمز التحقق 3-D Secure: 111111

❗️عند الدفع عبر حسابات الاختبار، فإن جميع مسارات العمل والتكاملات المضبوطة تعمل كما في الدفع العادي❗️

تم التحقق من النموذج

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