إجابات على أسئلتك

يتيح لك الدفع الجماعي تنفيذ دفعة من عمليات سحب العملات المشفرة من ملف CSV واحد. تتم معاملة كل عملية رفع كعملية تجارية واحدة. تشترك كل معاملة ناتجة في نفس Batch ID، بحيث يمكنك تتبع الدفعة بأكملها وتسويتها وإعداد التقارير عنها من مكان واحد.

الدفع الجماعي متاح في ثلاثة أماكن:

• منطقة العميل — قم بالرفع والمعاينة والحفظ كمسودة والتأكيد باستخدام 2FA في المحفظة عبر الويب.
• API العميل — أرسل الدفعات برمجياً باستخدام مصادقة API الخاصة بك. راجع مرجع API على https://docs.xbo.com/#mass-crypto-withdrawal.
• CRM Back Office — بالنسبة للدفعات التي تتجاوز حد الموافقة الذي قمت بتكوينه، يقوم مشغّل من xbo بمراجعة الدفعة بأكملها والموافقة عليها أو رفضها.

قبل أن تبدأ

• لديك حساب مؤسسي نشط مع أذونات السحب.
• 2FA مفعّل (إلزامي لتأكيد منطقة العميل).
• يغطي رصيد محفظتك إجمالي مبلغ الدفع بالإضافة إلى إجمالي العمولة.
• إذا كنت تخطط للخصم من عملة والدفع بعملة أخرى (على سبيل المثال، الخصم بـ USD والدفع بـ USDT)، فيجب أن تكون محفظة العملة المصدر موجودة وأن يكون بها رصيد كافٍ لتغطية المبلغ المحوّل بالإضافة إلى العمولة.

الخطوة 1 — جهّز ملف CSV الخاص بك

يجب أن يتبع ملفك هذه القواعد:

الخطوة 2 — الرفع والمعاينة

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

الخطوة 3 — التأكيد

في ملخص التأكيد سترى:

• عدد المعاملات في الدفعة
• المبلغ الإجمالي والعمولة الإجمالية
• تفصيل الشبكة حسب العملة
• تفاصيل تحويل العملة المصدر (إذا اخترت واحدة)

أكّد باستخدام 2FA. إذا كنت تستخدم API العميل، فستتم مصادقة الطلب باستخدام بيانات اعتماد API الخاصة بك. بمجرد التأكيد، يتم إنشاء كل معاملة بحالة قيد الانتظار وتكون مرئية في سجل معاملاتك مع Batch ID الجديد.

الخطوة 4 — الموافقة (عند الحاجة)

يحتوي حسابك على حد أقصى قابل للتكوين للدفعة (Max Batch) يمكن معالجته دون موافقة المكتب الخلفي. إذا تجاوزت دفعتك ذلك الحد، فإنها تنتقل إلى حالة في انتظار الموافقة على الدفعة. يراجع فريق العمليات في xbo ملخص الدفعة حسب العملة والشبكة وعدد المعاملات والمبلغ الإجمالي ويوافق على الدفعة بأكملها أو يرفضها. الموافقة الجزئية غير مدعومة.

الخطوة 5 — المعالجة وإعداد التقارير والتسوية

• شبكات UTXO (على سبيل المثال BTC) — يتم إرسال الدفعة كمعاملة واحدة على السلسلة (on-chain) متعددة الوجهات. الملفات الأكبر من حد المنصة (حالياً حوالي 650 وجهة لكل معاملة على السلسلة لـ BTC) يتم تقسيمها تلقائياً؛ كل تقسيم هو معاملة شبكة واحدة.
• الشبكات القائمة على الحسابات (على سبيل المثال ETH وSOL والعملات المستقرة) — يتم إرسال كل صف كمعاملته الخاصة على السلسلة.
• عزل الأعطال — إذا فشلت دفعة داخلية واحدة، فستستمر معالجة الدفعات المتبقية.
• تقرير النتائج — بمجرد اكتمال المعالجة، قم بتنزيل ملف CSV بنفس بنية مدخلاتك بالإضافة إلى عمود الحالة / الخطأ لكل صف.
• كشوف الحسابات وسجل المعاملات — تحمل كل معاملة Batch ID؛ يمكنك التصفية والتصدير حسب الدفعة.

