Ödeme kararını belirleyen sorular

XPayr ile kripto ödeme almaya nasıl başlarım?

Merchant hesabı açın, payout cüzdanı ekleyin, ağ ve token seçin; ardından ödeme linki, widget veya butonunuzu yayınlayın.

Testnet ödeme adımı ve webhook kalite kontrolü için Anında Sandbox Simülatörü nasıl çalışır?

When you create a payment session using a test API key (sk_test_...) on any testnet network, both the hosted checkout page (/test/{session_id}) and the REST API (POST /api/v1/payments/{id}/simulate) allow you to trigger instant simulated outcomes—Completed, Underpaid, Expired, or Failed—without needing testnet faucet tokens. Each simulation generates realistic ledger records and dispatches a signed webhook event to your callback URL.

Canlıya çıkmadan önce test yapabilir miyim?

Evet. Testnet akışlarıyla checkout, cüzdan bağlantısı ve invoice davranışını üretim öncesinde doğrulayabilirsiniz.

Başlamak için kod bilgisi gerekir mi?

Hayır. Merchant paneldeki no-code araçlarla başlayabilir, ileri entegrasyon gerektiğinde API kullanabilirsiniz.

Kurulum genelde ne kadar sürer?

Çoğu merchant ilk kripto checkout akışını birkaç dakika içinde yayına alır.

Ödeme bağlantısı ile donation link arasındaki fark nedir?

Ödeme bağlantısı sabit checkout akışıdır. Donation link destek odaklıdır ve topluluk katkıları için optimize edilir.

Alıcılar ve üye iş yerleri tamamlanan kripto ödemeler için resmî PDF makbuzları indirebilir mi?

Evet. Tamamlanan her ödeme oturumu anında çalışan bir PDF-1.4 makbuz oluşturucu (/public/receipt.php?session_id={id}&download=1) ve yazdırılabilir HTML görünümü içerir. Makbuz üzerinde fatura kimliği, oturum kimliği, üye iş yeri adı, brüt tutar, XPayr geçit komisyonu, net mutabakat tutarı, token, ağ, gönderici/alıcı cüzdan adresleri, UTC zaman damgası ve zincir üstü işlem özeti (hash) yer alır.

Tek bir link birden fazla ödeme alabilir mi?

Evet. Yeniden kullanılabilir linkler kampanya akışınıza göre zaman içinde çoklu ödeme toplayabilir.

Widget, buton veya direkt link ne zaman kullanılmalı?

Gömülü checkout için widget, marka odaklı çağrı için buton, hızlı paylaşım için direkt link kullanın.

Müşteri özel tutar girebilir mi?

Evet. Akış ayarınıza göre özel tutara izin verebilir veya sabit tutarda kalabilirsiniz.

Müşteriler Web3 cüzdanı bağlamadan veya kripto borsalarından doğrudan ödeme yapabilir mi?

Evet. XPayr Çift Ödeme Modu (Çift Katmanlı Ödeme) sunar: Tarayıcı cüzdanları için Web3 Tek Tıkla Ödeme ve merkezi borsalardan (Binance, Bybit, OKX vb.) veya mobil cüzdanlardan ödeyenler için Doğrudan Transfer / QR modu. Müşteriler QR kodu tarayarak veya alıcı adresini kopyalayarak ödemeyi gönderir; ardından İşlem Kodunu (TxID) girerek veya blokzincir tarayıcısının otomatik algılamasını bekleyerek ödemeyi tamamlar. Borsa çekim komisyonlarına karşı %1 (maks. $0.50) eksik ödeme toleransı yerleşiktir.

Çoklu Ağ (Multi-Chain) ödeme linkleri ve bağış sayfaları nasıl çalışır?

Bir ödeme linki veya bağış sayfası oluştururken satıcılar "Tüm Ağlar (Müşteri ödeme sırasında seçer)" seçeneğini belirleyebilir. Müşteriyi tek bir ağa veya coine zorlamak yerine, ödeme ekranında şık bir ağ seçici sunulur. Müşteri EVM ağları (Ethereum, BSC, Polygon, Arbitrum, Avalanche), TRON USDT veya Solana arasından dilediğini seçebilir ve sistem arka planda doğru yönlendirmeyi, akıllı sözleşmeyi ve alıcı cüzdanını anında yükler.

XPayr hangi cüzdanları destekler?

XPayr, EIP uyumlu tarayıcı cüzdanlarını ve modern cüzdan bağlantı akışlarını destekler.

Neden Wallet not registered for this network hatası alıyorum?

Seçili zincir için cüzdan merchant ayarlarında kayıtlı değildir. İlgili ağ için cüzdanı ekleyip kaydetmeniz gerekir.

Bağlandıktan sonra cüzdanı değiştirebilir miyim?

