كيفية الاتصال
للاتصال بنظام الدفع Coinpayments، ستحتاج إلى أربع قيم: معرف البائع، وسر IPN (لـ webhooks)، والمفتاح الخاص لواجهة API، والمفتاح العام لواجهة API. ستحتاج أيضًا إلى تعيين رابط webhook.
انتقل إلى الحساب الشخصي لـ Coinpayments -> إعدادات الحساب https://www.coinpayments.net/index.php?cmd=acct_settings
في التبويب الأول، انسخ معرف البائع. (seller ID)
بعد ذلك، انتقل إلى تبويب "إعدادات البائع" وأنشئ وأدخل مفتاح IPN سري - IPN secret (يُستخدم للتحقق من أن webhook قادم منا). استخدم سلسلة آمنة ومعقدة يصعب تخمينها.
رابط IPN - هو عنوان URL لـ webhooks، أضف ما يلي: https://chatter.salebot.pro/coinpayments\\_callback/result
بعد ذلك، انتقل إلى قسم مفاتيح API وقم بإنشاء زوج مفاتيح للوصول إلى API.
احفظ جميع الإعدادات، وانسخ البيانات وانتقل إلى الإعدادات في Mavibot. افتح قسم "الاستحواذ"، واختر Coinpayments.
تحتاج إلى إدخال البيانات المستلمة.
لإنشاء رابط دفع، تحتاج إلى تعيين قيمة المتغيرات المطلوبة:
بعد ذلك، تحتاج إلى تعيين قيمة المتغير payment_sum (على سبيل المثال، 10 أو 0.0055 (مفصولة بنقطة!) )، وسيظهر المتغير coinpayments_pay_url فورًا بعد ذلك. يمكن عرض هذا المتغير مع رابط أو وضعه على زر مع نص "ادفع". يبدو الرابط كالتالي: 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
عمليات رد الاتصال هذه غير مرئية للمستخدم، يتم عرضها فقط للمشغل.
يجب أن يكون نوع المقارنة "مطابقة تامة"
أيضًا، بعد الدفع الناجح، يتم تعيين المتغير coinpayments_payment_completed إلى True.
على سبيل المثال، يمكنك معالجة الدفع الناجح في كتلة شرطية وعرض الرسالة المقابلة للمستخدم:
بعد اكتمال الدفع، سيتم إضافة المتغير coinpayments_payment_callback إلى العميل، والذي يحتوي على بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات المطلوبة من القاموس الناتج باستخدام طريقة get.
كيفية التحقق من حالة الدفع
للتحقق من حالة الدفع، استخدم طريقة coinpayments_get_payment_status() في حقل الحاسبة.
مثال:
مثال على الحالة:
في انتظار أموال المشتري...
تم استلام الأموال وتأكيد إرسالها إليك قريبًا...
مكتمل