API پرداخت تتر برای سایت و نرم‌افزار

اگر سایت یا نرم‌افزار اختصاصی دارید، API رمزپال مسیر دریافت تتر را به سفارش‌های شما متصل می‌کند: درخواست پرداخت را می‌سازید، مشتری را به صفحه پرداخت می‌فرستید و پس از بازگشت، نتیجه را از سرور بررسی می‌کنید.

مستندات کامل API و پاسخ‌ها · ساخت پذیرنده و دریافت کلید API

سه مرحله اتصال

  1. Request: مبلغ و آدرس بازگشت را به /api/v1/payment/request بفرستید و شناسه پرداخت را کنار سفارش ذخیره کنید.
  2. Redirect و Callback: مشتری را به همان redirect_url پاسخ هدایت کنید. لینک امضا دارد؛ آن را از روی شناسه بازسازی نکنید.
  3. Verify: شناسه پرداخت و مبلغ اصلی سفارش را از سرور به /api/v1/payment/verify بفرستید. نتیجه نهایی باید VERIFIED باشد.

نمونه ساخت پرداخت با cURL

نمونه زیر آموزشی است و با اجرا، یک درخواست واقعی ایجاد می‌کند. مقدار کلید را فقط در محیط امن سرور قرار دهید. پاسخ باید قبل از هدایت کاربر از نظر وضعیت HTTP و ساختار بررسی شود.

curl --fail-with-body https://ramzpal.com/api/v1/payment/request   -H "Authorization: Bearer YOUR_MERCHANT_API_KEY"   -H "Accept: application/json"   -H "Content-Type: application/json"   --data '{"amount":20,"callback_url":"https://shop.example/payment/callback","order_id":"order-1042","language":"en"}'

مبلغ بر حسب USDT است و باید بین ۱ تا ۵۰۰۰ باشد. order_id اختیاری است؛ اگر استفاده می‌کنید، برای هر سفارش شناسه مشخصی بگذارید و رفتار خطای سفارش تکراری را مطابق مستندات مدیریت کنید.

تأیید پرداخت پس از بازگشت

curl --fail-with-body https://ramzpal.com/api/v1/payment/verify   -H "Authorization: Bearer YOUR_MERCHANT_API_KEY"   -H "Accept: application/json"   -H "Content-Type: application/json"   --data '{"payment_id":"PAYMENT_ID_FROM_REQUEST","amount":20}'

شناسه را با پرداخت ذخیره‌شده همان سفارش تطبیق دهید و مبلغ را از داده‌های سفارش در سرور بخوانید؛ مبلغ ارسالی مرورگر مبنای تأیید نیست. پس از پاسخ موفق و وضعیت VERIFIED، سفارش را فقط یک بار پرداخت‌شده ثبت کنید. مسیر Callback ممکن است بیش از یک بار باز شود.

چند نکته که جلوی خطا را می‌گیرد

  • کلید API را در کد مرورگر، مخزن عمومی یا گزارش خطا قرار ندهید.
  • پارامتر success=true در Callback را به‌تنهایی سند پرداخت ندانید.
  • برای پاسخ ۴۲۲، تفاوت «پرداخت کامل نشده»، «مبلغ ناهماهنگ» و «سفارش تکراری» را بررسی کنید.
  • اگر Callback نرسید، وضعیت پنل و Verify را پیگیری کنید؛ وجه خودکار برگشت نمی‌خورد.
  • زمان انقضای لینک شروع پرداخت با زمان بررسی انتقال یکسان نیست. جزئیات جاری را در مستندات ببینید.

شبکه، هزینه و مسیر تسویه

درگاه فعلی تتر BEP20 می‌پذیرد. هزینه ثابت از اعتبار پرداخت پذیرنده برای پرداخت موفق تأمین می‌شود. دریافت وجه و انتقال آن به کیف پول تسویه، دو مرحله‌اند. تعرفه و تسویه و امنیت و نگهداری دارایی را در طراحی اتصال در نظر بگیرید.

اگر فروشگاه شما ووکامرسی است، افزونه آماده همین مسیر را پیاده‌سازی می‌کند.