BAŞLA

Belgeler

Kur, ödeme kabul et ve sunucunla ilgilen.

Yeni misin? Adım adım rehberleri takip et →

VPS gereksinimleri

Root erişimli yeni bir Linux VPS kullan; mevcut web sitesi veya veritabanı sunucunu kullanma. Docker, derleyici veya blokzincir düğümü gerekmez.

VPSAsgari
Hafif kullanım
Önerilen
CPU1 vCPU2 vCPU
RAM2 GB4 GB
SSD20 GB60 GB

Asgari değerler, minimal Ubuntu/Debian imajlarında hafif kullanım için bir başlangıç noktasıdır; performans garantisi değildir. Disk kapasitelerine Linux dahildir; kurulumdan önce en az 3 GiB boş alan ve ayrıca güncellemeler, geçmiş ve yedekler için alan bırak.

Yerel kurulum programının gereksinimleri: x86-64, systemd 247+ ve Python 3.9+. ARM64 ve Alpine/OpenRC dahil değildir.

Linux sürümleri ve kapasite notları
  • Ubuntu 22.04+ veya Debian 12+; Mint 21+ ve Pop!_OS 22+.
  • Fedora 42+; Rocky, AlmaLinux, RHEL, Oracle Linux veya CentOS Stream 9–10.
  • openSUSE Leap 16+ veya Tumbleweed; Arch, Manjaro veya EndeavourOS.

Üreticisi tarafından bakımı sürdürülen bir sürüm seç. İşletim sisteminin daha yüksek gereksinimleri önceliklidir: openSUSE Leap 16 40 GB'tan fazla disk alanı gerektirir.

Daha fazla zincir ve eş zamanlı fatura, daha fazla CPU ve RAM gerektirebilir. Daha büyük bir VPS, RPC kotalarını ortadan kaldırmaz. Kurulum akışlarının otomatik testleri vardır; her dağıtım için yeni VPS üzerinde tam testler tamamlanmış değildir.

Kur

Bu varsayılan ana makine adlarını VPS'ine yönlendir veya kendi adlarını seç:

  • merchant.example.com: konsol
  • pay.example.com: ödeme sayfası
  • api.example.com: API

Kurulum sırasında yalnızca DNS kayıtlarını kullan. Her iki güvenlik duvarında TCP 80/443'ü aç ve SSH erişimini koru. PostgreSQL'i veya uygulamayı 5432/8080 portlarından internete açma.

bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh)

Kurulum, indirmeleri doğrular; PostgreSQL, Nginx, HTTPS ve hizmetleri yapılandırır. Konteynerleri mi tercih ediyorsun? Şuna bak: isteğe bağlı Docker kurulumu.

Önce kontrol et veya kuruluma devam et

Belirli bir sürüm mü gerekiyor? Yeni bir VPS'te şu seçeneği ekle: --version 7.8.1 tam olarak o imzalı sürümü kurmak için. Bu seçenek yoksa kurulum en son kararlı sürümü kullanır.

Devam ettirme, GitHub yedek kaynağı kullanıldığında da seçilen sürümü ve tamamlanan adımları korur. Mevcut bir kurulumun sürümünü asla düşürmez.

Kurulum betiğini incele. Şunu ekle: --check kurulum yapmadan uyumluluk kontrolü için komuta; ya da --help seçenekleri görmek için.

Anahtarları veya ayarları değiştirmeden kaydedilen ilerlemeye devam et:

