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

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

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

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

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

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

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

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

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

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

حدود التحويل

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

أما username غير المعروف فينشئ دفعة معلّقة إذا سمح وضع المدفوعات الصادرة؛ راجع التحويلات والشيكات.

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

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

الحد اليومي للمدفوعات الصادرة

يمكن للمالك ضبط حد على آخر 24 ساعة في إعدادات المدفوعات. تتشارك التحويلات والشيكات والمدفوعات من رصيد التطبيق هذا الحد. يؤدي تجاوزه إلى 403 daily_cap_exceeded؛ وتُفحص الدفعة الجماعية قبل أول عملية دفع. لا تُحتسب الاستردادات ضمن هذا الحد. تعيد getMe الحقلين daily_payout_max_usd_cents وdaily_payout_spent_usd_cents.

قد تمنع قيود المالك التحويلات والشيكات والاستردادات أيضًا (403 verification_required)؛ ويعيد الإيقاف المؤقت 503 merchant_payouts_paused.

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

للطرق التي تحرّك الأموال حدود لعدد الطلبات لكل تطبيق، مشتركة بين رموزه: createInvoice وcreateCheck بمقدار 60 في الدقيقة، وrefundInvoice بمقدار 30 في الدقيقة، وtransfer بمقدار 30 في الدقيقة، وtransferBatch بمقدار 10 في الدقيقة. توجد حدود أيضًا لـupdateApp وcreateSubscriptionPlan؛ راجع مرجع الواجهة. عند ظهور rate_limited، زِد مدة الانتظار قبل إعادة المحاولة.

منع التكرار

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

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

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

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

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