VPN panelleri

3x-ui için kripto ödemeler

Q: Hangi 3x-ui sürümleri destekleniyor?

3x-ui 2.x ve 3.x: hem yeni /panel/api/clients API'si hem de eski inbounds/addClient API'si.

Q: Panelimde iki adımlı giriş var. Çalışır mı?

3x-ui 3.x'te evet: kullanıcı adı ve şifre yerine XUI_API_TOKEN (panel API token'ı) ayarlayın.

3x-ui panelinizin SnapEX Pay üzerinden kripto ödeme almasını sağlayan, kendi sunucunuzda çalışan küçük bir servis. Telegram botunuz veya siteniz servisten bir ödeme linki ister, müşteri SnapEX Pay sayfasında USDT ile öder; fatura ödenince servis inbound'unuza bir istemci ekler ya da mevcut istemciyi uzatır ve abonelik linkini döndürür. 3x-ui'nin kendi faturalandırması yoktur; bu servis mağazanız ile panel arasındaki ödeme katmanıdır.

Modülü indir

Ücretsiz. Sürüm 1.1.0.

Ne yapar

Her sipariş kendi SnapEX Pay faturasını ve pay_url linkini alır. Müşteriler TRC20, ERC20, BEP20, Solana, TON veya başka bir ağda USDT ile öder; SnapEX Pay sunabildiğinde ödeme sayfasında başka kripto paralar da görünebilir.
Yeni bir kullanıcı adı XUI_INBOUND_ID üzerinde yeni bir istemci olur. Mevcut olan yenilenir: bitiş tarihi ileri alınır (süresi dolmuşsa şu andan itibaren sayılır; bitiş tarihi olmayan istemci sınırsız kalır), istemci yeniden etkinleştirilir ve kotalı paketlerde trafik sıfırlanır. UUID ve subId değişmez, böylece müşterinin yapılandırması çalışmaya devam eder.
3x-ui 2.x ve 3.x ile çalışır: panelde varsa yeni /panel/api/clients API'sini, yoksa eski inbounds/addClient API'sini kullanır.
Güvenli webhook'lar: 5 dakikalık zaman aralığıyla HMAC-SHA256 imzaları, fatura durumu her zaman SnapEX Pay API'sinden yeniden okunur ve her fatura yalnızca bir kez işlenir.
Paketler (gün, USD fiyatı, trafik kotası) tek bir ortam değişkeninde. Tek konteyner: FastAPI ve SQLite.

Kurulum

SnapEX Pay üye işyeri panelinde invoices.read ve invoices.write yetkilerine sahip bir API anahtarı oluşturun.
Arşivi indirip açın, klasöründe cp .env.example .env komutunu çalıştırın ve SNAPEX_API_KEY, API_TOKEN, XUI_URL (web base path ile birlikte), XUI_USERNAME ve XUI_PASSWORD, XUI_INBOUND_ID ve XUI_SUB_URL değerlerini doldurun.
Başlatın: docker compose up -d, ardından curl http://localhost:8080/health ile kontrol edin.
Servisi HTTPS arkasına koyun (nginx, Caddy, Traefik). SnapEX Pay panelinin “Geliştiriciler” bölümünde webhook URL'sini https://<your service>/webhook olarak ayarlayın, whsec_… imzalama gizli anahtarını (yalnızca bir kez, URL ilk kaydedildiğinde gösterilir) SNAPEX_WEBHOOK_SECRET değişkenine yazın ve docker compose up -d komutunu yeniden çalıştırın.
Botunuzdan veya backend'inizden Authorization: Bearer <API_TOKEN> ile POST /v1/checkout çağırın, pay_url linkini müşteriye gönderin ve abonelik linki için GET /v1/orders/{invoice_id} adresini kontrol edin.

Ayarlar

SNAPEX_API_KEY, SNAPEX_WEBHOOK_SECRET	Üye işyeri API anahtarı (`invoices.read`, `invoices.write`) ve webhook imzalama gizli anahtarı (`whsec_…`).
SNAPEX_ENVIRONMENT, SNAPEX_FEE_ON	`live` veya `test` faturalar; hizmet komisyonunu kimin ödediği — `merchant` veya `customer`.
API_TOKEN	`/v1/checkout` ve `/v1/orders` için Bearer token.
XUI_URL	Web base path dahil panel URL'si, örneğin `https://xui.example.com:2053/secretpath`.
XUI_API_TOKEN	Yalnızca 3x-ui 3.x: kullanıcı adı ve şifre yerine kullanılan panel API token'ı (iki adımlı girişi olan paneller için).
XUI_INBOUND_ID, XUI_SUB_URL	Yeni istemciler için inbound (VLESS, VMess, Trojan, Shadowsocks veya Hysteria) ve abonelik öneki.
PLANS	Virgülle ayrılmış `id:days:usd:traffic_bytes`, `0` bayt = sınırsız.
SNAPEX_PARTNER_ID	İsteğe bağlı: modülü kuran entegratörün Partner ID'si (SnapEX Pay referans programı). Modülü kendiniz kurduysanız boş bırakın.

Sorular

Hangi 3x-ui sürümleri destekleniyor?

3x-ui 2.x ve 3.x: hem yeni /panel/api/clients API'si hem de eski inbounds/addClient API'si.

Müşteri aboneliğini yenilediğinde ne olur?

Aynı kullanıcı adını yeniden gönderin. İstemci UUID'sini ve subId değerini korur, bitiş tarihi ileri alınır, istemci yeniden etkinleştirilir ve kotalı paketlerde trafik sıfırlanır.

Panelimde iki adımlı giriş var. Çalışır mı?

3x-ui 3.x'te evet: kullanıcı adı ve şifre yerine XUI_API_TOKEN (panel API token'ı) ayarlayın.

Bir ödeme iki kez işlenebilir mi?

Hayır. Webhook iki kez gelse veya iki kopyası aynı anda ulaşsa bile her fatura yalnızca bir kez işlenir.

Hazır bir Telegram botu var mı?

Evet, Marzban, 3x-ui ve Remnawave için ayrı bir SnapEX Pay Telegram botu var. Bu servis, zaten kendi botunuz veya siteniz varsa uygundur.

Diğer entegrasyonlar

WHMCS BILLmanager FOSSBilling Paymenter Blesta WooCommerce CS-Cart Xboard / V2Board Marzban Remnawave Telegram VPN botu n8n

Kripto ile ödeme almaya hazır mısınız?

Üye işyeri hesabı oluşturun, API anahtarı alın ve modülü bağlayın. Ödeme başına %1 komisyon, aylık ücret yok.