كيفية تكوين Robokassa

دعنا نلقي نظرة على كيفية قبول المدفوعات في بوت من خلال خدمة Robokassa.

  1. قم بإنشاء متجر إلكتروني في حساب Robokassa الخاص بك وحدد الإعدادات التقنية التالية:

قم بإنشاء كلمات مرور اختبارية وقم بالإعداد الأولي في وضع الاختبار.

كيفية ربط Robokassa بـ MaviBot

انتقل إلى قسم الاستحواذ وانقر على اتصال في بطاقة Robokassa:

املأ النموذج في النافذة التي تفتح:

  1. معرف المتجر — معرف المتجر، والذي يمكنك العثور عليه في إعدادات المتجر في حساب Robokassa الخاص بك.
  2. كلمة المرور رقم 1 وكلمة المرور رقم 2 — تسلسلات فريدة من الحروف والأرقام.
  3. معدل ضريبة القيمة المضافة — حدد الرمز المناسب لنقل قيمة ضريبة القيمة المضافة. يحدد هذا الحقل معدل الضريبة في السجل النقدي. يتم تحديده بشكل منفصل لكل نوع من المنتجات، ولكنه ينطبق على جميع وحدات هذا المنتج معًا.

القيم المتاحة:

  • لا توجد ضريبة قيمة مضافة.
  • ضريبة القيمة المضافة بنسبة 0%.
  • ضريبة القيمة المضافة بنسبة 5%.
  • ضريبة القيمة المضافة المحسوبة بنسبة 12%.
  • ضريبة القيمة المضافة المحسوبة بنسبة 16%.

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

يمكنك إنشاء رابط دفع في كتلة باستخدام واحدة من الطرق المتاحة:

زر الدفع

يمكنك إنشاء رابط دفع باستخدام زر مع وظيفة الدفع.

تعرف على كيفية إنشاء زر مع وظيفة الدفع هنا.

دعنا نراجع جميع معلمات الزر المتاحة.

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

لإنشاء رابط دفع، حدد المعلمات الإلزامية التالية في إعدادات الزر:

  • المبلغ
  • اسم المنتج

المبلغ — حدد سعر المنتج بالروبل.

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

لا تستخدم علامات الاقتباس المزدوجة في اسم المنتج. قم بإزالتها أو استبدالها بعلامات اقتباس مفردة.

خانة اختيار الدفع التلقائي — تمكن المدفوعات المتكررة.

خانة اختيار إشعار النقر — تمكن تتبع النقرات على رابط الدفع. إذا تم تمكينها، سيظهر إشعار حول النقرة في محادثة العميل في MaviBot.

يمكنك تكوين منطق البوت الإضافي بناءً على هذا الإشعار.

تدعم العديد من أنظمة الدفع السجلات النقدية السحابية المطلوبة بموجب القانون الاتحادي رقم 54-FZ.

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

بيانات الإيصال

افتح قائمة بيانات الإيصال لعرض معلمات الإيصال:

اسم المنتج — مطلوب لإنشاء إيصال.

لا تستخدم علامات الاقتباس المزدوجة في اسم المنتج. قم بإزالتها أو استبدالها بعلامات اقتباس مفردة.

المبلغ الإجمالي بالروبل — حدد إجمالي مبلغ الدفع بناءً على كمية المنتج. إذا كانت الكمية 1، فإن المبلغ الإجمالي بالروبل يساوي القيمة المدخلة في حقل المبلغ الإلزامي.

الكمية — كمية أو وزن المنتج. يمكنك تمرير عدد صحيح أو رقم عشري باستخدام نقطة، على سبيل المثال:

5

أو

10.3

متغيرات العميل التي يتم إنشاؤها تلقائيًا عند استخدام زر الدفع

بمجرد أن يتلقى المستخدم كتلة تحتوي على زر الدفع، يتم إنشاء متغيرات العميل التالية تلقائيًا:

متغير العميل الخدمي:

__payments

