كيف تقبل مدفوعات USDT (TRC20) في موقعك أو بوتك

USDT على TRON هو أشيع وسيلة للدفع بالكريبتو في مناطق كثيرة: تحويلات سريعة ورخيصة للدافع. يعرض هذا الدليل الحد الأدنى من التكامل مع ChainPay.

النموذج

يطلب الـ backend لديك من ChainPay عنوان إيداع لكل طلب (أو لكل مستخدم).
يرسل الدافع USDT إلى هذا العنوان.
بعد تأكيد الشبكة للتحويل يحوّله ChainPay إلى محفظتك ويستدعي الـ webhook.

الحيازة تبقى لديك: الوجهة هي forwardAddress الخاص بك، ولا يحتفظ ChainPay برصيد للتاجر.

عنوان واحد لكل طلب أو لكل مستخدم

لكل طلب: استخدم externalReference جديدًا لكل طلب. مطابقة سهلة، دفعة واحدة لكل عنوان.
لكل مستخدم: أعد استخدام externalReference نفسه. العنوان دائم ويستقبل إيداعات كثيرة؛ يناسب الشحن والأرصدة.

أنشئ العنوان

curl -X POST https://api.chainpay.site/deposit-address \
  -H 'content-type: application/json' \
  -d '{
    "ticker": "trc20/usdt",
    "callbackUrl": "https://shop.example.com/crypto-webhook?token=SECRET",
    "forwardAddress": "TYourOwnTronWallet...",
    "externalReference": "order-123"
  }'

عالِج الـ webhook

تحقق من قيمة token في الاستعلام.
طابِق الدفعة عبر externalReference.
اعتمد الطلب فقط عند status: "confirmed".
اجعل المعالج idempotent: قد يصل الحدث نفسه أكثر من مرة.

ما الذي يدفعه الدافع

يحتاج كل تحويل TRC20 إلى TRON Energy، لذا تتكون الرسوم من نسبة مئوية (1 %) وجزء ثابت يُسعَّر وفق تكلفة الشبكة الحالية. على TRON يبلغ هذا الجزء الثابت نحو 4 USDT بالأسعار الحالية، فلا تُجدي المبالغ الصغيرة جدًا. حدّد حدًّا أدنى معقولًا. الأرقام الحالية في الأسعار.

جرّبه

إن أردت رؤية العنوان في حسابك فسجّل في cabinet وأنشئ API key وأرسل الطلب نفسه مع x-api-key. ابدأ بمبلغ صغير.