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

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

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

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

الرسوم 1.5% من مبلغ الفاتورة، وهي نسبة ثابتة لكل الفواتير دون تخفيضات بحسب حجم المدفوعات.

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

• تُحدَّد الرسوم وتُثبَّت لحظة الدفع. فأي تغيير لاحق في النسبة لا يمسّ فاتورة دُفعت من قبل.
• وتُقرَّب الرسوم نحو الأدنى إلى أصغر وحدة في العملة، لذا قد لا تُفرض أي رسوم على فاتورة صغيرة جدًا.

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

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

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

حدود التحويل

يخضع transfer إلى حد أقصى لكل تحويل قدره 25,000 دولار، محسوبًا كمقابل بالدولار الأمريكي لا كمبلغ منفصل لكل أصل. وقد يُوضع حد أدنى لكل تحويل أيضًا؛ لا يوجد حد أدنى حاليًا. عالج amount_too_big في التكامل، وكذلك amount_too_small إذا فُرض حد أدنى لاحقًا، عندما يُرفض المبلغ بسبب هذه الحدود (وكلاهما 400). ولا يُطبَّق الحد الأقصى على عملة ليس لها سعر بالدولار في تلك اللحظة.

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

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

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

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

يمكن للمالك ضبط حد على آخر 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 نفسه، ولا يأخذ مفتاحًا جديدًا إلا دفعٌ جديد فعلًا.

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

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

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

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