يخزن مبلغ الدفع ومعرف رابط الدفع الذي تم إنشاؤه. وهو مطلوب لتحديد webhook المستلم من مزود الدفع.

يجب عدم حذف أو تعديل متغير الخدمة __payments.

متغير العميل:

error_payment_button

يتم إنشاؤه في حالة حدوث خطأ أثناء إنشاء زر الدفع.

ستحتوي قيمة error_payment_button إما على نص الخطأ أو استجابة الخطأ التي أرجعها مزود الدفع.

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

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

يرجى الملاحظة

يرسل Robokassa إشعارات فقط للمعاملات الناجحة من خلال عنوان URL للنتيجة.

لا يوفر Robokassa عمليات رد اتصال للمدفوعات غير الناجحة.

عنوان URL للفشل هو فقط صفحة الدفع غير الناجح التي يتم إعادة توجيه الدافع إليها في حالة حدوث خطأ في صفحة الدفع.

الدفع الناجح

بعد تكوين الدفع بشكل صحيح وإنشاء رابط الدفع، اختبر الإعداد.

إذا كان الدفع ناجحًا، سيتم إرسال رد اتصال تلقائيًا إلى محادثة العميل في قسم العملاء.

يتكون رد الاتصال من:

  • 10 أحرف من المفتاح السري لمزود الدفع؛
  • الكلمة _success؛
  • مبلغ الدفع بعد مسافة.

يتم إنشاء رد الاتصال تلقائيًا. لا تحتاج إلى إنشائه بنفسك أو طلبه من فريق دعم مزود الدفع.

مثال:

ovg58keefc_success 2999

حيث:

  • ovg58keefc — 10 أحرف من المفتاح السري لمزود الدفع؛
  • _success — نتيجة معالجة الطلب التي تشير إلى دفع ناجح؛
  • 2999 — مبلغ الدفع.

تنفيذ الكتلة:

رد الاتصال:

عمليات رد الاتصال من مزود الدفع غير مرئية للمستخدم.

يتم عرضها فقط في قسم العملاء وتكون مرئية للمشغل أو المسؤول.

مثال على تكوين استجابة رد الاتصال

في كتلة شرطية، مثل كتلة شرط البدء أو كتلة حالة غير شرطية مع شرط، حدد رد الاتصال المستلم بعد الدفع.

حدد إما مطابقة تامة أو يحتوي على كلمات رئيسية كنوع المطابقة.

بعد الدفع، سيتلقى العميل الرسالة من الكتلة التي تم تكوينها للرد على رد الاتصال:

خطأ في مبلغ الدفع

إذا كان المبلغ المحدد في إعدادات الزر يختلف عن المبلغ الذي دفعه العميل، فسيحصل البوت تلقائيًا على رد اتصال يتكون من:

  • 10 أحرف من المفتاح السري لمزود الدفع؛
  • _different_amounts؛
  • معرف الدفع الفريد بعد مسافة.

مثال:

ovg58keefc_different_amounts 123456

حيث:

  • ovg58keefc — 10 أحرف من المفتاح السري لمزود الدفع؛
  • _different_amounts — يشير إلى أن المبلغ المدفوع يختلف عن المبلغ في رابط الدفع؛
  • 123456 — معرف الدفع الفريد.

وظيفة get_robokassa_payment_url في الحاسبة

يمكنك إنشاء رابط دفع باستخدام وظيفة get_robokassa_payment_url في كتلة الحاسبة.

في حقل الحاسبة، قم بتعيين نتيجة وظيفة get_robokassa_payment_url لمتغير.

يمكنك اختيار اسم المتغير بنفسك. تظهر لقطات الشاشة أسماء متغيرات نموذجية.

سيتم حفظ رابط الدفع في هذا المتغير.

يمكنك عرض المتغير كرابط في رسالة أو وضعه في زر مع نص مثل ادفع.

مثال على رابط الدفع:

https://auth.robokassa.ru/Merchant/Index.aspx?MerchantLogin=test_salebot&OutSum=800&InvId=1412&IsTest=1&SignatureValue=0427369c3bd068bae30935f896060dda

تدعم العديد من أنظمة الدفع السجلات النقدية السحابية المطلوبة بموجب القانون الاتحادي رقم 54-FZ.

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

الحاسبة

مثال 1:

وصف المعلمة

get_robokassa_payment_url(amount, description, products_for_receipt, recurrent, currency)

معلمات الوظيفة

المعلمة الوصف
amount مبلغ الدفع. حدد سعر المنتج بالروبل. معلمة إلزامية.
description اسم المنتج. قد يحتوي هذا الحقل على أحرف إنجليزية أو روسية فقط، وأرقام، وعلامات ترقيم. الحد الأقصى للطول هو 100 حرف. يتم عرض هذه المعلومات في واجهة Robokassa وفي الإيصال الإلكتروني الذي يتلقاه العميل بعد الدفع الناجح. معلمة إلزامية.
products_for_receipt معلمات إنشاء الإيصال. اقرأ المزيد هنا.
recurrent تمكين المدفوعات المتكررة. مرر 1 إذا كانت المدفوعات المتكررة ممكنة، أو None إذا كانت معطلة.
currency رمز العملة المكون من ثلاثة أحرف. يجب أن تتطابق القيمة تمامًا مع المعلمات المقبولة من قبل Robokassa.

USD — الدولار الأمريكي؛
EUR — اليورو؛
KZT — التنغي.

أمثلة على الكود

مثال 1: رابط دفع بدون إيصال

res = get_robokassa_payment_url(100, 'اشتر لي')

مثال 2: رابط دفع مع إيصال

receipt = [{"name":"DDDDDDDD","amount":"44","quantity":"1","vat_code":"5","method":"full_payment","object":"commodity"}]

res = get_robokassa_payment_url(100, 'اشتر لي', receipt, '3', 1, 1)

يمكنك عرض المتغير كرابط في رسالة أو وضعه في زر مع نص مثل اشتر.

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

error_payment_func

سيتم حفظ الخطأ من آخر وظيفة في الحاسبة.

بعد تكوين الدفع بشكل صحيح وإنشاء رابط الدفع، اختبر الإعداد.

كيفية إضافة وصف الدفع

يمكنك إضافة وصف الدفع عن طريق تعيين المتغير:

payment_description

سيتم عرض الوصف في نموذج الدفع وعلى الإيصال.

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

إذا كان الدفع ناجحًا، سيتم إرسال رد اتصال تلقائيًا إلى محادثة العميل في قسم العملاء.

يتكون رد الاتصال من:

  • 10 أحرف من المفتاح السري لمزود الدفع؛
  • _success؛
  • مبلغ الدفع بعد مسافة.

يتم إنشاء رد الاتصال تلقائيًا. لا تحتاج إلى إنشائه بنفسك أو طلبه من فريق دعم مزود الدفع.

مثال:

ovg58keefc_success 1500

حيث:

  • ovg58keefc — 10 أحرف من المفتاح السري لمزود الدفع؛
  • _success — نتيجة معالجة الطلب التي تشير إلى دفع ناجح؛
  • 1500 — مبلغ الدفع.

يرجى الملاحظة

رد الاتصال مرئي لك فقط في محادثة العميل.

رد الاتصال غير مرئي للعميل، ولكن يمكنك تكوين رد على الدفع الناجح.

مثال

إعدادات كتلة تستخدم وظيفة get_robokassa_payment_url:

1. عرض الرابط في نص الرسالة

مهم

رابط الدفع فريد. يجب ألا تنسخه وترسله إلى عملاء آخرين.

أرسل رابط الدفع من خلال متغير في البوت.

رد الاتصال بعد الدفع الناجح:

2. عرض الرابط في زر

تنفيذ الكتلة:

رد الاتصال بعد الدفع الناجح: