PHP SDK'sı
PHP 7.4+Composer ile PHP uygulamana kripto ödemeleri ekle.
composer require whollycrypto/php-sdkBAŞLA
Kur, ödeme kabul et ve sunucunla ilgilen.
Root erişimli yeni bir Linux VPS kullan; mevcut web sitesi veya veritabanı sunucunu kullanma. Docker, derleyici veya blokzincir düğümü gerekmez.
| VPS | Asgari Hafif kullanım | Önerilen |
|---|---|---|
| CPU | 1 vCPU | 2 vCPU |
| RAM | 2 GB | 4 GB |
| SSD | 20 GB | 60 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.
Ü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.
Bu varsayılan ana makine adlarını VPS'ine yönlendir veya kendi adlarını seç:
merchant.example.com: konsolpay.example.com: ödeme sayfasıapi.example.com: APIKurulum 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.
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) --resumeEk 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ı.
QR kodları kalan tutarın tamamını ister. Tolerans yalnızca eksik ödemeleri kabul eder; onay gereksinimleri geçerliliğini korur.
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.
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.
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.
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.
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.
%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.
7.1.0'dan itibaren Operatör modunda kullanılabilir.
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.
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.
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.
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 →
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
status olayın oluşturulduğu andaki fatura durumudur; event_type ne olduğunu bildirir.
payment.received + processing, ardından invoice.settled + settled.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.
| Fatura durumu | Anlamı |
|---|---|
new | Ödeme bekleniyor |
processing | Kısmi ödeme veya kesinleşme bekleniyor |
settled | Fatura kurallarına göre veya elle kabul edildi |
expired | Son 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.
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.
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.
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.
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ır | Kullanılabilir kredi yoksa duraklatılır |
|---|---|
| Faturalar, ödeme sayfası ve onaylar | Yeniden denemeler dahil IPN/webhook'lar |
| Cüzdanlar, bakiyeler ve yedekler | Bakiye Aktarımı: gönderimler, gas, iadeler ve yeni borsa dönüştürmeleri |
| Raporlar, okuma API'leri ve mevcut ayarlar | Proje ve mağaza oluşturma |
| Güncelleme kontrolleri ve kesintiye uğrayan güncellemeyi kurtarma | Yeni 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.
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 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.
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.
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.
İsteğe bağlı, proje kapsamlı erişim: api.example.com/mcp. Ödemeleri oku veya fatura oluşturmaya izin ver. MCP kurulumu ve izinleri →
Fatura oluşturmak, ödemeleri kontrol etmek ve IPN/webhook'ları doğrulamak için resmî SDK'larımızı kullan.
Composer ile PHP uygulamana kripto ödemeleri ekle.
composer require whollycrypto/php-sdkÇalışma zamanı bağımlılığı olmadan Python uygulamanı veya arka ucunu bağla.
python -m pip install whollycryptoJavaScript veya TypeScript için yerleşik tipler içeren tek bir npm paketi.
npm install whollycryptoXcode'a main dalını ekle. Swift kurulumu ve uygulama güvenliği →
https://github.com/whollycrypto-com/whollycrypto-swift-sdk.gitKurulumunun API alan adını kullan ve API anahtarlarını sunucu tarafında tut. Tüm SDK'lar MIT lisanslıdır.
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.
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.
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.
Zil, bildirim gelen kutunu açar. Tema seçenekleri ayarlar menüsündedir.
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.
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.
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ğı
Raporlar, İşlemler, Dışa Aktarımlar ve Kontroller için Ayarlar → Muhasebe bölümünü aç. Kontrol paneli ayrı kalır.
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.
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.
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.
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.
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ı →
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.
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 → 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.
/.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.
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.
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.
merchant.* veya api.* ana makine adı için güvenilir IP'lere/aralıklara izin ver. Mevcut konsol IP'sine izin verilmeye devam edilmelidir.pay.* açık bırak: müşteriler her yerden ödeme yapabilmelidir.İ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.
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.
Ç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.
Kararlar gerekçe ister. İadeler ayrı ve onaylanmış transfer gerektirir; fatura durumunu değiştirmek asla para göndermez.
Ş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 updateGü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.
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.
Kurulum ve güncellemeler otomatik olarak şunu dener: resmî GitHub aynası. İmza, sağlama toplamı ve kredi kontrolleri yine gereklidir.
SSH üzerinden root komutları.
whollycrypto status
whollycrypto doctor
whollycrypto backup| Komut | Amaç |
|---|---|
whollycrypto version | Kurulu sürüm. |
whollycrypto status | Uygulama ve veritabanı sağlığı. |
whollycrypto logs | Son 80 uygulama günlük satırı. |
whollycrypto restart | Yeniden başlat ve sağlığı kontrol et. |
whollycrypto doctor | Salt okunur kurulum kontrolleri. |
whollycrypto doctor --fix | Yönetilen izinleri ve eksik CLI bağlantısını onar. |
whollycrypto htaccess | Basic Auth girişini sıfırla. |
whollycrypto admin-reset | Yönetici parolasını sıfırla. |
whollycrypto 2fa-reset | Bir hesabın doğrulayıcısını parolasını değiştirmeden sıfırla. |
whollycrypto transfers statuswhollycrypto transfers enablewhollycrypto 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 ssl | HTTPS'i kontrol et; şunu ekle: --fix onarmak için. |
whollycrypto access-reset --domain HOST | Bir ana makine adının IP kısıtlamasını kaldır. |
whollycrypto update --check | İmzalı güncellemeleri kontrol et. |
whollycrypto update | Yedekle, güncelle ve yeniden başlat. |
whollycrypto backup | Yalnızca root erişimli arşiv: /root/whollycrypto/backups/releases/. |
whollycrypto recover | Kesintiye uğramış bakımı veya şeması değişmemiş güncellemeyi kurtar. Veritabanını asla otomatik geri yüklemez. |
whollycrypto reset | Tek bir proje, tüm işletme projeleri veya yalnızca onar seçeneğini seç. |
whollycrypto uninstall --checkwhollycrypto uninstall | Önce önizle, ardından yerel çalışma ortamını kaldır. Veritabanı, anahtarlar ve yedekler kalır. |
whollycrypto welcome | Konsol URL'si ve bağlantıları. |
whollycrypto --help | Komutlar; şunu ekle: --help bir komutun ardından seçeneklerini görmek için. |
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.
whollycrypto reset
# Preview without changing anything:
whollycrypto reset --scope business --check
whollycrypto reset --scope project --project YOUR_PROJECT_IDENTIFIER --checkTek 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.
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.
whollycrypto htaccessBir 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.
whollycrypto admin-resetE-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.
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.comOturumları, 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.
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.comTerminal 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.