استخدام الدفع متعدد السلاسل
الاستخدام الكامل لخدمة الاستلام:
- مساران للتكامل: صفحة الدفع (تضبطها وترسل الرابط دون كتابة كود)، والتطبيق مع API (ينشئ نظامك الطلبات ويستقبل الإشعارات)
- نموذجان للحفظ: أموال عناوين الحفظ لدى المنصة تُجمَّع ثم يمكن سحبها، وتُخصم الرسوم عند التجميع؛ وأموال عناوين الحفظ الذاتي تصل إلى عنوانك مباشرةً، وتُخصم الرسوم لكل دفعة من رصيد الحساب
- إعدادات التطبيق: يُستخدم App Key لتوقيع طلبات إنشاء الطلب، ويُستخدم سر الإرسال للتحقق من توقيع الإشعارات، ويجب أن يكون رابط الإشعار الراجع عنوان https، مع إمكانية اختيار الاستلام بالتدوير أو 1 إلى 1
- يُعدّ الإشعار مُسلَّمًا عند إعادة 2xx، وعند الفشل يُعاد الإرسال تلقائيًا حتى 10 مرات، ويمكن إعادة الإرسال من سجل الإشعارات
- صفحات الأموال: مجموعة العناوين، وإدارة الأصول، وإعدادات التجميع، والسحب وتحويلات الأموال، وسجل المعاملات، والسحب عبر API
- تحدّد دقة الرمز وإزاحة الاستقبال الخانات الأخيرة من المبلغ المستحق، وتُميَّز طلبات العنوان الواحد بهذه الخانات، لذا يجب دفع المبلغ بالضبط
ما تفعله هذه الخدمة
الدفع متعدد السلاسل هو الخدمة الأساسية في المنصة: يدفع عملاؤك بعملات مشفرة مثل USDT، فتصل المبالغ إلى عناوين الاستلام المسجّلة باسمك. يوجد مساران للتكامل، ويمكنك استخدام أحدهما فقط أو كليهما معًا.
- صفحة الدفع: تولّد المنصة رابط دفع مخصصًا ورمز QR. اضبط علامتك التجارية والمعاملات وأرسله إلى العميل — دون أي كود على الإطلاق.
- التطبيق وAPI: أنشئ تطبيقًا لمفاتيحه، ثم أنشئ الطلبات واستقبل Webhooks الدفع من نظامك. مناسب لمن لديه نظام قائم.
حدّد نموذج الحفظ أولًا
عناوين الاستلام نوعان: عناوين بحفظ لدى المنصة وعناوين بحفظ ذاتي. يتبع نموذج الحفظ العنوانَ نفسه، لذا يمكن استخدام النوعين معًا في التطبيق الواحد. يحدّد النموذج أين تستقر الأموال وكيف تُحصَّل الرسوم وأي الميزات تتاح، فاحسم ذلك قبل أن تبدأ استقبال المدفوعات.
- حفظ لدى المنصة — تخصّص المنصة عناوين الاستلام. بعد تجميع الأموال الواردة تنتقل إلى «قابل للسحب (مجمّع)» في «الأصول»، ومن هناك يمكنك سحبها إلى عنوان خارجي، أو تحويلها إلى رصيد الحساب، أو صرفها عبر السحب عبر API.
- حفظ ذاتي للأصول — استورد من «العناوين ← عناوين مستضافة ذاتيًا» عناوين تحتفظ أنت بمفاتيحها الخاصة. تصل الأموال إلى عنوانك مباشرةً، وتكتفي المنصة برصد وصولها وإرسال الإشعارات وتسجيلها، دون أي تجميع، وتديرها أنت بنفسك.
لا تمرّ أموال عناوين الحفظ الذاتي بالمنصة، فلا تظهر في «قابل للسحب (مجمّع)»، ولا يمكن بالتالي سحبها عبر المنصة ولا عبر السحب عبر API. قبل اختيار الحفظ الذاتي، تأكّد أن مسار الصرف لديك لا يعتمد على أيٍّ من هذين المسارين.
كيف تُحصَّل الرسوم
- حفظ لدى المنصة — تُخصم عند التجميع نسبةٌ من المبلغ المجمّع، ولكل عملة حد أدنى للرسوم، ويدخل المبلغ المتبقي بعد الخصم إلى «قابل للسحب (مجمّع)». النسبة هي السعر المعمول به حاليًا في حسابك، وقد يكون السعر الافتراضي أو سعرًا خاصًا أو سعرًا متدرّجًا حسب المبلغ المجمّع في الشهر الجاري.
- حفظ ذاتي للأصول — بعد وصول كل طلب، يُضرب عدد العملات في هذا الطلب بسعر الرسوم ويُحوَّل الناتج إلى الدولار الأمريكي ويُخصم من رصيد حسابك، ولكل عملية حد أدنى للرسوم.
تُخصم رسوم الحفظ الذاتي من رصيد الحساب، وقد يصبح الرصيد سالبًا نتيجة لذلك. عندما ينخفض الرصيد عن 0، تتوقف التطبيقات التي تستقبل عبر عناوين الحفظ الذاتي عن قبول طلبات جديدة، فيفشل أي طلب ينشئه العميل حينها، ولا تتأثر الطلبات المنشأة مسبقًا؛ كما تُؤجَّل إشعارات الوصول في وضع 1 إلى 1. بعد أن يعود الرصيد فوق 0 بالشحن يُستأنف كل شيء تلقائيًا، وتُرسل الإشعارات المؤجّلة تلقائيًا.
اطّلع على الأسعار في «قواعد رسوم المنصة» ضمن «الأصول ← إعدادات التجميع»، بما في ذلك السعر المعمول به حاليًا والأسعار المتدرّجة حسب حجم التداول الشهري والحد الأدنى للرسوم لكل رمز. سطر «الرسوم» في تفاصيل الطلب هو أساس الخصم بالنسبة إلى عناوين الحفظ الذاتي؛ أما لعناوين الحفظ لدى المنصة فهو قيمة استرشادية فقط، والمعتمد هو ما يُحتسب عند التجميع.
إنشاء تطبيق دفع
- أنشئ التطبيق واحفظ بيانات اعتماده: في «مدفوعات متعددة السلاسل ← قائمة التطبيقات» اضغط «إنشاء تطبيق»؛ تظهر بعد الإنشاء نافذة فيها App ID وApp Key. ويمكنك عرض App Key لاحقًا أيضًا بالضغط على «السر» في قائمة التطبيقات. لا يملك التطبيق الجديد سر إرسال بعد؛ اضغط «إعادة تعيين سر الإرسال» في النافذة نفسها لتوليد واحد، ثم اضبطه على خادمك للتحقق من التوقيع.
- عيّن عنوانَي الاستدعاء الراجع والتحويل: يستقبل رابط الإشعار الراجع إشعارات نتيجة الدفع، ويجب أن يكون عنوان https؛ أما رابط إعادة التوجيه فهو الصفحة التي يُنقل إليها العميل بعد الدفع. لكلٍّ منهما وظيفة مختلفة، فلا تضع العنوان نفسه في الحقلين.
- اختر وضع الدفع: يخصّص التدوير عنوانًا من المجموعة لكل طلب؛ ويربط 1 إلى 1 عنوانًا ثابتًا لكل عميل ويدفع إشعارات الأموال الواردة. يمكن تفعيل الاثنين معًا.
- اختر السلاسل والعملات التي تستقبلها: افتح علامة التبويب «إعدادات التطبيق» في تفاصيل التطبيق: تعرض القائمة السلاسل والرموز التي أتاحتها المنصة؛ حدّد ما سيستقبله هذا التطبيق منها، ثم اختر العملة التقليدية التي تُسعَّر بها الطلبات، واضغط «حفظ».
App Key وسر الإرسال كلاهما من بيانات الاعتماد. يتطلّب عرض سر الإرسال كاملًا أو توليده أو إعادة تعيينه التحقق من هويتك أولًا؛ وإذا كان API المفتوح مفعّلًا في التطبيق، فإن عرض App Key أو إعادة تعيينه يتطلّب التحقق من الهوية أيضًا. بعد إعادة التعيين تبطل القيمة القديمة فورًا وينقطع التكامل الجاري، فحدّد موعد التبديل قبل إعادة التعيين.
التحصيل عبر صفحة الدفع
لا تتطلّب صفحة الدفع كودًا؛ يُنتج الإعداد رابطًا وQR مخصّصين للعملاء. تُقسم الإعدادات إلى ثلاث علامات تبويب.
- معاملات الدفع — التطبيق المربوط، والعملة التقليدية والعملة المشفرة الافتراضيتان، والحد الأدنى للمبلغ، ومهلة الطلب، ورابط التحويل بعد نجاح الدفع، وعنوان إشعار الدفع. مهلة الطلب هي مدة العد التنازلي في صفحة الدفع، ويمكن ضبطها من 5 إلى 1440 دقيقة؛ وبعد انتهاء العد يبقى الطلب محفوظًا 25 دقيقة إضافية لالتقاط المدفوعات المرسلة قرب الموعد النهائي والتي ما زالت تنتظر التأكيد على السلسلة. إذا ملأت عنوان إشعار الدفع تُرسل الإشعارات إليه، وإلا فإلى رابط الإشعار الراجع في التطبيق المربوط.
- هوية العلامة التجارية — قالب صفحة الدفع (خمسة قوالب: بساطة عصرية، وعلامة تجارية بارزة، ومدمج، وطابع العملات المشفرة، وثقة احترافية، ويمكن التبديل بينها في أي وقت)، والشعار واسم العلامة التجارية ولون المظهر والشعار النصي والوصف؛ وهي تحدّد ما يراه العميل عند فتح صفحة الدفع.
- إعدادات العرض — بيانات الاتصال المعروضة للعميل (البريد الإلكتروني والهاتف وTelegram والموقع الرسمي)، والسماح للعميل بكتابة ملاحظة على الطلب أو عدمه، وهل يُطلب من العميل ترك وسيلة اتصال، وأنواع وسائل الاتصال المتاحة.
إذا كان التدوير مفعّلًا في التطبيق المربوط، توضّح الصفحة ذلك؛ إنه بيان مصدر عنوان الاستقبال وليس خطأً.
الطلبات وطلبات صفحة الدفع وسجلات Webhook
- «الطلبات»: جميع طلبات الاستلام هنا؛ تحمل الطلبات الناتجة عن صفحة الدفع وسم «صفحة الدفع»، ويمكن تصفيتها حسب «مصدر الطلب». وتحتوي تفاصيل الطلب على بيانات السلسلة ورسوم هذا الطلب وحالة الإشعار.
- «طلبات صفحة الدفع»: تسرد الطلبات الناتجة عن صفحة الدفع فقط، ويمكن تصفيتها حسب بانتظار الدفع أو مدفوع أو منتهي الصلاحية أو ملغى، ونسخ رابط صفحة الدفع لكل طلب.
- «سجل الإشعارات»: الطلب والرد والنتيجة لكل عملية إرسال. ابدأ تشخيص مشكلات التكامل من هنا، فهو يُظهر هل لم يُرسل الإشعار أصلًا أم أن خادمك لم يستقبله؛ ويمكن الضغط على «إعادة الإرسال» في أي سجل، ناجحًا كان أم فاشلًا.
قواعد الإشعار: يُعدّ الإشعار مُسلَّمًا إذا أعاد خادمك أي رمز حالة 2xx خلال 10 ثوانٍ، ولا تنظر المنصة في محتوى الرد؛ وتُعدّ انتهاء المهلة أو أي رد غير 2xx أو إعادة التوجيه فشلًا. بعد الفشل تعيد المنصة المحاولة مرة بعد 30 ثانية، ثم بعد دقيقة، ثم بعد دقيقتين، ثم بعد 5 دقائق، وبعدها مرة كل 10 دقائق، بحد أقصى 10 محاولات. يحمل كل إشعار معرّف notify_id فريدًا لا يتغيّر في إعادة المحاولة التلقائية ولا في «إعادة الإرسال»، فاستخدمه لإزالة التكرار.
الأموال ومجموعة العناوين والصرف
يعتمد مكان الأموال على نموذج الحفظ، وتغطّي هذه الصفحات مراحلها المختلفة.
- مجموعة العناوين — اطّلع على إجمالي العناوين وعدد المتاح منها والمربوط والأصول على كل عنوان، وأضف إلى العنوان ملاحظة لا يراها غيرك؛ وفكّ ربط عنوان ليعود إلى المجموعة المتاحة؛ ويمكن تجميع عنوان بحفظ لدى المنصة منفردًا بالضغط على «تجميع». تُستورد عناوين الحفظ الذاتي من مدخل «عناوين مستضافة ذاتيًا»، وقواعدها في الملاحظة أدناه.
- الأصول — يُعرض في الأعلى، كلٌّ على حدة، رصيد الحساب و«قابل للسحب (مجمّع)» و«على السلسلة، لم يُجمّع بعد (تقديري)». لا يُجمع الأخيران معًا: ما ينتظر التجميع على السلسلة لا يمكن سحبه إلا بعد تجميعه وخصم الرسوم. وفي هذه الصفحة أيضًا مداخل الشحن والسحب وتحويلات الأموال وفواتير المنصة وسجل التجميع وإعدادات التجميع.
- إعدادات التجميع — اطّلع على «قواعد رسوم المنصة»؛ واضبط في «إعدادات التجميع التلقائي» حد التجميع لكل رمز، فيُجمَّع تلقائيًا عند بلوغه، ولا يجوز أن يقل الحد عن الحد الأدنى للتجميع في المنصة؛ ويمكنك أيضًا الضغط على «تجميع جميع الأصول المؤهلة الآن». كلما رفعت الحد قلّ عدد مرات التجميع، وقلّ معه احتساب الحد الأدنى للرسوم في كل مرة.
- السحب وتحويلات الأموال — يسحب «سحب» الأصول القابلة للسحب إلى عنوان خارجي، ويتطلب تفعيل التحقق بخطوتين أولًا؛ وتعرض الصفحة رسوم كل عملة والحد الأدنى للسحب وإجمالي الخصم، وتُخصم الرسوم بشكل منفصل فيصل المبلغ المُدخل كاملًا. ويمكنك كذلك ضبط قاعدة سحب تلقائي تسحب عند بلوغ الحد بعد اكتمال التجميع. أما «تحويلات الأموال» فتحوّل الأصول القابلة للسحب إلى رصيد الحساب بالدولار الأمريكي وفق سعر الصرف لحظتها، ولا يمكن التراجع عنها.
- المعاملات — المعاملات على السلسلة لجميع العناوين في مجموعة العناوين. تُوسم كل معاملة بالطلب المرتبط بها؛ وما لم يُطابق طلبًا يُوسم «غير مرتبط»، وما لم يُنشأ له طلب يُوسم «لم يُنشأ طلب».
- API السحب — صرف برمجي لا يستخدم إلا الأصول الموجودة في «قابل للسحب (مجمّع)». لا يمكن تشغيل «المفتاح الرئيسي» إلا بعد ضبط المفتاح العام للطرف المتكامل وعنوان IP واحد على الأقل في القائمة البيضاء، ويجب كذلك تحديد «السحب عبر API» لمفتاح API المستخدم في «إدارة API». يمكنك ضبط تأخير السحب ونمط خصم الرسوم وحد العملية الواحدة وقائمة العناوين البيضاء؛ وخلال فترة التأخير يمكنك من «سجلات السحب» إيقاف السحب مؤقتًا أو إلغاؤه أو معالجته فورًا.
استيراد عناوين الحفظ الذاتي: يُدخل العنوان فقط، ولا يلزم المفتاح الخاص ولا يُقبل. عند الاستيراد، استخدم المحفظة التي يتبع لها كل عنوان لتوقيع نص التحقق الذي تعرضه الصفحة توقيعَ رسالة، لإثبات ملكيتك للعنوان؛ لا يستهلك التوقيع أي أصول ولا يأذن بأي تحويل، ويبقى النص صالحًا 15 دقيقة. الشبكات المتاحة للاستيراد هي ما تعرضه الصفحة، والمدعوم عناوين TRON وEVM فقط؛ وبحد أقصى 20 عنوانًا في كل عملية استيراد و100 عنوان لكل سلسلة. لا يمكن حذف عنوان مربوط بتطبيق تدوير أو عليه طلبات لم تنتهِ صلاحيتها؛ ويحذف الحذف معه سجل المعاملات التي رُصدت على هذا العنوان.
إعداد الرموز: الدقة والإزاحة
يتضمّن إعداد الرموز معاملين يحدّدان معًا شكل المبلغ المستحق للعميل.
- الدقة: عدد المنازل العشرية للمبلغ، من 2 إلى 10. يُقترح ستة لـ USDT / USDC واثنان لـ TRX.
- إزاحة الاستقبال: عند وجود طلبات غير مدفوعة على عنوان واحد، يعدّل النظام الكسور الأخيرة للتمييز بينها.
- للإزاحة نوع ونطاق، ويجب أن يقع النطاق ضمن الدقة — لا تتحرك الإزاحة إلا ضمن الخانات العشرية التي تسمح بها الدقة.
لهذا بالضبط يجب دفع المبلغ الظاهر في صفحة الدفع حتى آخر كسر: الأرقام الأخيرة هي ما يحدد الطلب. دفع مبلغ أكثر أو أقل قليلًا قد يجعل النظام عاجزًا عن معرفة الطلب الذي تتبعه الحوالة.
تكامل برمجي
المرجع الكامل للواجهات في مركز وثائق المطوّرين: آلية مصادقة التوقيع، وأمثلة الطلبات والردود، ورموز الأخطاء، وأحداث الإشعار والتحقق من توقيعها؛ ويوصلك إليه مباشرةً «وثائق تكامل API» في الشريط الجانبي للوحة التحكم.
تُوقَّع طلبات إنشاء الطلب بـ App Key؛ وتُوقَّع الإشعارات التي ترسلها المنصة إليك بسر الإرسال، فتحقّق من التوقيع على خادمك. خيار «السماح بواجهات API المفتوحة الأخرى» في تفاصيل التطبيق معطّل افتراضيًا، وحين يكون معطّلًا لا تستطيع بيانات اعتماد التطبيق استدعاء سوى واجهات الاستلام وأسعار الصرف؛ وبعد تفعيله يمكن الاستعلام عن الخدمات الأخرى، لكن واجهات إنشاء الطلبات والخصم لا تقبل إلا مفاتيح API من «إدارة API».
استكشاف الأخطاء
- دفع العميل دون إشعار — عنوان استدعاء خاطئ أو رد خادم غير صحيح — راجع «سجل الإشعارات» أولًا: إذا لم يوجد سجل فتحقّق من رابط الإشعار الراجع في التطبيق، ويجب أن يكون عنوان https؛ وإذا وُجد سجل فاشل فتحقّق هل أعاد خادمك 2xx خلال 10 ثوانٍ، وبعد الإصلاح يمكنك الضغط على «إعادة الإرسال». وتأكّد أيضًا أن التحقق من التوقيع يستخدم سر الإرسال الحالي.
- لم يُطابق التحويل طلبًا — المبلغ المدفوع لا يطابق المعروض — قد يحمل العنوان الواحد عدة طلبات بانتظار الدفع، ويميّز النظام بينها بإزاحة الخانات الأخيرة من المبلغ، لذا يجب دفع المبلغ المعروض في الصفحة بالضبط حتى آخر كسر. التحويلات التي لا تطابق أي طلب تُوسم «غير مرتبط» في «المعاملات».
- تعذّر تخصيص عنوان استلام — لا توجد عناوين شاغرة في مجموعة العناوين وبلغ التخصيص التلقائي حدّه؛ أو لا تتضمن عناوين التدوير عنوانًا على هذه السلسلة — 1 إلى 1: إذا لم تكن في مجموعة عناوينك عناوين شاغرة، تخصّص المنصة عناوين تلقائيًا، بحد أقصى 1000 عنوان لكل سلسلة كل 24 ساعة؛ وبعد تجاوز ذلك فكّ ربط العناوين التي لم تعد تستخدمها أو استورد عناوينك الخاصة. التدوير: إذا ضُبطت عناوين تدوير في التطبيق فلا يُستخدم سواها، فتأكّد أن القائمة تتضمن عنوانًا على هذه السلسلة.
- API السحب يقول لا رصيد — ما زالت الأموال على السلسلة بانتظار التجميع، أو استُلمت على عنوان بحفظ ذاتي — افتح «الأصول» وراجع «قابل للسحب (مجمّع)». يمكن تجميع ما ينتظر التجميع بالضغط على «تجميع جميع الأصول المؤهلة الآن» في «إعدادات التجميع»؛ أما أموال عناوين الحفظ الذاتي فلا تمرّ بالمنصة ولا يمكن صرفها عبر السحب عبر API.
- التطبيق الذي يستخدم عناوين حفظ ذاتي لا يقبل طلبات جديدة — رصيد الحساب أقل من 0 — تُخصم رسوم الحفظ الذاتي من رصيد الحساب. بعد أن يعود الرصيد فوق 0 بالشحن يُستأنف كل شيء تلقائيًا، وتُرسل إشعارات 1 إلى 1 المؤجّلة تلقائيًا.
- وصل تحويل صغير جدًا إلى عنوان 1 إلى 1 ولم يُنشأ له طلب — لا يُنشأ طلب للمبالغ الواردة التي تقل قيمتها عن 0.01 دولار أمريكي — وصلت الأموال إلى العنوان، لكن لا يُنشأ لها طلب ولا يُرسل إشعار. تظهر هذه المعاملة في «المعاملات» بوسم «لم يُنشأ طلب».
- رُفض إنشاء طلب استلام جديد أو ربط عنوان جديد — الحساب مقيّد أو مجمّد — في هذه الحالة لا يمكن إنشاء طلبات استلام جديدة ولا ربط عناوين جديدة؛ ويظل بالإمكان الاستعلام عن الطلبات الحالية وإغلاقها. يُرجى التواصل مع الدعم.
الأسئلة الشائعة
دفع العميل لكن النظام لم يتلقَّ إشعارًا، فماذا أفعل؟
راجع «سجل الإشعارات» أولًا: إذا لم يوجد سجل إرسال، فتحقّق أن رابط الإشعار الراجع في التطبيق صحيح وأنه عنوان https؛ وإذا وُجد إرسال فاشل، فمعناه أن خادمك لم يُعِد 2xx خلال 10 ثوانٍ. بعد الإصلاح يمكنك الضغط على «إعادة الإرسال» في السجل، كما تعيد المنصة الإرسال تلقائيًا وفق جدول إعادة المحاولة.
أين أرى الرسوم، ومتى تُخصم؟
اطّلع على السعر المعمول به حاليًا في «قواعد رسوم المنصة» ضمن «الأصول ← إعدادات التجميع». تُخصم رسوم الأموال الواردة إلى عناوين الحفظ لدى المنصة عند التجميع، وتُخصم رسوم عناوين الحفظ الذاتي من رصيد الحساب بعد وصول كل دفعة. سطر «الرسوم» في تفاصيل الطلب قيمة استرشادية فقط بالنسبة إلى الحفظ لدى المنصة، والمعتمد هو ما يُحتسب عند التجميع.
لماذا يجب أن يدفع العميل المبلغ الدقيق المعروض في الصفحة؟
لأن العنوان الواحد قد يحمل عدة طلبات بانتظار الدفع في الوقت نفسه، ويميّز النظام بينها بإزاحة الخانات الأخيرة من المبلغ. إذا لم يتطابق المبلغ، فقد يتعذّر ربط التحويل بطلبه تلقائيًا.
صفحات ذات صلة: مركز المساعدة · أدلة وأسئلة شائعة · مدفوعات مشفّرة متعددة السلاسل · وثائق الواجهة البرمجية
جارٍ التحميل…