Coinpayments
كيفية الربط رابط How to connect
كيفية إنشاء رابط للدفع رابط How to generate a payment link
كيفية معالجة النتيجة رابط How to process the result
كيفية التحقق من حالة الدفع رابط How to check the payment status
كيفية الربط
للربط مع نظام الدفع Coinpayments، ستحتاج إلى أربع قيم: معرّف البائع، وسر IPN (لخطافات الويب)، والمفتاح الخاص للـ API، والمفتاح العام للـ API. ستحتاج أيضًا إلى تعيين عنوان URL لخطاف الويب.
انتقل إلى الحساب الشخصي في Coinpayments -> إعدادات الحساب https://www.coinpayments.net/index.php?cmd=acct_settings
في التبويب الأول، انسخ معرّف البائع. (معرّف البائع)
بعد ذلك، انتقل إلى تبويب "إعدادات البائع" وأنشئ وأدخل مفتاحًا سريًا لـ IPN - سر IPN (يُستخدم هذا للتحقق من أن خطاف الويب قادم منا). استخدم سلسلة آمنة ومعقدة يصعب تخمينها
رابط IPN - هو عنوان URL لخطافات الويب، أضف ما يلي: https://chatter.salebot.pro/coinpayments_callback/result
بعد ذلك، انتقل إلى قسم مفاتيح API وأنشئ زوج مفاتيح للوصول إلى API.
احفظ جميع الإعدادات، وانسخ البيانات وانتقل إلى الإعدادات في Mavibot. افتح قسم "Acquiring"، واختر Coinpayments.
تحتاج إلى إدخال البيانات التي تم استلامها.
لإنشاء رابط دفع، تحتاج إلى تعيين قيمة المتغيرات المطلوبة:
original_currency
العملة الأصلية للمعاملة.
sending_currency
العملة التي سيرسلها العميل.
على سبيل المثال، إذا كانت أسعار منتجاتك بالدولار الأمريكي، لكنك تستلم BTC، فيجب عليك استخدام original_currency = USD و sending_currency = BTC. يمكن أن تكون لدى original_currency و sending_currency قيمة واحدة إذا لم تكن هناك حاجة إلى تحويل العملة.
buyer_email
عنوان البريد الإلكتروني للعميل.
لإرسال إشعارات إذا كان مبلغ الدفع أقل ويحتاج إلى استكماله، أو لعمليات الاسترداد. إذا لم يتم تعيين هذا المتغير، فسيتم أخذ البريد تلقائيًا من متغير email، إذا كان لدى المستخدم واحد في Mavibot.
بعد ذلك، تحتاج إلى تعيين قيمة payment_sum المتغير (على سبيل المثال، 10 أو 0.0055 (مفصولة بنقطة!))، وستظهر قيمة المتغير coinpayments_pay_url بعد ذلك مباشرة. يمكن عرض هذا المتغير كرابط أو وضعه على زر بالنص "Pay". يبدو الرابط كالتالي: https://www.coinpayments.net/index.php?cmd=checkout&id=CPFK5QZ3FKSNWHI75CO8M4BRVD&key=e7782d2ce24f7d03815606a5c4a882eb
أيضًا، قبل تعيين قيمة المتغير payment_sum، يمكنك تعيين المتغيرات الاختيارية التالية لتكوين الدفع.
payment_description - سيظهر اسم المنتج في صفحة معلومات الدفع وفي IPN للمعاملة.
buyer_name - اسم العميل
هذا هو شكل صفحة الدفع.
كيفية إنشاء رابط دفع
أنشئ رابط دفع بمبلغ 0.0256
انتبه: - أولًا، حدّد عنوان البريد الإلكتروني - ثم المعلمات الاختيارية التالية first_name, payment_description وغير ذلك. - أخيرًا، عيّن قيمة لـ payment_sum .
يرجى ملاحظة أننا نضبط أولًا متغيرات الإعدادات، ثم payment_sum. يمكن تعيين المتغيرات في وقت أبكر ضمن السلسلة، بدلًا من ذلك في كتلة واحدة، وهذا مثال.
بعد ذلك، نخرج coinpayments_pay_url المتغير في المكان الصحيح، والذي يحتوي على الرابط
لإجراء دفع متكرر، تحتاج إلى إعادة تعيين payment_sum، والرابط الذي تم إنشاؤه سابقًا، ثم إعادة تعيين متغير payment_sum للحصول على رابط جديد.
كيفية معالجة النتيجة
بعد الدفع الناجح، سيتم إرسال ردود إلى البوت، والتي ستُعلمك بأن الدفع كان ناجحًا. سترى هذه الردود في النظام كرسائل من المستخدم. ولمنع المستخدم من إرسالها، تتكون من أول 10 أحرف من المفتاح السري واللاحقة _success، على سبيل المثال: 16831CF4b5_success
هذه الردود غير مرئية للمستخدم، وتظهر للمشغّل فقط.
يجب أن يكون نوع المقارنة "Complete Match"
أيضًا، بعد الدفع الناجح، يتم تعيين المتغير coinpayments_payment_completed إلى True.
على سبيل المثال، يمكنك معالجة الدفع الناجح داخل كتلة شرطية وعرض الرسالة المناسبة للمستخدم:
بعد إكمال الدفع، ستتم إضافة المتغير coinpayments_payment_callback سيتم إضافة المتغير إلى العميل، ويحتوي على بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات المطلوبة من القاموس الناتج باستخدام get .
كيفية التحقق من حالة الدفع
للتحقق من حالة الدفع، استخدم coinpayments_get_payment_status() الطريقة في حقل Calculator.
مثال:
مثال على الحالة:
في انتظار أموال المشتري...
تم استلام الأموال وسيتم تأكيد الإرسال إليك قريبًا…
مكتمل
آخر تحديث