Coinpayments

• كيفية الربط

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

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

• كيفية التحقق من حالة الدفع

كيفية الربط

لربط نظام الدفع Coinpayments ستحتاج إلى 4 قيم: معرّف البائع، سر IPN (للـ webhooks)، مفتاح API الخاص ومفتاح API العام، وكذلك إعداد عنوان URL للـ webhook.

اذهب إلى حساب Coinpayments -> الإعدادات

https://ww.coinpayments.net/index.php?cmd=acct_settings

في التبويب الأول، انسخ معرّف البائع (معرّف البائع)

ثم انتقل إلى تبويب الإعدادات الخاص بالبائع، وقم بإنشاء وإدخال المفتاح السري IPN - سر IPN (يُستخدم هذا للتأكد من أن الـ webhook يأتي منا، استخدم سلسلة معقدة موثوقة سيكون من الصعب تخمينها.)

ربط IPN - عنوان URL للـ webhooks، أضف ما يلي: https://chatter.salebot.pro/coinpayments_callback/result

ثم انتقل إلى مفاتيح API القسم وقم بإنشاء زوج مفاتيح للوصول إلى الـ api.

حفظ جميع الإعدادات، انسخ البيانات وانتقل إلى الإعدادات في Salebot. افتح قسم أنظمة الدفع، واختر Coinpayments.

نحتاج إلى إدخال البيانات.

لإنشاء رابط للدفع، تحتاج إلى تعيين قيمة المتغيرات المطلوبة: original_currency - العملة الأصلية للمعاملة. sending_currency - العملة المرسلة من قبل المشتري. على سبيل المثال، إذا كانت أسعار منتجاتك بالدولار الأمريكي لكنك تتلقى BTC، فيجب أن تستخدم original_currency = USD و sending_currency = BTC. يمكن أن تكون original_currency و sending_currency بالقيمة نفسها إذا لم تكن هناك حاجة لتحويل العملة.

buyer_email هو عنوان البريد الإلكتروني للمشتري. لإرسال إشعارات إذا كان الدفع أقل وتحتاج إلى دفع مبلغ إضافي أو في حالة الاسترداد. إذا لم يتم تحديد هذا المتغير، فسيتم أخذ البريد تلقائيًا من متغير email، إذا كان لدى المستخدم واحد في salebot.

بعد ذلك، يجب عليك تعيين قيمة payment_sum المتغير (على سبيل المثال، 10 أو 0.0055 (باستخدام فاصلة عشرية!))، وبعد ذلك مباشرةً paycoinments_pay_url سيظهر المتغير. يمكن عرض هذا المتغير كرابط أو وضعه على زر بالنص "Pay". الرابط هو: https://www.coinpayments.net/index.php?cmd=checkout&id=CPFK5QZ3FKSNWHI75CO8M4BRVkey&e7782d2ce24f7d03815606a5c4a882eb

أيضًا، قبل تعيين قيمة payment_sum، يمكنك تحديد المتغيرات الاختيارية التالية لتكوين الدفع.

payment_description - اسم المنتج، وسيظهر في صفحة معلومات الدفع وفي IPN الخاصة بالمعاملة.

buyer_name - اسم المشتري

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

إنشاء رابط لدفع 0.44444

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

• أولاً حدِّد البريد الإلكتروني

• الخيارات الاختيارية التالية first_name, payment_description، إلخ.

• وأخيرًا، عيّن قيمة payment_sum variable

ملاحظة: أولًا نعيّن المتغيرات الخاصة بالإعدادات، ثم payment_sum. يمكنك تعريف المتغيرات في وقت أبكر ضمن السلسلة، وليس في كتلة واحدة؛ هذا مثال.

بعد ذلك، في المكان المناسب، اطبع المتغير coinpayments_pay_url الذي يحتوي على الرابط

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

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

بعد نجاح الدفع في البوت ستصل kolbeks، والتي يمكنك من خلالها فهم أن الدفع قد تم بنجاح. هذه الكولبيكات في النظام تراها كرسائل من المستخدم، لذلك لا يمكن إرسالها من قبل المستخدم، وهي تتكون من أول 10 أحرف من المفتاح السري مع الإشارة _success، على سبيل المثال: 16831CF4b5_success

هذه الكولبيكات لا يراها المستخدم، بل تظهر فقط للمشغّل.

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

كما يتم أيضًا بعد نجاح الدفع تعيين المتغير coinpayments_payment_completed إلى true

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

عند اكتمال الدفع، coinpayments_payment_callback إضافة المتغير إلى العميل، ويتضمن بيانات استجابة نظام الدفع للمعاملة المكتملة. يمكنك استخراج البيانات اللازمة من القاموس باستخدام get .

كيفية التحقق من حالة الدفع

للتحقق من حالة الدفع، تحتاج إلى استدعاء coinpayments_get_payment_status() في حقل Calculator

مثال:

أمثلة على الحالات:

في انتظار أموال المشتري...

تم استلام الأموال وسيتم تأكيد الإرسال إليك قريبًا…

مكتمل