يتيح لك الدفع الجماعي تنفيذ دفعة من عمليات سحب العملات المشفرة من ملف CSV واحد. تتم معاملة كل عملية رفع كعملية تجارية واحدة. تشترك كل معاملة ناتجة في نفس Batch ID، بحيث يمكنك تتبع الدفعة بأكملها وتسويتها وإعداد التقارير عنها من مكان واحد.
الدفع الجماعي متاح في ثلاثة أماكن:
- منطقة العميل — قم بالرفع والمعاينة والحفظ كمسودة والتأكيد باستخدام 2FA في المحفظة عبر الويب.
- API العميل — أرسل الدفعات برمجياً باستخدام مصادقة API الخاصة بك. راجع مرجع API على https://docs.xbo.com/#mass-crypto-withdrawal.
- CRM Back Office — بالنسبة للدفعات التي تتجاوز حد الموافقة الذي قمت بتكوينه، يقوم مشغّل من xbo بمراجعة الدفعة بأكملها والموافقة عليها أو رفضها.
قبل أن تبدأ
- لديك حساب مؤسسي نشط مع أذونات السحب.
- 2FA مفعّل (إلزامي لتأكيد منطقة العميل).
- يغطي رصيد محفظتك إجمالي مبلغ الدفع بالإضافة إلى إجمالي العمولة.
- إذا كنت تخطط للخصم من عملة والدفع بعملة أخرى (على سبيل المثال، الخصم بـ USD والدفع بـ USDT)، فيجب أن تكون محفظة العملة المصدر موجودة وأن يكون بها رصيد كافٍ لتغطية المبلغ المحوّل بالإضافة إلى العمولة.
الخطوة 1 — جهّز ملف CSV الخاص بك
يجب أن يتبع ملفك هذه القواعد:
|
القاعدة |
التفاصيل |
|
نوع الملف |
CSV فقط |
|
الفاصل |
فاصلة (,) أو فاصلة منقوطة (;) |
|
صف الرأس |
يجب أن يحتوي الصف الأول على أسماء الأعمدة |
|
الأعمدة الإلزامية |
العملة، العنوان، المبلغ (الشبكة عند الاقتضاء) |
|
الأعمدة الاختيارية |
اسم المستلم وحقول Travel Rule / المستفيد (بمجرد التفعيل)؛ يمكن تقديمها جزئياً لكل صف |
|
تنسيق المبلغ |
بدون مسافات أو فواصل آلاف؛ نقطة (.) كعلامة عشرية؛ حتى 8 أرقام بعد العلامة العشرية |
|
تنسيق العنوان |
إلزامي؛ بدون مسافات؛ أحرف وأرقام فقط |
|
قاعدة العملة |
عملة دفع واحدة لكل ملف. العملة المصدر المراد الخصم منها هي حقل في واجهة المستخدم / API، وليست عمود CSV |
|
حجم الملف |
5 MB كحد أقصى |
الخطوة 2 — الرفع والمعاينة
- افتح منطقة العميل وحدد الدفع الجماعي من القائمة.
- اسحب ملف CSV وأفلته في منطقة الرفع، أو انقر للتصفح.
- اختياريًا، حدد عملة مصدر للتحويل منها. يقوم النظام بإجراء عملية تحويل مجمّعة واحدة لكل عملة لكل دفعة عند التأكيد.
- يتحقق النظام من بنية الملف، ثم من كل صف. إذا فشل التحقق في أي خطوة، فسترى أي خطوة فشلت ولماذا.
- راجع شاشة المعاينة — يتم إدراج كل مستلم وشبكة ومبلغ قبل تنفيذ أي عملية دفع.
- اختياري — احفظ كمسودة. يمكن لزميل لديه الدور المناسب فتح المسودة ومراجعتها وتأكيدها باستخدام MFA الخاص به.
الخطوة 3 — التأكيد
في ملخص التأكيد سترى:
- عدد المعاملات في الدفعة
- المبلغ الإجمالي والعمولة الإجمالية
- تفصيل الشبكة حسب العملة
- تفاصيل تحويل العملة المصدر (إذا اخترت واحدة)
أكّد باستخدام 2FA. إذا كنت تستخدم API العميل، فستتم مصادقة الطلب باستخدام بيانات اعتماد API الخاصة بك. بمجرد التأكيد، يتم إنشاء كل معاملة بحالة قيد الانتظار وتكون مرئية في سجل معاملاتك مع Batch ID الجديد.
الخطوة 4 — الموافقة (عند الحاجة)
يحتوي حسابك على حد أقصى قابل للتكوين للدفعة (Max Batch) يمكن معالجته دون موافقة المكتب الخلفي. إذا تجاوزت دفعتك ذلك الحد، فإنها تنتقل إلى حالة في انتظار الموافقة على الدفعة. يراجع فريق العمليات في xbo ملخص الدفعة حسب العملة والشبكة وعدد المعاملات والمبلغ الإجمالي ويوافق على الدفعة بأكملها أو يرفضها. الموافقة الجزئية غير مدعومة.
الخطوة 5 — المعالجة وإعداد التقارير والتسوية
- شبكات UTXO (على سبيل المثال BTC) — يتم إرسال الدفعة كمعاملة واحدة على السلسلة (on-chain) متعددة الوجهات. الملفات الأكبر من حد المنصة (حالياً حوالي 650 وجهة لكل معاملة على السلسلة لـ BTC) يتم تقسيمها تلقائياً؛ كل تقسيم هو معاملة شبكة واحدة.
- الشبكات القائمة على الحسابات (على سبيل المثال ETH وSOL والعملات المستقرة) — يتم إرسال كل صف كمعاملته الخاصة على السلسلة.
- عزل الأعطال — إذا فشلت دفعة داخلية واحدة، فستستمر معالجة الدفعات المتبقية.
- تقرير النتائج — بمجرد اكتمال المعالجة، قم بتنزيل ملف CSV بنفس بنية مدخلاتك بالإضافة إلى عمود الحالة / الخطأ لكل صف.
- كشوف الحسابات وسجل المعاملات — تحمل كل معاملة Batch ID؛ يمكنك التصفية والتصدير حسب الدفعة.