Evet. Mevcut cüzdanı bağlantıdan çıkarıp istediğiniz adresle yeniden bağlanın, sonra ödeme oluşturun veya onaylayın.

Payout cüzdanını doğru şekilde nasıl eklerim?

Merchant panelde Payout Wallets bölümünü açın, ağı seçin, adresi girin ve doğrulama sonrası kaydedin.

XPayr hangi ücreti alır?

XPayr şeffaf şekilde yüzde 0.5 gateway komisyonu uygular. Network gas ücretleri zincir durumuna göre değişir.

XPayr SaaS Abonelik Planları ve 30 günlük Hacim Kademeleri 0.5% geçit komisyonunu nasıl düşürür?

XPayr, ücretsiz Starter planında ($0/ay) şeffaf 0.50% (50 bps) geçit komisyonuyla başlar. Üye iş yerleri Growth Pro ($49/ay ile 0.30% / 30 bps taban komisyon) veya Enterprise Scale ($199/ay ile 0.15% / 15 bps taban komisyon) planına geçebilir. Ek olarak XPayr, son 30 günlük tamamlanmış mainnet USD hacminizi otomatik hesaplar ve Hacim Kademesi indirimi uygular: Bronze ($0+ = 0 bps), Silver ($10,000+ = -5 bps), Gold ($50,000+ = -10 bps) ve Diamond ($250,000+ = -15 bps); böylece efektif geçit komisyonunuz 0.05% (5 bps) taban seviyesine kadar düşer.

Gas ücretini kim öder?

Gas maliyeti işlem gönderen tarafından ağ koşullarına ve seçili token akışına göre on-chain ödenir.

Fonlar ne kadar hızlı tahsil edilir?

On-chain onaydan sonra fonlar doğrudan yapılandırılmış cüzdan akışınıza geçer.

Gizli ücret var mı?

Hayır. Platform ücreti ve network maliyetleri akış içinde açık şekilde gösterilir.

XPayr hesap güvenliğini nasıl artırır?

Hesap ve payout işlemlerini güçlendirmek için 2FA, whitelist kontrolleri ve webhook imza doğrulaması kullanılır.

White Label Powered by XPayr ifadesini kaldırır mı?

Hayır. Güven katmanı için temel marka görünürlüğü kalır; checkout başlığında merchant marka öğeleri gösterilir.

IP whitelist ne işe yarar?

Hassas işlemleri izin verilen IP adresleri ile sınırlar ve izinsiz yönetim işlemlerini azaltır.

Sadece whitelist cüzdanlara payout zorunlu yapılabilir mi?

Evet. Whitelist zorunluluğunu açarak ödemeleri yalnızca onaylı cüzdan ve para birimi eşleşmelerine sınırlandırabilirsiniz.

Webhook eventlerini nasıl doğrularım?

Payload işlemeden önce imza header bilgisini webhook secret ile doğrulayın.

XPayr gelen HMAC-SHA256 istek imzalamayı, ödeme bazında dinamik IPN URL'lerini ve ödeme yöntemi filtrelemeyi destekliyor mu?

Yes. Merchants can generate a dedicated HMAC secret in the API Keys dashboard and send X-Signature and X-Timestamp headers (with a 300-second anti-replay window) on API requests. When creating a payment session via POST /api/v1/payments, you can also pass ipn_url (or ipn_callback_url) to route webhooks dynamically per store/order, and allow_payment_methods (["web3", "direct", "gasless"]) to control which checkout tabs are shown to the buyer.

API key ile secret key farkı nedir?

API key entegrasyon bağlamını tanımlar. Secret key korumalı sunucu tarafı API isteklerini yetkilendirir.

Webhook hangi durumları gönderebilir?

Yaygın durumlar pending, confirmed, failed ve expired ile ilgili güncelleme eventleridir.

Tekrarlayan event işlemeyi nasıl engellerim?

Backend tarafında idempotency kullanın ve işlenen event kimliklerini kayıt altına alıp tekrar işlemeyi engelleyin.

Ödeme linkleri API veya panel üzerinden otomatik fatura e-posta bildirimi ile oluşturulabilir mi?

Evet. POST /payments API uç noktası veya satıcı paneli üzerinden oturum oluştururken send_invoice_email parametresi true olarak belirlenip customer_email girilebilir. XPayr, fatura detaylarını ve tek tıkla ödeme bağlantısını içeren responsive, markalı bir HTML fatura e-postasını müşteriye anında iletir. Ödeme tamamlandığında kayıtlı webhook adresinize anında bildirim gönderilir.

Neden Transaction reverted by EVM hatası alıyorum?

Genellikle ağ uyumsuzluğu, token uyumsuzluğu, cüzdan kaydı eksikliği veya sözleşme doğrulama reddi nedeniyle olur.

Neden invoice detayı yüklenmiyor?

Invoice kaydının merchant hesabınıza ait olduğunu ve ilgili session verisinin mevcut ortamda bulunduğunu doğrulayın.

Neden Session expired uyarısı görünüyor?

Session süresi dolmuş olabilir veya akış tamamlandığı için session sonlandırılmış olabilir.

Neden Connect wallet butonu çalışmıyor?

Cüzdan eklentisinin kurulu ve açık olduğundan, doğru ağda bulunduğunuzdan ve tarayıcı popup engelinin kapalı olduğundan emin olun.

Ekibim tek merchant hesabı kullanabilir mi?

Evet. Operasyon iş akışlarını ekipçe yönetirken ödeme kontrollerini merkezi yapıda koruyabilirsiniz.

Hesap erişimini nasıl geri alırım?

Şifremi unuttum akışını kullanın, kurtarma adımlarını tamamlayın ve erişim sonrası güvenlik ayarlarını güncelleyin.

API keyleri nereden yönetebilirim?

Merchant panelde API Keys bölümünden anahtar oluşturabilir, döndürebilir ve iptal edebilirsiniz.

Maintenance modunda admin siteyi görebilir mi?

Evet. Admin kullanıcıları bakım ekranını atlayabilir, ziyaretçiler ise bakım sayfasını görmeye devam eder.

XPayr Ortaklık ve Referans Programı nasıl çalışır?

XPayr, hem Web2 kurumsal ortaklık takibini (Impact.com S2S aracılığıyla) hem de Web3 doğrudan akıllı sözleşme ödemelerini destekleyen hibrit bir ortaklık altyapısı sunar.

XPayr'a bir geliştirici, ajans veya e-ticaret tüccarı yönlendirdiğinizde, gerçekleşen kripto ödeme komisyonlarından sürekli gelir payı (%30 RevShare) veya aktif tüccar başına $50 CPA kazanırsınız.

Impact.com takibi ve referans linki ilişkilendirmesi nasıl çalışır?

Bir ziyaretçi 'irclickid' parametresi içeren ortaklık linkinize tıkladığında, XPayr bu benzersiz tıklama kimliğini 30 gün boyunca güvenli birinci taraf çerezde saklar.

Kullanıcı kayıt olduğunda, lisans aldığında veya mağazasında ilk ödemesini aldığında, XPayr sunucusu Impact.com REST API'sine doğrudan Server-to-Server (S2S) dönüşüm bildirimi yapar. Bu sayede reklam engelleyicilerden (AdBlock) etkilenmeyen %100 kesin takip sağlanır.

Kazanç modelleri nelerdir: %30 RevShare ve $50 CPA nasıl çalışır?

İki avantajlı kazanç modelinden birini seçebilirsiniz:

1. %30 Sürekli Gelir Payı (RevShare): Yönlendirdiğiniz tüccarların gerçekleştirdiği tüm kripto ödemelerindeki %0.5'lik işlem ücretinin %30'unu ömür boyu kazanırsınız.
2. $50 Aktivasyon CPA: Yönlendirdiğiniz tüccar mağazasını açıp ilk $100'lık ödeme hacmine ulaştığı anda tek seferlik $50 net komisyon kazanırsınız.

Kripto referans ödüllerimi cüzdanıma doğrudan nasıl çekerim?

Tüccar Yönetim Panelinizde (/merchant/affiliate) EVM veya Solana cüzdanınızı bağlayın.

Akıllı sözleşme her ödemede %30 referans payınızı otomatik olarak havuzunuza ayırır. İstediğiniz an 'Claim' (Talep Et) butonuna basarak biriken USDT, USDC veya SOL ödüllerinizi aracı ve onay beklemeden doğrudan kendi cüzdanınıza çekebilirsiniz.

Resmi rozetleri ve reklam banner setlerini nereden alabilirim?

XPayr Marka Görselleri Stüdyosu'nu (/brand-assets) ziyaret edin.

Burada dinamik SVG rozetlerinizi (Verified Merchant, Powered by XPayr, Official Partner) özelleştirebilir ve standart reklam banner boyutları (728x90 Leaderboard, 300x250 Medium Rectangle, 1200x630 Sosyal Kart) için tek tıkla HTML yerleştirme kodlarını kopyalayabilirsiniz.

Kendi kendine referans olma, çoklu hesaplar veya testnet işlemleri ödüllendirilir mi?

Hayır. XPayr, ana ağ (mainnet) ile testnet işlemlerini kesin şekilde izole eder.

Kendi kendine referans olma (aynı cüzdan adresini veya tüccar hesabını kullanma), yapay işlem hacmi yaratma ve testnet işlemleri otomatik anti-fraud korumasıyla filtrelenir ve komisyon ödenmez.