دليل التكامل

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

الخطوات الأولى

توجد أنواع مختلفة من التكاملات: API، إضافات (plugins)، أزرار (buttons)، روابط دفع (payment links).

بغض النظر عن نوع التكامل الذي تختاره، ستحتاج أولاً إلى إكمال ثلاث خطوات بسيطة:

الخطوة 1

التسجيل – أدخل عنوان بريدك الإلكتروني أو رقم هاتفك. بعد التأكيد، ستقوم بتسجيل الدخول إلى حسابك.

الخطوة 2

➜ إنشاء مشروع (Merchant) – انتقل إلى تبويب الأعمال (Business).

➜ اضغط زر "إنشاء Merchant".

➜ أدخل اسم المشروع.

الخطوة 3

اختر نوع التكامل أو تجاوز هذه الخطوة حالياً.

لقد أنشأت مشروعك الجديد بنجاح! لديك الآن محفظتان:

• المحفظة الشخصية – وهي محفظتك حيث يمكنك ببساطة تخزين، تحويل، ونقل عملتك المشفّرة.

• المحفظة التجارية – وهي المحفظة التي يمكنك من خلالها إنشاء مشاريع جديدة، إصدار الفواتير، إعداد الأدوات (widgets)، عرض إحصائيات الدفع، واستخدام العديد من الوظائف الأخرى.

الآن لنتحدث عن أنواع التكامل.

أنواع التكامل

كيف تعرف أي نوع من التكامل مناسب لك؟

الدفع عن طريق الرابط

هذه هي أبسط طريقة لبدء قبول مدفوعات العملات المشفّرة باستخدام Cryptomus.

تتيح هذه الميزة للمستخدمين إنشاء حساب دون الحاجة إلى إنشاء موقع وربطه بـ Cryptomus.

الخطوة 1 ➜ في الصفحة الرئيسية لحساب الـ Merchant الخاص بك اضغط "إنشاء فاتورة (Create invoice)"

الخطوة 2 ➜ املأ تفاصيل الدفع.

الخطوة 3 ➜ اضغط "إنشاء دفع (Create payment)".

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

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

أنشئ فاتورة، أرسل الرابط عبر البريد الإلكتروني، أو في تطبيق مراسلة، أو اتركه في أي مكان وتلقَّ الأموال! يمكن أيضاً استخدام هذه الطريقة في المتاجر العادية والأعمال غير المتصلة بالإنترنت.

الإضافات (Plugins)

• WooCommerce: بوابة دفع العملات المشفّرة في WooCommerce
• OpenCart: إضافة بوابة الدفع في OpenCart
• PrestaShop: إضافة بوابة الدفع في PrestaShop
• Shopify
• BillManager
• RootPanel
• XenForo
• PHPShop
• Tilda

وغيرها الكثير، جميعها متاحة على صفحة إضافات Cryptomus.

API

اطّلع على وثائق API لدينا وقم بالتكامل باستخدام مفتاح API الخاص بك.

لإصدار مفتاح API لاستقبال الأموال:

➜ انتقل إلى Merchant → الإعدادات

➜ انتقل إلى تبويب إرسال طلب (Leave a request)

➜ أدخل عنوان موقعك الإلكتروني ووصف قصير

➜ أكّد نطاقك (domain)

➜ تم!

مفتاح API لعمليات السحب موجود في الإعدادات الداخلية.

تذكّر أن Cryptomus توفّر دعماً شاملاً لمساعدتك في أي مشكلة قد تواجهها أثناء عملية التكامل. يمكنك التواصل مع خدمة الدعم عبر الموقع أو في تيليغرام باستخدام اسم المستخدم @cryptomussupport، أو مراسلتنا عبر البريد support@cryptomus.com.

تقدّم Cryptomus خيار مدير شخصي. بعد التسجيل وربط حسابك في تيليغرام، سيكون المدير بمثابة مساعدك الشخصي ويساعدك في أي مشاكل تواجهها.

التدفق النموذجي لـ API

• تنشئ دفعة باستخدام "إنشاء فاتورة (Create invoice)" وتُظهر العنوان للمستخدم.

• يرسل المستخدمون الأموال إلى العنوان. يمكنك التحقق من حالة الدفع باستخدام "الحصول على حالة الدفع (Get payment status)" أو عبر IPN. فقط حدد “url_callback” في طلب "إنشاء فاتورة" لتلقي رسائل IPN. سنرسل طلب POST إلى هذا الرابط عند تحديث حالة الدفع.

رسالة IPN مشابهة لرسالة "الحصول على حالة الدفع". تظهر رسائل الحالة في هذه الحالات:

• معاملة منتهية الصلاحية (Expired transaction) الحالة: pending ➜ expired

• معاملة مكتملة (Completed transaction) الحالة: pending ➜ paid ➜ completed

• معاملة مدفوعة جزئياً (Partially paid transaction) الحالة: pending ➜ paid ➜ partially paid

بعد اكتمال الدفع يمكنك البدء في استخدام الخدمة.

العنوان الثابت (Static address)

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

مثال متجر إلكتروني:

1. يسجّل العملاء ويتلقون عناوين إيداع دائمة.
2. يرسل المشترون الأموال إلى عنوان إيداع Cryptomus. باستخدام IPN، يرسل Cryptomus المبلغ ومعلومات العملة إلى المتجر الإلكتروني.
3. نقيد الأموال في رصيد المتجر في نظامنا. يتم الاحتفاظ بالأموال بنفس العملة المرسلة من المشتري.
4. بعد ذلك يطلب المشتري أو المتجر دفعة من الرصيد.
5. نقوم بسحب الأموال وإرسالها إلى عنوان المتجر أو المشتري.

حالياً، التحويل للعناوين الثابتة غير متاح. هذه الميزة قيد التطوير.

كيفية تشكيل الرسوم (Fee):

1. يرسل المشتري الأموال إلى عنوان الإيداع الدائم ويدفع رسوم الشبكة.
2. نقوم بتحويل الأموال من عنوان الإيداع إلى الرصيد – رسوم الشبكة تدفعها Cryptomus.
3. نقوم بسحب الأموال ونرسلها إلى محافظ المشترين أو المتجر – رسوم الشبكة دائماً يدفعها المتجر في كلا الحالتين.

ملاحظة: بالنسبة لعمليات الدفع (payouts)، رسوم الشبكة يدفعها المتجر.

هل لا تزال لديك أسئلة؟

يسعدنا مساعدتك والإجابة على جميع أسئلتك. فقط اطرح سؤالك على الموقع، عبر البريد support@cryptomus.com أو في تيليغرام باستخدام اسم المستخدم @cryptomussupport.

هذا المحتوى مخصص للأغراض المعلوماتية والتعليمية فقط وليس نصيحة مالية أو استثمارية أو قانونية.