→ كل الشروحات

الشرح 10 / 12

اقبل المدفوعات لعدة بائعين.

دفعة عميل واحدة وأرصدة منفصلة للبائعين وتحويلات صرف تحت التحكم.

ما الذي ستحصل عليه

صفحة دفع لثلاثة بائعين بعمولة 4% وسياسة صرف تمت مراجعتها.

1. جهّز المشروع

افتح المشروع ← السوق ← الإعدادات. فعّل السوق واختر المتاجر المشاركة. أبقِ صرف المستحقات موقوفًا الآن. انسخ محافظ المشروع احتياطيًا وفعّل Bitcoin أو وسائل EVM المدعومة في كل متجر.

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

2. أضف ثلاثة بائعين واعتمدهم

في البائعين، أضف كل بائع وعنوانًا على شبكة Bitcoin الرئيسية. أكد العنوان مع البائع بشكل مستقل قبل اعتماده. ولرموز EVM، يحتاج كل بائع أيضًا إلى عنوان معتمد على الشبكة المحددة نفسها.

حدد عمولة المشروع على 4%. تُحفظ لقطة لإعدادات التجاوز الخاصة بالمتجر والبائع والفاتورة المصرح بها، فلا تغير التعديلات اللاحقة توزيعًا موجودًا.

3. أنشئ الفاتورة المشتركة

في السوق ← الفواتير، أنشئ فاتورة 300 USD بثلاث حصص إجمالية للبائعين قيمة كل منها 100 USD. يجب أن يتطابق مجموعها تمامًا. أرسل رابط الدفع للعميل.

لتكامل API، استخدم مفتاح سوق منفصلًا وأرسل المبالغ كسلاسل عشرية إلى /v1/marketplace/invoices. احفظ مفتاح عدم التكرار قبل الطلب وأعد استخدامه بعد انتهاء المهلة. أمثلة الطلبات ←

4. راجع وأرسل

انتظر حتى تصبح التوزيعات المتحقق منها متاحة. وفق السعر المثبت، يحصل كل بائع على ما يعادل 96 USD بالأصل المدفوع وتحتفظ بعمولة تعادل 12 USD. تكلف رسوم المعالجة الحالية 1%، إن كانت مضبوطة، 3 USD من الرصيد المسبق. رسوم الشبكة منفصلة.

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

5. فعّل الأتمتة بحذر

في الإعدادات، أضف سياسة لأصل واحد: حد الصرف الأدنى، وحدود المبلغ لكل عملية ويوميًا، وميزانيات الرسوم الأصلية والغاز، والفاصل والتأكيدات. لا تفعّلها إلا بعد مراجعة الحدود والوجهات، ثم ألغِ إيقاف الصرف.

يمكن للسياسات التلقائية الإرسال دون نقرات إضافية. يظل انخفاض الرصيد أو حاجز التحويل في الخادم قادرًا على إيقاف الإنفاق. تستمر المراقبة ودفتر القيود.

6. عالج الحالات الاستثنائية دون إرسال مكرر

  • دفع ناقص: لا ينشئ تسامح صفحة الدفع أرصدة بائعين غير ممولة. انتظر المزيد أو أعد المبلغ أو وافق صراحة على تقسيم أصغر مغطى بالكامل.
  • غاز رموز ناقص: أضف عملات أصلية حرة لمحفظة المشروع وراجع عملية الصرف المحتفظ بها. لا تنشئ عملية ثانية لتجاوزها.
  • انتهاء مهلة webhook: أعد محاولة الحدث الموقّع نفسه. تحقق من توقيعه الخام ومشروعه واحفظ event_id بقيد فريد ثم أقرّ الاستلام. حدث تسوية الفاتورة لا يعني اكتمال صرف المستحقات.
  • استرداد بعد الدفع للبائعين: موّل المحفظة الأساسية بشكل منفصل وتحقق من عنوان العميل وجهّز استردادًا كاملًا بالأصل نفسه ووافق عليه. لا تُخصم أرصدة البائعين تلقائيًا.
  • استعادة أو بث غير مؤكد: أبقِ صرف المستحقات موقوفًا وطابق بصمات المعاملات المحتفظ بها قبل الاستئناف. لا تفترض أن انتهاء المهلة يعني عدم الإرسال.

ابنِ سلة مشتركة: شرح سوق العملات المشفرة ←

ملاحظات تشغيلية · API والصلاحيات والأحداث