FA
پنل‌های VPN

پرداخت کریپتو برای Remnawave

برای پنل VPN خود در Remnawave، USDT دریافت کنید. این سرویس کوچک برای یک پلن فاکتور SnapEX Pay می‌سازد و مشتری را به صفحه پرداخت میزبانی‌شده می‌فرستد. وقتی SnapEX Pay پرداخت را تأیید کرد، کاربر Remnawave را می‌سازد یا کاربر موجود را تمدید می‌کند و لینک اشتراک را به شما می‌دهد. کنار پنل شما در Docker اجرا می‌شود و بک‌اند فروشگاه یا ربات تلگرام از طریق یک HTTP API با دو endpoint آن را کنترل می‌کند.

دانلود ماژول

رایگان. نسخه 1.0.0.

چه کاری انجام می‌دهد

  • صفحه پرداخت توسط SnapEX Pay میزبانی می‌شود: USDT در TRON (TRC20)، Ethereum (ERC20) یا BNB Chain (BEP20)؛ وقتی برای آن مبلغ مسیر تبدیل موجود باشد، کوین‌های دیگر هم نمایش داده می‌شوند.
  • پس از پرداخت، یک کاربر Remnawave می‌سازد (ACTIVE، با تاریخ انقضا، محدودیت ترافیک، Telegram ID اختیاری و internal squadها) یا کاربر موجود را تمدید می‌کند. در تمدید، روزهای پلن به هر کدام که دیرتر است اضافه می‌شود: الان یا تاریخ انقضای فعلی.
  • وب‌هوک‌ها با HMAC-SHA256 و بازه ۵ دقیقه بررسی می‌شوند؛ سپس وضعیت فاکتور دوباره از API SnapEX Pay خوانده می‌شود و فقط فاکتور پرداخت‌شده کاربر را می‌سازد.
  • ایمن در برابر تکرار: اگر همان وب‌هوک دو بار برسد، حتی هم‌زمان، کاربر فقط یک بار ساخته می‌شود.
  • پلن‌ها در یک متغیر محیطی؛ داده‌ها در یک فایل SQLite، بدون پایگاه داده خارجی.

نصب

  1. در Remnawave به Remnawave Settings → API Tokens بروید و یک توکن بسازید (نه JWT ورود ادمین — پنل آن را برای فراخوانی API رد می‌کند). UUID مربوط به internal squadهایی را که کاربران جدید باید بگیرند کپی کنید.
  2. در پنل فروشنده SnapEX Pay یک کلید API با دسترسی‌های invoices.read و invoices.write بسازید.
  3. آرشیو را دانلود و از حالت فشرده خارج کنید، cp .env.example .env را اجرا کنید و SNAPEX_API_KEY، REMNAWAVE_URL، REMNAWAVE_TOKEN، REMNAWAVE_SQUADS و یک API_TOKEN تصادفی طولانی را تنظیم کنید.
  4. اجرا کنید: docker compose up -d، curl -s http://127.0.0.1:8080/health را بررسی کنید و سرویس را پشت reverse proxy با HTTPS قرار دهید.
  5. در پنل یک endpoint وب‌هوک https://<your service>/webhook اضافه کنید، رمز whsec_… آن را در SNAPEX_WEBHOOK_SECRET بگذارید و ری‌استارت کنید.
  6. از بک‌اند یا ربات خود POST /v1/checkout را با Authorization: Bearer <API_TOKEN> فراخوانی کنید، pay_url را برای مشتری بفرستید و برای لینک اشتراک GET /v1/orders/{invoice_id} را بررسی کنید.

تنظیمات

SNAPEX_API_KEY, SNAPEX_WEBHOOK_SECRETکلید API فروشنده (invoices.read، invoices.write) و رمز امضای وب‌هوک (whsec_…).
SNAPEX_ENVIRONMENT, SNAPEX_FEE_ONlive یا test (فاکتورهای تست بدون پول واقعی تأیید می‌شوند)؛ چه کسی کارمزد سرویس را می‌پردازد — merchant یا customer.
REMNAWAVE_URL, REMNAWAVE_TOKENآدرس پنل (یا http://remnawave:3000 در یک شبکه Docker مشترک) و توکن API Remnawave.
REMNAWAVE_SQUADSUUID مربوط به internal squadها برای کاربران جدید. کاربر بدون squad هیچ inbound ندارد و اشتراکش خالی خواهد بود.
API_TOKENتوکن Bearer که فروشگاه یا ربات شما به /v1/checkout و /v1/orders/… می‌فرستد.
PLANSid:days:usd:traffic_bytes، جداشده با کاما؛ مقدار 0 بایت = نامحدود.

سؤالات

کدام نسخه‌های Remnawave پشتیبانی می‌شوند؟

Remnawave 2.2 یا جدیدتر؛ تست‌شده روی 3.4.5.

چرا اشتراک کاربر جدید خالی است؟

کاربر بدون internal squad هیچ inbound ندارد. UUID مربوط به squadها را برای کاربران جدید در REMNAWAVE_SQUADS قرار دهید؛ کاربران موجود squadهای خود را حفظ می‌کنند.

تمدید چگونه کار می‌کند؟

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

آیا یک پرداخت می‌تواند کاربر را دو بار بسازد؟

خیر. حتی اگر همان وب‌هوک دو بار و هم‌زمان برسد، کاربر فقط یک بار ساخته می‌شود.

ربات تلگرام آماده وجود دارد؟

بله، یک ربات تلگرام جداگانه SnapEX Pay برای Marzban، 3x-ui و Remnawave. این سرویس زمانی مناسب است که ربات یا فروشگاه خودتان را دارید.

آماده دریافت کریپتو هستید؟

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