رسوم واجهة التجار وحدودها

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

رسوم الفاتورة

يدفع الدافع دائمًا المبلغ الاسمي للفاتورة. أما الرسوم فتُقتطع من جانب التاجر: إذ يُضاف إلى رصيد تطبيقك المبلغ بعد خصم الرسوم.

والرسوم 3% من مبلغ الفاتورة، وتنخفض تلقائيًا كلما ارتفع حجم مدفوعاتك في آخر 30 يومًا:

وقاعدتان أهم من الرقم نفسه:

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

ولتعرف ما اقتُطع بالضبط، اقرأ fee_asset و fee_amount من الفاتورة المدفوعة — من حمولة ويب هوك invoice_paid أو من getInvoices. وهذا هو الرقم المعتمد في دفاترك.

ولا يعيد الاسترداد الرسوم: فما ترسله refundInvoice إلى الدافع يخرج من رصيدك، والرسوم لا تُستردّ — ولا حتى في استرداد جزئي.

وعلى تحصيلات الاشتراك أيضًا رسوم على جانب التاجر؛ ويُبلِغ كل تحصيل عن رقمه في الحقل charge.fee من ويب هوك subscription_charged.

حدود التحويل

لكل تحويل عبر transfer حدٌّ أدنى وحدٌّ أقصى، ويُطبَّقان تقديرًا بما يعادل الدولار الأمريكي بالأسعار الحالية، لا رقمًا لكل عملة على حدة. وأي مبلغ خارج هذا المدى يُرفض بخطأ صريح، فعالج amount_too_small و amount_too_big في تكاملك.

ويفشل التحويل أيضًا في هذه الحالات:

• رصيد تطبيقك لا يكفي بتلك العملة،
• المستلِم ليس مستخدمًا في التطبيق — فالدفع إلى معرّف تيليجرام مجهول أو مكتوب خطأ يفشل بخطأ صريح بدل أن يضيف المال إلى محفظة لن يفتحها أحد،
• حساب المستلِم محظور.

حدود عدد الطلبات

للطرق التي تحرّك الأموال حدٌّ لعدد الطلبات لكل تطبيق (مشترك بين كل رموزه): createInvoice و createCheck بـ 60 في الدقيقة، و refundInvoice و transfer بـ 30، و transferBatch بـ 10. أما طرق القراءة فبلا حد. والتكامل المنضبط لا يلحظ هذا أبدًا؛ أما حلقة إعادة المحاولة فتلحظه — فخفّف وتيرتك عند rate_limited بدل أن تواصل الطَّرق.

منع التكرار

تشترط transfer مفتاح spend_id من توليدك أنت؛ وتقبله createCheck و refundInvoice. وإعادة استعمال القيمة نفسها تعيد النتيجة الأصلية بدل تحريك الأموال مرة ثانية — فالطلب الذي انتهت مهلته يمكن إعادته بأمان بـ spend_id نفسه، ولا يأخذ مفتاحًا جديدًا إلا دفعٌ جديد فعلًا.

ما لا يكلّف شيئًا

لا توجد رسوم شبكة في أي موضع من واجهة التجار — فالفواتير والتحويلات والشيكات كلها تُسوَّى داخل التطبيق، خارج الشبكة. ورسوم المنصة على الفواتير هي الاقتطاع الوحيد.

⚠️ لا تشتقّ الرسوم بنفسك

لا تكتب نسبة ثابتة في شيفرتك، ولا تُعِد حساب الصافي من المبلغ الاسمي. فالشرائح والنسب تتغير، والثابت القديم يفسد حساباتك في صمت. اقرأ الرسوم المسجّلة من الفاتورة في كل مرة.