يستخدم Mass Payment رسوم السحب القياسية لديك لكل عملة / لكل شبكة. تُحتسب الرسوم بالإضافة إلى المبلغ في ملف CSV الخاص بك: يتلقى المستلم المبلغ الكامل الذي كتبته، ويُخصم من محفظتك المبلغ زائد الرسوم.

• شبكات UTXO مع التجميع على دفعات — تُجمَّع الرسوم لكل دفعة وتظهر في الصف الأول من الدفعة في سجل المعاملات وكشوف الحساب.
• الشبكات القائمة على الحسابات — كل صف هو معاملة منفصلة على السلسلة ويحمل رسومه الخاصة.
• مع تحويل عملة المصدر — تُحتسب الرسوم على عملة الدفع (مثل USDT) ويُخصم من محفظة المصدر المعادل المحوَّل.

تجميع رسوم الشبكة يعني إرسال معاملة واحدة على السلسلة للعديد من المستلمين بدلاً من معاملة واحدة لكل مستلم. ينطبق فقط على شبكات UTXO.

يتم تشغيل التحقق بهذا الترتيب. إذا فشلت خطوة، تتوقف المعالجة ويتم عرض الخطوة الفاشلة لك.

1. بنية الملف — أسماء الأعمدة، حجم الملف، عدد الصفوف، وجود الأعمدة الإلزامية.
2. رموز الصف — الأحرف، التنسيق، الدقة العشرية.
3. العملة — عملة دفع واحدة عبر جميع الصفوف.
4. رموز الشبكة — صالحة للعملة عند الاقتضاء.
5. الحد الأدنى لمبلغ السحب لكل صف.
6. الرصيد، وحدود السحب، وأي قيود نشطة (على سبيل المثال، حجز بعد الإيداع بالعملة الورقية).

يدعم Mass Payment الفصل بين المهام باستخدام تدفق المسودة والدفع لاحقًا:

• المُعِدّ — يرفع ملف CSV، ويُجري المعاينة، ويحفظ كمسودة.
• المُعتمِد — يفتح المسودة، ويراجع المستلمين والمبالغ، ويؤكد باستخدام MFA الخاص به.

إذا أرسلت الدفعات برمجيًا، فإن جميع القواعد المذكورة أعلاه تنطبق بشكل مماثل. اطّلع على المرجع الكامل لواجهة برمجة التطبيقات، بما في ذلك نقاط النهاية، وبُنى الطلب والاستجابة، ورموز الأخطاء، والأمثلة العملية، على:

https://docs.xbo.com/#mass-crypto-withdrawal

تحقق من صف الرأس، والفاصل (فاصلة أو فاصلة منقوطة فقط)، وحجم الملف (≤5 MB)، ومن وجود أعمدة العملة والعنوان والمبلغ. تُظهر رسالة الخطأ أيّ عمود أو قاعدة فشلت.

تجاوز المبلغ الإجمالي حدّ الحد الأقصى للدفعة الذي قمت بتكوينه للمعالجة التلقائية. سيراجع فريق عمليات xbo ويعتمد أو يرفض الدفعة بأكملها. سترى تغيُّر الحالة في سجل معاملاتك.

يضيف تقرير النتائج عمود حالة / خطأ إلى ملف CSV الأصلي الخاص بك. أعد تصدير الصفوف الفاشلة إلى ملف CSV جديد، وصحّح المشكلة (غالبًا عنوان غير صحيح التنسيق أو مبلغ أقل من الحد الأدنى)، وأرسلها كدفعة جديدة.

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

بمجرد تأكيد المعاملات ومعالجتها على السلسلة، لا يمكن عكسها. لا يزال بإمكان المُشغّل رفض الدفعات التي تنتظر الاعتماد.

لا. عملة دفع واحدة لكل ملف.

قم بتصفية سجل المعاملات أو تصدير كشف حسابك حسب معرّف الدفعة — كل معاملة في الدفعة تحمل المعرّف نفسه.

نعم. اطّلع.