bash <(curl -fsSL https://releases.whollycrypto.com/setup_wholly.sh) --resume

Ek temel alan adları aynı hizmet adlarını kullanabilir. Tüm IPv6 kayıtları da bu VPS'e yönelmelidir. Cloudflare proxy'sini ancak şu işlemden sonra etkinleştir: alan adı doğrulaması.

İlk kurulum

  1. HTTP Basic giriş bilgilerini gir. Yönetici hesabını oluştur, dilini/saat dilimini seç ve şunları incele: lisans ve gizlilik politikası.
  2. Kontrol et: Ayarlar → Zincir bağlantıları. Ödeme taramasını destekleyen sağlıklı ve bağımsız yedek sağlayıcılar kullan.
  3. Bir proje, ardından projenin ilk mağazasını oluştur.
  4. Proje cüzdanlarını yedekle. Mağazada kabul edilen zincirleri ve doğrulanmış token'ları seç.
  5. Para birimini, onay sayısını, geçerlilik süresini, fiyat marjını ve toleransı ayarla. Fatura oluşturmadan önce kredi bakiyeni kontrol et.

QR kodları kalan tutarın tamamını ister. Tolerans yalnızca eksik ödemeleri kabul eder; onay gereksinimleri geçerliliğini korur.

Stablecoin tutarları

Tanınan stablecoin'ler için yeni teklifler yukarı yuvarlanır: 1.321 USDC → 1.33 USDC, tolerans sıfır olsa bile. Asgari: 0.01 token.

Mevcut faturalar, bakiyeler ve kısmi ödemelerden kalan tutarlar tam hassasiyetini korur. Diğer/özel token'lar normal hassasiyetlerini korur.

Otomatik etkinleştirme

Yönetici kaydı, e-postanı kullanarak kredi hesabını otomatik oluşturur ve tek seferlik 10 USD karşılığı hoş geldin kredisi tanımlar. Etkinleştirme kodu gerekmez.

Fatura oluştur. Bekleyen etkinleştirmeler otomatik yeniden denenir; yeniden bağlantılarda tekrar kredi verilmez.

Giriş bilgileri ve varsayılanlar

Basic Auth giriş bilgilerin şurada saklanır: /root/whollycrypto/config/setup-credentials.txt. Bunlar konsol e-postasından/parolasından ayrıdır.

Yeni projeler şu ayarları devralır: sistemin varsayılan para birimi ve saat dilimi; mağazalar projenin para birimini kullanır. Mevcut hesapların saat dilimleri Ayarlar → Hesap bölümünde ayrı yönetilir.

whollycrypto welcome konsol URL'ni gösterir.

Satıcı veya operatör modu

7.0.0'dan itibaren yeni kurulumlarda ilk yönetici kurulumu sırasında bir mod seçilir. Bu işlem geri alınamaz; modu değiştirmek yeni bir kurulum gerektirir. 7 öncesi kurulumlar, yöneticileri olmasa bile satıcı modunda kalır.

Satıcı: kendi projelerini ve mağazalarını işlet. Operatör: ayrı satıcı işletmelerini tek kurulumda barındır ve kendi ön ödemeli işlem ücretini uygula. Kendi işletmen, dahili operatör ücreti olmadan dahildir.

Barındırılan satıcıları kur
  1. Paylaşılan düğümler, kurlar, alan adları, kurulum kredileri ve güncellemeler şu bölümde yer alır: Operatör paneli.
  2. Aç: Cüzdanlar → Ödeme alma cüzdanları oluştur BTC, ETH ve Ethereum USDC/USDT için. Birbirinden bağımsız her iki kurtarma ifadesini de yedekle. Bu özel proje satış faturası düzenleyemez; mevcut bir ödeme alma mağazası korunur.
  3. Kredi para birimi, ücret ve yönetici e-postasıyla bir satıcı ekle. Daveti ve satıcı Basic Auth bilgilerini özel olarak paylaş. Parolalarını kendileri seçer. Operatör Basic Auth bilgilerini asla paylaşma.
  4. Satıcılar ödeme sayfan üzerinden bakiye yükler veya açıklamalı bir kredi düzeltmesi kaydedersin. Proje/mağaza oluşturmadan önce kredi gerekir. Kullanıcıları ve kredi geçmişini şu bölümde yönet: Satıcılar → Yönet.

Operatör kurulumu dördüncü bir adres ister; örneğin operator.example.com, ayrıca bu adrese özel Basic Auth kullanıcı adı ve parolası gerekir. Etiketini seç, DNS'i VPS'e yönlendir, DNS'i kontrol et ve HTTPS'i etkinleştir. Panel doğrudan bu adreste açılır. Satıcı, ödeme sayfası ve API adreslerin ayrı kalır.

Yeni operatör Basic Auth bilgileriyle, ardından yönetici e-postan/parolanla giriş yap. Satıcı Basic Auth bilgileri değişmez. DNS veya sertifika hatalarından sonra kuruluma devam edilebilir. 7.0.0'dan yükselten operatörler de bu adımı tamamlar; mevcut canlı adresler kullanılabilir kalır.

Ücretler, yalıtım ve sorumluluk

%3 oranında, 100 EUR tutarındaki bir fatura 3 EUR satıcı kredisi kullanır. Kredi para birimi farklıysa, oluşturulma anındaki itibari para kuru ücretle birlikte kaydedilir.

Operatör normal Wholly Crypto kurulum ücretini ayrı öder. Müşteri fonları zincir üzerinde bölüştürülmez. Kredi satın alımlarından tekrar ücret alınmaz.

Bir bakiye yüklemesi yalnızca otomatik olarak doğrulanmış ödeme tamamlanmasıyla hesaba geçer. Ödeme sayfasını açmak veya faturayı elle kabul etmek yeterli değildir. Geri almalar hesap defteri kayıtları oluşturur; geri alınmış bir yükleme tekrar gelirse operatör incelemesi gerekir.

Barındırılan hesabın düşük kredisi IPN, webhook'lar, bakiye aktarımları ve yeni proje/mağaza oluşturmayı duraklatır. Mevcut müşteri faturaları ve ödeme alma devam eder. Düşük kurulum kredisi, barındırılan işletmeler genelinde otomasyonu duraklatabilir. Bir satıcıyı devre dışı bırakmak girişini ve yeni faturaları da engeller; eski ödemeler izlenmeye devam eder.

Bu, uygulama düzeyinde yalıtımdır; her satıcıya ayrı VPS sağlanmaz. Satıcılar birbirlerinin projelerine, cüzdanlarına, API kimlik bilgilerine, borsa bağlantılarına veya kredilerine erişemez. Sunucu yöneticisi, barındırılan sıcak cüzdan anahtarlarına erişebilir. Satıcılara katılmadan önce bunu bildir; güvenilir barındırma, bağımsız yedekler ve ortak iş yüklerine uygun kapasite kullan.

Operatör finansları ve davetler

7.1.0'dan itibaren Operatör modunda kullanılabilir.

Cüzdanlar ve finanslar

7.2.0'dan itibaren, Cüzdanlar ödeme alma bakiyelerini, adresleri ve yedekleri yönetir; Bakiye Aktarımı gönderimleri ve otomatik kuralları yönetir. Token ücretleri için ETH bulundur. Satıcı bakiye yüklemeleri satın alımlarını izler. Üst kısımdaki krediler kurulum ücretlerini ayrı öder. İşletmem kendi konsolunu yeni sekmede açar.

Aç: Finanslar kazanılan ücretleri, doğrulanmış kurulum ücretlerini, tahmini kâr marjını ve mevcut satıcı kredilerini gösterir. Tarihe, satıcıya veya raporlama para birimine göre filtrele; CSV olarak dışa aktar.

Raporlar faturaları ilk ödeme tamamlanmasına göre gruplar ve en güncel ücret geri almalarını yansıtır. Ön ödemeli bakiyeler gelir değildir. Kendi işletmene ait ücretler ayrı kalır. Bekleyen ücretler veya eksik kurlar, ilgili marjların hesaplanmasını engeller. Dönüştürülmüş tutarlar önbellekteki güncel itibari para kurlarını kullanır; gas ve işletme maliyetleri dahil değildir.

Kullanıcı davet et veya parola sıfırla

Satıcı ekle bir davet oluşturur. 7.3.0'dan itibaren satıcının kredi para biriminde ücretsiz başlangıç kredisi seçebilirsin; sıfır da olabilir. Bu, operatör bakiyeni doldurmaz. Daveti e-postayla gönder varsayılan olarak işaretlidir.

SMTP sağlayıcını şu bölümde yapılandır: Ayarlar → Davet e-postası önce TLS veya STARTTLS kullanarak. Bağlantı testi e-posta göndermez. Alternatif olarak e-posta seçeneğini kaldırıp bağlantıyı özel olarak paylaş. Başarısız e-postada hesap ve kredi korunur; satıcıyı tekrar oluşturma.

Yeni bağlantı veya parola sıfırlama için şurayı aç: Satıcılar → Yönet → Kullanıcı hesapları. SMTP kabulü, gelen kutusuna teslim garantisi değildir. Satıcı Basic Auth bilgilerini ayrı paylaş; operatör kimlik bilgilerini asla paylaşma.

Davetler 48 saat, sıfırlama bağlantıları bir saat geçerlidir. Her biri bir kez kullanılabilir. Aynı ekrandan bağlantıyı yenile veya iptal et. Sıfırlama mevcut oturumları kapatır, ancak 2FA etkin kalır. Satıcı Basic Auth bilgileri yine gereklidir.

Operatör API'si

SDK 2.6.0 ve Wholly Crypto 7.4.0+ ile barındırılan satıcıları otomatik yönet. Şunu etkinleştir: Operatör → Ayarlar → Operatör API'si, ardından kapsamı belirlenmiş, sunucu tarafında kullanılacak bir anahtar oluştur.

Katılım, izinler ve güvenli yeniden denemeler

Hesapları doğrudan parolayla oluştur veya davet gönder. Kullanıcıları, projeleri, mağazaları, ücretleri ve yerel ön ödemeli kredileri yönet; raporları oku ve imzalı yaşam döngüsü olaylarına abone ol. İlk girişte saklama onayı, 2FA ve kiracı yalıtımı korunur.

Her yazma işlemi kaydedilmiş bir idempotency anahtarı gerektirir. Kredi tanımlamaları yerel hesap düzeltmeleridir; kurulum bakiyesi yüklemesi değildir. Cüzdan sırları, para gönderme ve sunucu yapılandırması bu API'nin kapsamı dışındadır.

Kullan: api.your-domain.com/v1/operator. Operatör anahtarlarını arka ucunda tut; tarayıcıda veya barındırılan bir satıcıda bulundurma.

Operatör API başvuru kaynağı ve izinleri → · Resmî SDK'lar ve örnekler →

Cüzdanlar ve token'lar

Ayarlar → Token'lar önce 250 token'ı, sonra kataloğun kalanını yükler.

Proje → Cüzdanlar → Tümünü yedekle TXT veya QR kodları içeren, aranabilir çevrimdışı HTML olarak dışa aktarır. Her ikisi de anahtarları ve kurtarma ifadelerini açığa çıkarır. Sunucu dışında özel bir kopya sakla; asla paylaşma veya bir yere yükleme.

Root kullanıcısı anahtarlara erişebilir. Cüzdan kurtarma rehberleri fatura adreslerini, yerel gas'ı ve harici Monero/Lightning yedeklerini açıklar.

Kayıtlı adresler ve güncel bakiyeler

Ayarlar → Adres defteri: bir zincir/adres kaydet. Yerel coin'ler ve eşleşen CoinGecko token'ları otomatik görünür. Salt okunurdur ve yönetici tarafından yönetilir; ödeme sayfasındaki kabul ayarları değişmez.

Token okuyucuları 22 zinciri kapsar. Özel bakiyeler ve Bitcoin/CashTokens/Kaspa katmanları ayrı erişim veya indeksleyiciler gerektirir. Başarısız okumalar sıfır yerine hata gösterir.

Fatura bakiyelerini başka bir cüzdanda toplamak için elle gönderim veya otomatik bakiye aktarımı kullan. Token transferleri için ücretleri ödeyecek zincirin yerel coin'i de gerekir.

Fiyat kullanılamıyor bakiyelerle değil, kurlarla ilgilidir.

Özel token ekle
  1. Mağaza → Ödeme yöntemleri → EVM veya Solana → Özel token.
  2. Sözleşme/mint adresini, adı ve sembolü gir. Sabit USD veya otomatik DEX fiyatlandırması seç.

Ağ ve ondalık basamak sayısı kontrol edilir. Proje genelindeki fiyatlar mevcut teklifleri değiştirmez. Katalog eşleşmesi tek başına ödeme sayfasında kullanımı etkinleştirmez.

Otomatik fiyatlandırma

DEX Screener, sözleşmeyle tam eşleşen bir havuz, 10.000 $ likidite ve son bir saat içinde işlem gerektirir. Kurlar her dakika yenilenir; başarısız veya beş dakika eskimiş kurlar yeni teklifleri engeller.

DEX fiyatları manipüle edilebilir; kontroller denetim değildir. Güvenilir standart ERC-20 veya klasik SPL token'ları kullan. Token-2022/uzantıları desteklenmez. Uygun havuz yoksa sabit fiyatlandırma kullan.

Para birimi ve saat dilimi

Ayarlar → Sistem → Bölgesel varsayılanlar yeni projelerin para birimini/saat dilimini ve yeni hesapların saat dilimini belirler. Mevcut ayarlar ve krediler değişmez; kontrol paneli para birimi ayrıca değiştirilebilir.

Kişisel saat dilimi: Ayarlar → Hesap → Kullanıcıyı düzenle.

Fatura oluştur

Kullan: Ödeme yöntemleri → Bu fatura için seç kabul edilen zincirleri/token'ları daraltmak için. Tüm mağaza ödeme yöntemleri varsayılanları korur.

  1. Aç: Proje → Faturalar → Fatura oluştur.
  2. Mağazayı, itibari para birimini ve tutarı seç.
  3. Ödeme sayfası bağlantısını paylaş. Müşterin kullanılabilir bir zincir/token seçer; QR kodunu, kalan tutarı, geçerlilik süresini ve onayları görür.

Canlı kullanıma geçmeden önce her yöntemle küçük bir ödeme test et. Siparişi yerine getirmeden önce faturayı kontrol et: dönüş URL'si ödeme kanıtı değildir.

Entegrasyonlarda imzalı IPN/webhook'ları doğrula ve durumu şu yoldan teyit et: fatura API'si. Yinelenen olayları aynı olay olarak değerlendir.

API: filtrele payment_methods şuna göre: chain_slug ve asset_tickers. Etkin olmayan seçenekler yok sayılır; eşleşme yoksa mağaza varsayılanları kullanılır. Yalnızca zincir seçimi tüm etkin varlıkları kapsar. Ortak semboller için varlık kimlikleri gerekir. Cüzdan ve kur gereksinimleri geçerliliğini korur.

Tutarlar ve onaylar

Tarayıcı çevrimdışı mı? Tespit beklerken faturalar yapılandırılmış yöntemlerini korur. Zincir bağlantılarında desteklenen API'leri kontrol et; sağlıklı olması, tarayıcıyla uyumlu olduğu anlamına gelmez. Varsayılan: iki bağımsız sağlayıcı.

Cüzdanlar/kurlar yine gereklidir. Monero/Lightning hizmetleri ödeme isteklerini oluşturabilmelidir.

API/MCP hataları şunları içerir: error.details.payment_methods. SDK 2.4.0 güvenli açıklamalar ekler: PHP getPaymentMethodIssues(), Python payment_method_issues, Node paymentMethodIssues. Hata başvuru kaynağı →

Kripto teklifleri yukarı yuvarlanır ve mağazanın fiyat marjını içerir. İtibari para ile fiyatlandırılmış fatura, alınan kriptoyu banka bakiyesine dönüştürmez.

Sıfır onay, ağ onayı koruması olmadan tespit anında ödemeyi tamamlar. Yerel EVM ödemeleri doğrudan transfer olarak tespit edilir. Olağandışı veya belirsiz ödemeleri şu bölümde incele: İlgilenilmesi gerekenler.

Tarayıcı API'leri

Kontrol et: Zincir bağlantıları uyumlu API'ler, eksiksiz geçmiş ve bağımsız sağlayıcılar için. Ham düğümlerde geçmişi yakalamak zaman alır. Tüm ödeme alma API'leri →

Ödemeler, bakiyeler ve bakım aynı sağlayıcı kotalarını paylaşır. Boşta kontroller seyrekleşir. Eski faturalar için geç ödeme/zincir yeniden yapılanması izlenmeye devam eder; geçmiş yakalandıktan sonra aralık bir saate kadar çıkabilir. Kullanılabilir WSS ipuçları HTTP taramasını tamamlar. Ödeme sayfasını kapatmak tespiti asla durdurmaz. Herkese açık düğümlerin yine sınırları vardır; Wholly Crypto düğüm çalıştırmaz.

Sıfır tutarlı faturalar

Varsayılan olarak engellenir. Şunu etkinleştir: Mağazalar → Fatura → Sıfır tutarlı faturalara izin ver elle/API ile sıfır toplamlı fatura oluşturmak için. Ödeme, ödeme alma adresi, işlem veya işlem ücreti olmadan hemen tamamlanırlar.

Ödeme sayfası

Mağaza → Ödeme sayfası: renkler, logolar, yöntemler, bağlantılar, Giriş/Çıkış yazı boyutları ve proje/mağaza adının görünürlüğü. Yeni mağazalar varsayılan mağazanın tasarımını devralır. Değişiklikler otomatik kaydedilir.

Önizlemeler ödeme kabul edemez. Özel HTML/CSS/JavaScript desteklenmez.

Demoyu dene.

IPN ve webhook'lar

IPN her fatura olayını gönderir mağaza URL'sine veya faturanın ipn_url. Webhook'lar seçili olayları gönderir. İkisi de aynı JSON anlık görüntüsünü POST ile iletir.

Siparişi ne zaman yerine getirmeliyim? Olay tabanlı işleme için şunu kullan: event_type = invoice.settled şununla birlikte: status = settled. Güncel faturayı ve siparişini doğrula, ardından siparişi bir kez yerine getir. payment.received tek başına yeterli değildir.

Durum ve olaylar: Ethereum ve Solana örnekleri

status olayın oluşturulduğu andaki fatura durumudur; event_type ne olduğunu bildirir.

  • Ethereum örneği: payment.received + processing, ardından invoice.settled + settled.
  • Solana örneği: tespit edildiğinde zaten kesinleşmiştir, bu yüzden payment.received ve invoice.settled ikisi de şunu taşır: settled.

Her iki akış da başka zincirlerde gerçekleşebilir. Bunlar ayrı olaylardır; mutlaka iki ayrı ödeme anlamına gelmez. Aynı değeri paylaşabilirler: sequence ancak farklı event_id değerleri vardır. Teslim sırası garanti edilmez; şunun processing önce gelmesini şart koşma.

Durumlar ve geri çağrı verileri
Fatura durumuAnlamı
newÖdeme bekleniyor
processingKısmi ödeme veya kesinleşme bekleniyor
settledFatura kurallarına göre veya elle kabul edildi
expiredSon tarih geçti; geç ödeme izlemesi devam edebilir
invalidÖdeme inceleme gerektiriyor veya reddedildi
cancelledİptal edildi, iade edilmedi

Olaylar: invoice.created, payment.received, invoice.processing, invoice.settled, invoice.expired, invoice.invalid, invoice.cancelled. Tüm olay tablosu ve istisna kuralları →

amount_status: none, partial, paid, overpaid. paid toleransı içerir, kesinleşmeyi içermez. timing_status: on_time veya late. resolution: automatic, manually_settled veya manually_invalidated. Şu durumda istisna politikanı uygula: requires_review true olduğunda.

invoice_id API yanıtıyla eşleşir. amount, currency ve order_id ilk siparişini açıklar. payment_info transferleri, tam kripto tutarlarını, kilitlenmiş teklif/fiyat marjı/tolerans değerlerini ve bilgi amaçlı kurları ekler. Müşteri verileri ve meta veriler özeldir.

paid_chain, paid_asset, paid_payment_method_id, paid_asset_amount, paid_asset_amount_received ve settlement_exchange_rate ödeme tamamlanmasını özetler. Sabit kalırlar; eksik kanıt/geçmiş null kalır. Sonraki tahsilatlar için şunu kullan: payment_info veya ödemeler API'si.

Ondalık sayı dizelerini kullan. Varlıkları birleştirme veya onaylanmamış fonları eksik sayma. İstisnaları açıkça ele al; bir uyarı tek başına siparişi yerine getirme veya iade yetkisi vermez. Doğrulanmış dahili gas yüklemeleri müşteri ödemesi değildir ve şunu tetiklemez: payment.received.

İmzalama sırları, yeniden denemeler ve teslim geçmişi

Ayrı imzalama sırları: Mağaza → IPN faturanın özel adresi dahil IPN teslimlerini imzalar: ipn_url. Şuradaki her uç noktanın Mağaza → Webhook'lar kendine ait bir sırrı vardır; oluşturulduğunda veya yenilendiğinde gösterilir.

İkisi de şunu kullanır: Wholly-Signature ve aynı SDK doğrulayıcısını; ancak API anahtarı değil, eşleşen sır gerekir. IPN sırrını yenilemek webhook sırlarını değiştirmez.

Ham gövdeyi, zaman damgasını ve proje/mağaza kapsamını doğrula. Kalıcı olarak kaydet, ardından HTTP 2xx döndür. Bir çalışan, yapılandırdığın API sunucusu üzerinden güncel faturayı kontrol eder ve siparişi bir veritabanı işlemi içinde bir kez yerine getirir. Üst bilgiler imzasızdır; sürüm 2'nin imzalı gövde kimliğini kullan.

Olay tabanlı: imzalı kimliğe göre yinelenenleri ayıkla: event_id, ardından filtrele: invoice.settled. SDK durum tabanlı: proje + şu değere göre birleştir: invoice_id + sequence, ardından olay türünden bağımsız olarak durumu kontrol et. Bu birleştirmeden sonra olay filtresi ekleme. Her iki yöntem de sipariş düzeyinde ayrı yinelenme koruması gerektirir.

Yeniden denemelerde ilk gövde ve olay kimliği korunur. Eski revizyonlar yenilerinin üzerine yazmamalıdır. IPN en fazla sekiz deneme yapar; webhook yeniden denemeleri isteğe bağlıdır. Düşük kredi ödemeleri değil, teslimleri duraklatır.

Mağaza → IPN / Webhook'lar → Geçmiş → Ayrıntılar kaydedilen gövdeyi ve sonucu gösterir. Yükler 90 gün sonra silinir. Yeniden gönderim, ödemenin tamamlandığının kanıtı değildir.

Tam yük, olay tablosu ve alıcı örnekleri →

Borsada dönüştürme

Desteklenen varlıkları Kraken, Binance veya Coinbase'e gönder. Coin'i tut ya da hesaba geçen yatırma işlemlerini dönüştür. İtibari para borsada kalır.

Asgari yatırma tutarı bakiye aktarımı başına değil, işlem başına uygulanır. Asgari tutarın altındaki yatırmalar planı durdurur. Önce küçük bakiyeleri kendi cüzdanında birleştir; ek ağ ücretleri uygulanır.

Bağlan ve rota seç
  1. Ayarlar → Borsalar: bu işe özel bir anahtar bağla, bakiyeleri kontrol et ve projelere erişim ver. Çekim izni verme; anahtarı VPS IP'nle sınırla.
  2. Proje → Bakiye Aktarımı: varlığı, ağı, adresi ve token sözleşmesini doğrula. Her zincir/token için ya başka bir cüzdan ya da bir borsa seç.

Piyasalar iki dakikada bir yenilenir. Yalnızca eşleşen ve hesaba geçen yatırmalar dönüştürülebilir; güncelliğini yitirmiş piyasalar yeni emirleri durdurur. Ücretler/yuvarlama için kaynak varlığın %1'i borsada rezerv kalır; bu, işlem kredilerinden ayrıdır.

Asgari tutarı tut otomatik bakiye aktarımlarından sonra proje genelinde coin/token ayırır. Tetikleme eşiğinden ayrıdır; sıfır, hiç rezerv bırakmaz. Ücretler fazla bakiyeden karşılanır. Elle gönderimler değişmez.

Belirsiz transferleri devam ettir; asla yenisini oluşturup yerine koyma. Cüzdanlar, onaya veya kullanılmamış teklifin süresinin dolmasına kadar ayrılmış kalır. Büyük bakiye aktarımları gruplar halinde yapılmalıdır.

Borsa saklama hizmeti, KYC, bölgesel sınırlar ve ücretler geçerlidir. Banka ödemesi veya kaldıraç yoktur. Düşük kredi yeni dönüştürmeleri duraklatır; iletilmiş emirlerin mutabakatı devam eder.

İşlem kredileri

Kredilerin bittiğinde de ödeme almaya devam edersin. Mevcut mağazalarda faturalar, ödeme sayfası ve ödeme izleme devam eder. Doğrulanmış faturalandırma bağlantısının olmaması veya hesabın askıya alınması farklıdır ve yeni faturaları engelleyebilir.

Kullanılabilir kalırKullanılabilir kredi yoksa duraklatılır
Faturalar, ödeme sayfası ve onaylarYeniden denemeler dahil IPN/webhook'lar
Cüzdanlar, bakiyeler ve yedeklerBakiye Aktarımı: gönderimler, gas, iadeler ve yeni borsa dönüştürmeleri
Raporlar, okuma API'leri ve mevcut ayarlarProje ve mağaza oluşturma
Güncelleme kontrolleri ve kesintiye uğrayan güncellemeyi kurtarmaYeni sürüm kurma

Kredi simgesinden bakiye yükle. Bakiye düzeldiği doğrulandıktan sonra para gönderen bakiye aktarım kuralları dahil etkin otomasyonlar devam eder. Yeniden başlamasını istemediğin kuralları devre dışı bırak.

Otomatik kredi yüklemeleri

Aç: Otomatik yükleme İstekler bölümünden sonra. Yedeklenmiş bir ödeme alma cüzdanı, eşik, satın alma tutarı, günlük sınır ve ağ ücreti tavanı seç. Yetkilendir ve kaydet. Başlangıçta kapalıdır.

Sunulduğunda BTC, ETH veya Ethereum USDC/USDT kullan. Token gönderen adreslerde ETH gerekir; bu kural eksik gas'ı fonlamaz. Operatörler özel ödeme alma cüzdanları kullanır; barındırılan satıcılar kendi Operatörlerine ödeme yapar.

Onaylanmış yükleme, düşük kredi Bakiye Aktarımı'nı duraklatırken çalışabilir. Krediyi yalnızca alıcı hizmet onaylar. Aynı anda tek otomatik satın alma çalışır. Devre dışı bırakmak gönderilmemiş işleri durdurur; iletilmiş işlemleri durdurmaz.

Otomatik ödemeyi kurtar

Otomatik yükleme bölümünde şunu kullan: Ödemeyi kontrol et. Aynı geçerli ödemeyi devam ettir veya başarısızlığı doğrulanmış Ethereum transferini kapatıp kuralı duraklat. Yinelenen gönderimleri önlemek için bekleyen veya belirsiz ödemeler bekletilir. Teklifin süresinin dolması başarısızlık kanıtı değildir.

Ücretler ve tam erişimi geri kazanma

Varsayılan %1, ödemesi tamamlanan faturanın ilk itibari para değerini kullanır. Müşterinin kripto ödemeleri bölüştürülmez.

Ücretler işlemeye devam ederek bakiyeyi negatife düşürebilir. Negatif tutarı kapat ve kullanılabilir krediyi hesabının tolerans eşiğinin üzerine çıkar. Sağlıklı bağlantıda bakiye değişiklikleri genellikle 10–15 saniyede görünür.

Otomasyon için tolerans hakkın olsa bile güncelleme kurmak, sıfırın üzerinde doğrulanmış kredi gerektirir. Bakiye yüklemeleri güncellemeleri asla otomatik kurmaz.

Duraklatılmış bildirimler deneme hakkı tüketmez. Bekletilen teslimler devam eder; normal sona erme süresi yine geçerlidir. Kaçırılan olayların mutabakatını fatura API'si üzerinden yap.

Operatör işlem ücretlerini kapatırsa yeni işlem ücreti veya kredi kısıtlaması uygulanmaz. Önceki ücretler geçmişte kalır. Eşleştirilmemiş kurulumda proje/mağaza yapılandırılabilir; ancak fatura düzenlemek doğrulanmış faturalandırma bağlantısı gerektirir. Daha önce düzenlenen faturalar izlenmeye devam eder.

Raporlar

Gelir grafikleri ve filtreler sekmelerin üzerinde kalır: Projeler ve mağazalar, Faturalar, Cüzdanlar ve Bakiye aktarımları. Arama aşağıdadır. Projeler ve mağazalar CSV dışa aktarımını içerir. Özel tarih aralığı en fazla 366 gün olabilir. Cüzdanlar önbellekteki bakiyeleri kullanır.

Rapor rakamları nasıl hesaplanır
  • Gelir, ödeme tamamlanma tarihlerini kullanarak tamamlanan faturaların ücret/iade öncesi değerini gösterir. Cüzdan bakiyesi veya kâr değildir.
  • Dönüştürmeler geçmiş muhasebe kurlarını değil, önbellekteki güncel kurları kullanır. Kur eksikse ilk para birimindeki toplamlar kullanılabilir kalır.
  • Fatura durumu grafikleri fatura oluşturulma tarihlerini kullanır. İlgilenilmesi gerekenler sayıları mevcut çözülmemiş sorunları gösterir.

Yapay zekâ asistanları · MCP

İsteğe bağlı, proje kapsamlı erişim: api.example.com/mcp. Ödemeleri oku veya fatura oluşturmaya izin ver. MCP kurulumu ve izinleri →

Mağaza eklentileri

PrestaShop → · OpenCart → · Tüm eklentiler →

SDKs

Fatura oluşturmak, ödemeleri kontrol etmek ve IPN/webhook'ları doğrulamak için resmî SDK'larımızı kullan.

PHP SDK'sı

PHP 7.4+

Composer ile PHP uygulamana kripto ödemeleri ekle.

composer require whollycrypto/php-sdk
GitHub ve örnekler ↗

Python SDK'sı

Python 3.10+

Çalışma zamanı bağımlılığı olmadan Python uygulamanı veya arka ucunu bağla.

python -m pip install whollycrypto
GitHub ve örnekler ↗

Node.js SDK'sı

Node.js 22+

JavaScript veya TypeScript için yerleşik tipler içeren tek bir npm paketi.

npm install whollycrypto
GitHub ve örnekler ↗

Kurulumunun API alan adını kullan ve API anahtarlarını sunucu tarafında tut. Tüm SDK'lar MIT lisanslıdır.

Ödeme araçları

Proje → Ödeme araçları bölümünü aç ve bir mağaza seç. Yeniden kullanılabilir bir ödeme bağlantısı paylaş, satış noktasında ödeme al veya e-postayla ödeme istekleri zamanla.

Fiyatı ve ödeme akışını seç
  • Sabit itibari para: her yeni ödeme sayfası güncel kripto kurlarını ve mağaza fiyat marjını kullanır, ardından teklifi süresi dolana kadar sabitler.
  • Sabit kripto: kabul edilen tek bir zincir üstü varlıktan tam birim tutarı iste. Raporlama ve ücretler için yukarı yuvarlanmış güncel itibari para değeri kaydedilir; hiçbir fiyat marjı kripto tutarını değiştirmez.
  • Bağışlar: müşterilerin belirlediğin sınırlar içinde tutar girmesini sağla. Hızlı tutarlar ve isteğe bağlı ad/e-posta alanları ekle.
  • Satış noktası: tutar veya sipariş referansı gir ve ödeme QR kodunu göster. Yalnızca ödeme tespitini değil, ödemenin tamamlanmasını bekle.
  • Zamanlanmış istekler: seçtiğin saat diliminde bir kez, haftalık veya aylık gönder. Müşteriler her faturayı kendileri öder. Cüzdandan otomatik tahsilat yapılmaz.

Mağaza görünümü, onaylar ve geri çağrılar geçerliliğini korur. Bir aracı duraklatmak mevcut ödemeleri değil, yeni istekleri durdurur. Geçmiş, her faturaya bağlantı verir. Kaçırılan dönemler toplu e-posta yağmuruna yol açmaz; yeniden gönderim, aynı ödenmemiş ve süresi dolmamış faturayı kullanır.

Müşteri ödeme sayfası, ödeme bağlantıları ve zamanlanmış e-postalar İngilizce, Almanca, İspanyolca, Brezilya Portekizcesi, İtalyanca, Rusça, Basitleştirilmiş Çince, Fransızca, Korece ve Japonca dillerini destekler.

Mağaza → Fatura → Ödeme sayfası dili varsayılanı belirler. Her fatura veya ödeme aracı için ayrıca değiştirebilirsin. E-postalar ve yeniden gönderimler fatura dilini korur. Yazdığın metin değişmez; Satıcı ve Operatör konsolları İngilizce kalır.

Giden e-posta

Ayarlar → Sistem bölümünde, Kaynak IP kısıtlamaları altında, sağlayıcının herkese açık ana makine adı, giriş bilgileri, gönderen adresi ve isteğe bağlı yanıt adresiyle SMTP'yi etkinleştir. 465 portunda TLS veya 587'de STARTTLS kullan.

Kaydet, bağlantıyı test et, ardından kendine test e-postası gönder. Sağlayıcında SPF/DKIM ayarla. SMTP kabulü, gelen kutusuna teslimi garanti etmez.

Zamanlanmış istekler sistem SMTP'sini kullanır. Bildirim kanalları da bunu seçebilir; mevcut kanal ve Operatör davet ayarları değişmez. Bu şifrelenmiş kimlik bilgilerini yalnızca kurulum yöneticisi yönetir. E-posta gönderim hataları için açıkça yeniden gönderme gerekir.

Bildirimler ve uyarılar

Zil, bildirim gelen kutunu açar. Tema seçenekleri ayarlar menüsündedir.

Kanalları ve kuralları ayarla
  1. Ayarlar → Bildirimler ve uyarılar bölümünü aç. Konsol bildirimleri yerleşiktir.
  2. E-posta veya Telegram için kanal ekle, doğrulama kodu gönder ve kodu gir. Ardından kanalı etkinleştir ve kurallarında seç.
  3. Ödeme istisnaları, başarısız geri çağrılar, transfer sorunları, düşük gas, geciken tarama, düşük kredi veya başarısız yedeklemeler için uyarılar seç. Tamamlanan ödeme uyarıları isteğe bağlıdır.

Tekrarlanan sorunlar gruplanır. Geçmiş 30 gün tutulur; proje izinleri geçerliliğini korur. Uyarıyı okumak sorunu çözmez. Kişilere yönelik uyarılar mağazanın IPN veya webhook'larının yerine geçmez.

Pazaryeri

Proje → Pazaryeri'ni etkinleştir, mağazaları seç ve hedef adresleri bağımsız olarak doğrulanmış satıcıları kaydet. Satıcı payları tam belirlenmiş tek bir fatura oluştur; ödemeleri elle onayla veya sınırlandırılmış otomatik politikalar ayarla.

Çok satıcılı ödemeleri ayarla

Yalnızca Bitcoin mainnet ve desteklenen EVM coin'leri/ERC-20. Müşteriler önce projenin kontrolündeki cüzdanlara ödeme yapar, doğrudan satıcılara değil. Ücretler için kullanılabilir yerel coin bulundur. Normal bakiye aktarımları korunan ödeme alma adreslerini hariç tutar.

İşlem ücreti, komisyonundan ayrı olarak asıl faturaya bir kez uygulanır. Eksik ödemeler ve belirsiz tahsilatlar inceleme gerektirir. Satıcıya ödeme yapıldıktan sonraki iadeler ayrı fon gerektirir; otomatik geri alma yapılmaz.

Çok satıcılı ödemeleri ayarla · Pazaryeri API başvuru kaynağı

Muhasebe

Raporlar, İşlemler, Dışa Aktarımlar ve Kontroller için Ayarlar → Muhasebe bölümünü aç. Kontrol paneli ayrı kalır.

Muhasebeci raporu hazırla
  1. Dönemi, raporlama para birimini ve saat dilimini seç. Projeye veya mağazaya göre filtrele, ardından fatura, sipariş, varlık veya işlem referanslarını ara.
  2. Eksik kurları, ücretleri ve ödeme istisnalarını Kontroller bölümünde incele. Ayrıntılar mevcut faturaya veya transfere bağlantı verir.
  3. Yazdırılabilir özet ve ayrıntılı CSV dosyaları içeren muhasebeci ZIP'ini indir. İndirme başına en fazla 10.000 kayıt; daha büyük geçmişler için daha kısa dönem seç.

Onaylanmış tahsilatlar, iadeler ve kaydedilmiş maliyetler; cüzdan transferlerinden ve ön ödemeli kredi satın alımlarından ayrıdır. Birden fazla ödeme olsa bile fatura toplamı bir kez sayılır.

Geçmiş değerler bugünün fiyatlarını değil, saklanan kanıtları kullanır. Eski kurlar ve gerçek ücretler bulunmayabilir; eksik maliyetler asla sıfır varsayılmaz. Kanıtlar eksikse net toplam hesaplanamaz.

Bu, tüm harici cüzdan veya borsa işlemlerini değil, Wholly Crypto'nun izlediği kayıtları kapsar. Vergi beyannamesi veya kâr tablosu değil, kayıt tutma yardımcısıdır. Dışa aktarımları güvenli paylaş: müşteri e-postaları içerebilirler.

Bakiye Aktarımı

Alınan fonları seçtiğin hedefe taşı. Kuralları ve geçmişi şu bölümde yönet: Proje → Bakiye Aktarımı.

Yerel coin gönder: 29 zincirde; Monero yalnızca görüntüleme modunda kalır. Token'lar: doğrulanmış ERC-20 ve klasik SPL. Elle gönderim ve otomatik bakiye aktarımı aynı korumaları kullanır.

Elle gönderim: hazırla, incele, onayla

BTC, EVM, SOL ve TRX'e 18 yerel adaptör eklenir. İşlem iletebilen bir sağlayıcı kullan. ZEC yalnızca şeffaf adresleri destekler; ADA token çıktıları korur; DOT Asset Hub kullanır; HBAR bir röle gerektirir. Giden memo/tag/comment gerektiren hedefler için harici cüzdan gerekir.

  1. Aç: Proje → Cüzdanlar → varlık → Gönder. Adres defterinden kayıt seç veya hedef gir. Adresin tamamını ve ağı kontrol et.
  2. Tam tutar veya kullanılabilir bakiyenin tümünü aktar seçeneğini, ardından ücret düzeyini seç. Desteklenen token'lar için, Gas için proje ETH'sini kullan (veya zincirin yerel coin'ini) aynı proje/zincirden eksik ücretleri fonlayabilir.
  3. Tıkla: Transferi hazırla. Kaynakları, hedefi, tutarı, azami ücretleri ve varsa gas tahsisini incele. Onayla ve gönder bu plana yetki verir; yalnızca hazırlamak hiçbir şey göndermez.

Onaydan sonra gas fonlaması, onaylar ve token gönderimi arka planda devam eder. Şuradan takip et: Transfer etkinliği, pencereyi kapattıktan sonra da. Ağa yayınlamak, onaylanmak demek değildir.

Proje cüzdanında tutulacak ETH: 0 ek rezerv ayırmaz; tüm ETH'ni harcamaz. 0.005, sonrası için en az 0.005 ETH tutar; bu iş akışı için ek fon gerekir. Kaydedilmiş otomatik kurallar değişmez.

Otomatik bakiye aktarımı kurulumu
  1. Aç: Otomatik Bakiye Aktarımı Kurulumu → varlık → Ayarla. Bir cüzdan adresi veya desteklenen bir borsa hedefi seç, ikisini birden değil.
  2. Asgari aktarım tutarını ve şunu ayarla: Asgari tutarı tut. Örnek: 100 USDC'de tetikle, 20 USDC tut, en fazla 80 USDC gönder. Rezerv adres başına değil, proje genelindedir.
  3. Token'lar için şunu incele: Gas için proje ETH'sini kullan ve şunu gir: Günlük fonlama sınırı. Otomatik bakiye aktarımını aç, ardından Kuralı kaydet ve onayla. Yalnızca Ayarla ekranını açmak hiçbir şeyi etkinleştirmez.

Günlük sınır, kayan 24 saatlik sürede token kuralı başına ayrılan yerel gas'ı sınırlar. Hafif kullanım için 1 € başlangıç sınırı olabilir; garanti edilen maliyet veya günlük ücret değildir. Fonlama işlemlerinin de ücretleri vardır. Azami ağ ücreti % birleşik fonlama/transfer ücretlerini sınırlayabilir.

Kontroller otomatik çalışır. Yalnızca uygun ve token bulunduran adreslere gas gönderilir; boş adreslere gönderilmez. Aktarım eşiğinin altındaki yetersiz fonlanmış adres bekler. Gas sınırları açıklaması →

İyi uygulamalar ve duraklatılmış transferler
  • Cüzdanları yedekle ve küçük bir transfer test et. Yerel coin'leri boşaltmadan önce token'ları gönder. Projenin başka yerindeki ETH önce her token adresine ulaşmalıdır; kullanılmayan gas cüzdanlarında kalır.
  • Güncel bakiyeler, sağlıklı sağlayıcılar ve yeterli yerel fon kullan. Otomatik kurallar etkin, yedeklenmiş bir cüzdan ve etkin bir mağazada etkinleştirilmiş varlık gerektirir. Düşük işlem kredisi gönderimi duraklatabilir.
  • Şurada: Transfer etkinliği, ilerlemeyi, Gas fonlamasını ve gezgin bağlantılarını incele. Sonuç belirsizse aynı transferi yenile; yerine yenisini oluşturma. Yalnızca nedeni ve sınırları inceledikten sonra devam ettir.

Gönderim devre dışı mı? Şunu kontrol et: whollycrypto transfers status. Şu işlemden önce etkin tüm kuralları incele: whollycrypto transfers enable: sunucu genelinde uygulanır ve kaydedilmiş kuralları hemen çalıştırabilir. Gelecekteki adımları durdurmak, ağa yayınlanmış işlemleri geri alamaz.

Alan adları

Ayarlar → Sistem: seç Yönet veya Alan adı ekle. Kaydet, DNS'i incele, yayımla. Değişmeyen ana makine adları DNS/SSL kontrollerini atlar.

Mağaza alan adları

Mağaza → Temel: etkin satıcı/ödeme/API ana makine adlarını seç. Bağlantılarda öncelik mağaza → varsayılan mağaza → sistem şeklindedir; kullanımdan kaldırılan adlarda yedek seçeneğe geçilir. SDK sunucu adreslerini ayrı yapılandır. İmzalı yeniden denemeler ilk bağlantılarını korur.

HTTPS otomatiktir. Kurulumdan sonra Cloudflare'ı açıp kapatabilirsin; Let's Encrypt etkin kalır.

Cloudflare kontrol listesi
  • Kullan: Full (strict), Flexible değil; API anahtarı gerekmez.
  • Konsol, ödeme sayfası ve API için önbelleği ve tarayıcı/bot doğrulamalarını kapat.
  • İzin ver: /.well-known/acme-challenge/ yenilemeler için 80 portunda, yönlendirme veya doğrulama olmadan.

Kontroller yetkili DNS'i sorgular ve kaynağı doğrular: Doğrudan veya Cloudflare. Ziyaretçiler eski DNS'i önbellekte tutuyor olabilir.

Konsolda kaydetme/silme işlemleri 5.6.2'den beri POST kullanır; “Not GET or POST” istisnası gerekmez. Giriş ve CSRF koruması etkin kalır. Şurada: api.*, herkese açık API'nin belgelenmiş yöntemlerine izin ver.

Hesap güvenliği

2FA'yı şu bölümde kur: Ayarlar → Hesap. Yalnızca proje erişimi olan kullanıcılar Güvenliğim seçeneğini alt bilgide kullanır. Parolanı doğrula, TOTP QR kodunu/anahtarını tara ve altı haneli kodu gir.

Dene: Verifyr Authenticator şu platformlarda: iOS veya Android, ya da başka bir standart TOTP uygulaması. Tek kullanımlık kurtarma kodlarını parolandan ayrı sakla. HTTP Basic korumasını etkin tut.

Kurtarma ve görünüm

Kodları yenilemek veya 2FA'yı kapatmak için parolan ve doğrulayıcı kodu ya da kullanılmamış kurtarma kodu gerekir. Diğer oturumlar kapatılır. Telefon/sunucu saatlerini eşzamanlı tut; 2FA ele geçirilmiş sunucuyu güvenli hale getirmez.

Tema simgesi şu sırayla değiştirir: Açık → Loş → Koyu ve bu tarayıcının seçimini hatırlar. Mağaza ödeme sayfası temaları ayrıdır.

Sunucu güvenliği

  • SSH anahtarları kullan ve SSH'yi güvenilir IP'lerle sınırla. Test edilmiş bir kurtarma bağlantısı bulundur.
  • Kurulumdan sonra Full (strict) kullanarak Cloudflare proxy'sini etkinleştir.
  • Şurada: Ayarlar → Sistem → Kaynak IP kısıtlamaları, her canlı merchant.* veya api.* ana makine adı için güvenilir IP'lere/aralıklara izin ver. Mevcut konsol IP'sine izin verilmeye devam edilmelidir.
  • Normalde şunu pay.* açık bırak: müşteriler her yerden ödeme yapabilmelidir.
Cloudflare ve erişim engelini giderme

İstersen Cloudflare erişim kuralları ekle. HTTPS yenileme doğrulamalarını hariç tut; API ve ödeme sayfasında etkileşimli giriş doğrulamalarından kaçın. Proxy modu tek başına IP kısıtlaması değildir.

Erişimin mi engellendi? Şunu çalıştır: whollycrypto access-reset --domain merchant.example.com SSH üzerinden. Beş saniye içinde yalnızca o ana makine adı yeniden açılır; hesap kimlik doğrulaması etkin kalır.

HTTPS'i düzelt

whollycrypto ssl
whollycrypto ssl --fix

İlk komut etkin sertifikaları kontrol eder. --fix TLS destek dosyalarını onarır ve eksik/süresi dolmak üzere olan sertifikaları yeniler. Nginx çalışıyor olmalıdır; 80/443 portlarını açık tut.

Bir sertifikayı yeniden düzenle

Çalıştır: whollycrypto ssl --domain merchant.example.com --reissue zorunlu yenileme için. Sertifika düzenleme sınırları geçerlidir. Cloudflare HTTP doğrulamasını engelliyorsa geçici olarak yalnızca DNS kullan. Cüzdanlar, kimlik doğrulaması ve alan adları değişmez.

Günlük kontroller

  • Şu bölümde: İlgilenilmesi gerekenler, faturaları veya mevcut sayfayı seçerek incelendi olarak işaretle, not ekle veya yeniden tara. Finansal kararlar tek tek alınır.
  • Disk alanını, tarayıcı gecikmesini ve bağımsız yedek düğümleri izle. Herkese açık uç noktalar kapasite garantisi vermez.
  • Linux'u güncel tut, SSH'yi sınırla ve kullanıcı/API anahtarı erişimini gerekli proje ve izinlerle sınırlandır.

Kararlar gerekçe ister. İadeler ayrı ve onaylanmış transfer gerektirir; fatura durumunu değiştirmek asla para göndermez.

Güncellemeler ve yedekler

Şunu oku: sürüm notları, ardından şunu kullan: Ayarlar → Sistem → Yazılım güncellemeleri veya CLI. Güncellemeler imzaları doğrular, yedek oluşturur ve sistem sağlığını kontrol eder. Kurulum sırasında ödeme sayfası duraklar.

whollycrypto update --check
whollycrypto update

Güncellemeler arka plan işleri için en fazla iki dakika bekler; ödeme sayfası çevrimiçi kalır. Zaman aşımında zamanlayıcılar geri yüklenir.

0.1.31 veya daha eski sürümden yükseltme

Eski güncelleyici engellendi mi? Bunu bir kez çalıştır. Kurulu anahtarın yardımcı aracı doğrular.

bash <(curl -fsSL https://releases.whollycrypto.com/update_wholly.sh)

Test edilmiş sunucu dışı yedekler tut PostgreSQL, yapılandırma, cüzdan şifreleme anahtarları ve cüzdan dışa aktarımları için. Yerel kurtarma arşivleri şifrelenmemiştir.

Birbirine ait veritabanı/yapılandırma yedeklerini birlikte geri yükle. Veritabanı geçişlerini kesintiye uğratma veya yeni veritabanlarıyla eski çalıştırılabilir dosyaları kullanma. Kredi kuralları geçerliliğini korur.

GitHub yedek indirme kaynağı

Kurulum ve güncellemeler otomatik olarak şunu dener: resmî GitHub aynası. İmza, sağlama toplamı ve kredi kontrolleri yine gereklidir.

Sunucu CLI'si

SSH üzerinden root komutları.

whollycrypto status
whollycrypto doctor
whollycrypto backup
Tüm komutlar
KomutAmaç
whollycrypto versionKurulu sürüm.
whollycrypto statusUygulama ve veritabanı sağlığı.
whollycrypto logsSon 80 uygulama günlük satırı.
whollycrypto restartYeniden başlat ve sağlığı kontrol et.
whollycrypto doctorSalt okunur kurulum kontrolleri.
whollycrypto doctor --fixYönetilen izinleri ve eksik CLI bağlantısını onar.
whollycrypto htaccessBasic Auth girişini sıfırla.
whollycrypto admin-resetYönetici parolasını sıfırla.
whollycrypto 2fa-resetBir hesabın doğrulayıcısını parolasını değiştirmeden sıfırla.
whollycrypto transfers status
whollycrypto transfers enable
whollycrypto transfers disable
Tüm projelerde gönderimi kontrol et, etkinleştir veya duraklat. Etkinleştirmek uygulamayı yeniden başlatır ve kaydedilmiş kuralları hemen çalıştırabilir; onay gerekir. Güncellemeler duraklatmaları korur.
whollycrypto sslHTTPS'i kontrol et; şunu ekle: --fix onarmak için.
whollycrypto access-reset --domain HOSTBir ana makine adının IP kısıtlamasını kaldır.
whollycrypto update --checkİmzalı güncellemeleri kontrol et.
whollycrypto updateYedekle, güncelle ve yeniden başlat.
whollycrypto backupYalnızca root erişimli arşiv: /root/whollycrypto/backups/releases/.
whollycrypto recoverKesintiye uğramış bakımı veya şeması değişmemiş güncellemeyi kurtar. Veritabanını asla otomatik geri yüklemez.
whollycrypto resetTek bir proje, tüm işletme projeleri veya yalnızca onar seçeneğini seç.
whollycrypto uninstall --check
whollycrypto uninstall
Önce önizle, ardından yerel çalışma ortamını kaldır. Veritabanı, anahtarlar ve yedekler kalır.
whollycrypto welcomeKonsol URL'si ve bağlantıları.
whollycrypto --helpKomutlar; şunu ekle: --help bir komutun ardından seçeneklerini görmek için.
Kurulum sorunlarını teşhis et

Kontroller salt okunurdur; ilgilenilmesi gereken durumlarda sıfırdan farklı çıkış kodu verir. --fix yalnızca yönetilen izinleri ve eksik CLI bağlantısını onarır. Faturalandırmayı değiştirmez, veri silmez veya hizmetleri yeniden başlatmaz.

Sıfırlama kapsamını seç
whollycrypto reset
# Preview without changing anything:
whollycrypto reset --scope business --check
whollycrypto reset --scope project --project YOUR_PROJECT_IDENTIFIER --check

Tek bir proje, tüm işletme projeleri veya yalnızca onar seçeneğini seç. Proje sıfırlamaları seçilen projeleri, mağazaları, cüzdan kayıtlarını ve ödeme geçmişini kalıcı olarak siler. Yalnızca onar seçeneği yönetilen izinleri ve CLI bağlantısını kontrol edip düzeltir.

Önce seçilen projeleri devre dışı bırak, açık ödemeleri/transferleri çöz ve bilinen cüzdan bakiyelerini taşı. Hesaplar, alan adları, düğümler, krediler, faturalandırma kimliği ve kurulum modu kalır. Operatör ödeme alma cüzdanları ve barındırılan kredi kayıtları korunur. Bu işlem kurulum sihirbazını yeniden açmaz.

Veri silen sıfırlama, yazarak onay vermeni gerektirir ve silmeden önce doğrulanmış kurtarma yedeği oluşturur. Sunucu dışında cüzdan yedeği de tut: eski adresler hâlâ para alabilir, ancak silinen projeler bunları izlemeyi bırakır. Önbellekteki bakiyeler cüzdanların boş olduğunu kanıtlamaz.

Yerel kurulumu kaldır
whollycrypto uninstall --check
whollycrypto uninstall

Ödeme sayfasını, API'yi ve çalışanları durdurur; yedekleme ve yazılı onaydan sonra çalışma dosyalarını ve yönetilen sunucu entegrasyonunu kaldırır. Bekleyen ödemeler veya transferler kaldırmayı engeller. Dosyalar silinmek yerine kurtarma yedeğine taşınır.

Veritabanı, yapılandırma, anahtarlar ve yedekler kalır. Paylaşılan Nginx/PostgreSQL paketleri ve TLS sertifikaları değişmez. Komut, çevrimdışı kurtarma komutunu yazdırır; tutulan verilerin üzerine yeni kurulum çalıştırma.

Sıfırlama/kaldırma komutları Docker veya Umbrel için değil, yerel VPS kurulumları içindir. Konteynerlerde entegrasyonunun yedekleme ve durdurma komutlarını kullan; birimleri koru. Veri silen iki komut da şunu kabul etmez: --yes.

Basic Auth girişini sıfırla
whollycrypto htaccess

Bir kullanıcı seç, ad/parola belirle ve onayla. Bu işlem konsol hesabını değil, tarayıcının ilk giriş istemini sıfırlar. Diğer kullanıcılar ve API kimlik bilgileri değişmez.

Yönetici parolasını sıfırla
whollycrypto admin-reset

E-postayla bir yönetici seç ve yeni parolayı onayla. Oturumlar ve hesap giriş kilitleri temizlenir; IP kısıtlamaları kalır.

Normal sıfırlamalar 2FA'yı korur. Hem doğrulayıcı hem kurtarma kodları kaybolduysa açıkça şunu çalıştır: whollycrypto admin-reset --email admin@example.com --reset-2fa. Girişten sonra 2FA'yı yeniden kur.

Uygulama veya eski parola değil, veritabanı gerekir. Diğer hesaplar, cüzdanlar ve izinler değişmez; devre dışı hesaplar devre dışı kalır.

2FA'yı sıfırla

Hem doğrulayıcıyı hem kurtarma kodlarını mı kaybettin? Root olarak bir hesap seç.

whollycrypto 2fa-reset
# Or select the account directly:
whollycrypto 2fa-reset --email user@example.com

Oturumları, doğrulayıcıyı ve kurtarma kodlarını kaldırır. Mevcut parolayla giriş yapıp 2FA'yı yeniden yapılandır. İzinler, cüzdanlar ve Basic Auth değişmez; devre dışı hesaplar devre dışı kalır.

Uygulama veya kredi değil, veritabanı gerekir. Etkileşimsiz kullanım: --email ve --yes.

Üretilen parolalar ve otomasyon

Enter tuşu şurada parola üretir: /root/whollycrypto/config/credential-resets/: özel, şifrelenmemiş ve işlem başarıyla tamamlanınca kullanılabilir. Elle girilen parolalar kaydedilmez.

whollycrypto htaccess --user admin --new-user operator
whollycrypto admin-reset --email admin@example.com

Terminal olmadan mevcut hesabı ve şunu belirt: --generate veya --password-file /root/private-password.txt, ayrıca --yes. Parola dosyalarının sahibi root, izin modu ise şu olmalıdır: 600. Parolaları asla komutlara veya ortam değişkenlerine yazma.

--yes yalnızca onayı atlar. Önce kesintiye uğramış güncellemenin kurtarmasını tamamla; eş zamanlı hesap değişiklikleri sıfırlamaları durdurur.