Zaten keşfediyorsanız OxaPay, Muhtemelen web sitenizde karmaşıklık, gecikme veya ekstra risk olmadan kripto ödemeleri kabul etmenin güvenilir bir yolunu arıyorsunuz. Bu kılavuz, gerçek uygulama deneyimlerinden derlenmiştir ve ister bir ödeme bağlantısı kurun, ister bir eklenti yükleyin, ister tam API'yi entegre edin, tam olarak nasıl başlayacağınızı gösterir.
Başlamadan Önce: Entegrasyon Öncesi Kontrol Listesi
Entegrasyon adımlarına geçmeden önce aşağıdakilerin hazır olduğundan emin olun:
- İşlevsel bir web sitesi (WordPress, SaaS veya özel arka uç).
- Eklentileri yüklemek veya arka uç kodunu düzenlemek için yönetici erişimi.
- Bir iş hedefi: Ürünler, abonelikler veya bağışlar için kripto para kabul ediyor musunuz?
- OxaPay hesabınız oluşturuldu ve doğrulandı (KYC/KYB'ye gerek yok)).
- İsteğe bağlı: API'yi kullanmayı planlıyorsanız geliştirici erişimi.
Platformunuzun ve ekibinizin, geliştirici katılımı olsun veya olmasın, doğrudan web siteniz üzerinden kripto para işlemlerini desteklemeye teknik olarak hazır olduğundan emin olun.
🧭 İpucu: Hangi yöntemi kullanacağınızdan (eklenti veya API) emin değilseniz, sonundaki karşılaştırma tablosunu kontrol edin.
Adım 1: Bir OxaPay Hesabı Oluşturun ve API'nize Erişin
Entegrasyon başlamadan önce doğrulanmış bir OxaPay hesabınızın olması gerekir. Yapmanız gerekenler şunlardır:
- Oxapay'e kaydolun– KYC/KYB gerekmez.
- Kontrol Panelinize > API Ayarlarına gidin.
- Kopyala Tüccar API Anahtarı ve Geri Arama Gizlinizi not edin.
Bu kimlik bilgileri, web siteniz ile OxaPay arasında güvenli bir bağlantının temelini oluşturur ve web sitenizde kripto ödemelerini tam kontrolle kabul edebilmenize giden ilk adımdır.
🔒 Geliştirici İpucu:
Daha iyi güvenlik için API anahtarlarınızı düzenli aralıklarla döndürün ve bunları kod tabanınızda değil, ortam değişkenlerinde saklayın.
Ödeme API Güvenliği: API Anahtarı Güvenliği için En İyi Uygulamalar
Adım 2: Doğru Entegrasyon Yöntemini Seçin
OxaPay, kripto ödemelerini sitenize entegre etmenin birden fazla yolunu destekler. Web sitenizin türüne ve teknik kapasitesine göre seçim yapın:
1. Eklenti Entegrasyonu (Kod Gerekmez)
WooCommerce, WHMCS ve Blesta gibi e-ticaret ve faturalandırma platformları için idealdir. OxaPay ayrıca ek platformları da destekler., tüm kripto ödeme eklentilerini ve entegrasyonlarını keşfedin İşletmeniz için.
Nasıl yapılır:
- Eklentiyi şuradan yükleyin: OxaPay'in dokümantasyon sayfası.
- API Anahtarınızı ayarlara yapıştırın.
- Tercih ettiğiniz paraları ve ödeme zaman aşımını ayarlayın.
- Tamamdır. Yayındasınız.
⏱ Kurulum süresi: ~15 dakika
2. API Entegrasyonu (Geliştiriciler İçin)
Özel bir platform çalıştırıyorsanız, şunu kullanacaksınız: Fatura oluşturmak için OxaPay'in REST API'si ve işlemleri tam arka uç kontrolüyle yönetin.
Kullanacağınız temel uç noktalar:
- POST /api/fatura-oluştur
- GET /api/check-invoice
- Web kancası: HMAC doğrulamasıyla POST geri araması
Temel akış:
- Arka ucunuz tutar, jeton türü ve yönlendirme URL'si içeren bir fatura oluşturur.
- OxaPay benzersiz bir ödeme adresi döndürür.
- Müşteri ödemeyi cüzdan veya QR kodu ile yapar.
- OxaPay işlemi onaylar ve geri arama URL'nize imzalı bir webhook gönderir.
🧩 Entegrasyon genellikle 80-150 satır backend kodu gerektirir.
Her iki yöntem de, ister bir eklenti kullanıyor olun ister tamamen özel bir arka uç oluşturuyor olun, web sitenizde kripto ödemelerini güvenilir bir şekilde kabul etmenize yardımcı olmak için tasarlanmıştır. API'nin nasıl çalıştığı ve onunla neler yapabileceğiniz hakkında daha derinlemesine bilgi için, kapsamlı kılavuzumuza bakın. Kripto Ödeme API'si ve Kullanım Örnekleri.
📦 Geliştirici Köşesi – Örnek Python Kodu
istekleri içe aktar hmac, hashlib API_KEY = "api-anahtarınız" CALLBACK_SECRET = "sırrınız" invoice_data = { "tutar": 49,99, "para birimi": "USDT", "geri-çağrı_url": "https://your-site.com/payment-callback" } response = requests.post("https://api.oxapay.com/api/create-invoice", json=invoice_data, headers={"Authorization": API_KEY}) print(response.json()) def verify_signature(data, signature): return hmac.new(CALLBACK_SECRET.encode(), data.encode(), hashlib.sha256).hexdigest() == signature
📘 Geri Arama Basitleştirildi:
Geri arama uç noktanızın herkese açık olduğundan ve geri döndüğünden emin olun HTTP 200 Tamam.
Gelenleri kaydedebilirsiniz POSTALAMAK Yapıyı doğrulamak ve imza doğrulama mantığınızı test etmek için istekler.
Adım 3: Ödeme Davranışını Özelleştirin
OxaPay'in sitenizde ödemeleri nasıl işleyeceğini ayarlayabilirsiniz:
- Otomatik Dönüştürme: Alınan kriptoyu anında USDT'ye dönüştürün .
- Fatura Zaman Aşımı: Faturaların ne kadar süre geçerli kalacağını tanımlayın.
- Az Ödenen Tazminat: Kullanıcıların gerekenden az ödeme yapmaları durumunda ödemelerini tamamlamalarını sağlayın.
- Dil ve Markalaşma: Ödeme sayfasının başlığını, logosunu ve dilini özelleştirin.
Bu ayarlara fatura oluşturma sırasında panodan veya API parametrelerinden erişilebilir.
Bu seçeneklerin hassas bir şekilde ayarlanması, müşterilerinizin web sitenizde kripto ödemelerini kabul ederken markanız ve operasyonel ihtiyaçlarınızla uyumlu, tutarlı bir deneyim yaşamasını sağlar.
⚙️ Geliştiriciler İçin Gelişmiş İpucu:
Markalamayı dinamik olarak uygulamak için API aracılığıyla fatura oluşturma sırasında custom_logo_url, language ve redirect_after alanlarını geçirin.
🔗 Markalı bir kripto ödeme deneyimi oluşturmakla ilgileniyor musunuz? Daha fazla bilgi edinin Özel Bir Ödeme Ağ Geçidi Nasıl Oluşturulur.
4. Adım: Canlı Yayına Geçmeden Önce Entegrasyonunuzu Test Edin
Uygulamanızı her zaman şunu kullanarak test edin: OxaPay'in deneme alanı çevre:
- Sahte tutarlarla test faturaları oluşturun.
- Test cüzdanlarını kullanarak ödeme onaylarını simüle edin.
- Geri aramaların sunucunuza ulaştığını ve doğru mantığı tetiklediğini doğrulayın (örneğin, bir siparişi ödenmiş olarak işaretlemek).
🔐 Geliştirici İpucu:
Her geri aramada gönderilen HMAC imzasını kullanarak geri arama sırrınızı kullanarak kimlik doğrulamasını yapın. Olası kötüye kullanımları izlemek için başarısız doğrulama girişimlerini günlüğe kaydedin.
🛠 Yaygın Sorunların Giderilmesi:
- Fatura Süresi Doldu mu? Ayarlardan zaman aşımını uzatın veya hızlı yeniden üretime izin verin.
- Eksik Ödenmiş İşlem? Müşterilerin geri kalanını tamamlayabilmesi için "Az Ödenen Tahsilat" özelliğini etkinleştirin.
- Geri Arama Alınmadı mı? Sunucu uç noktanızın herkese açık olduğundan ve POST isteklerini doğru şekilde kabul ettiğinden emin olun.
🧪 Test İpucu:
TronLink veya MetaMask gibi test cüzdanlarını kullanarak test ağlarında ödemeleri simüle edebilirsiniz. OxaPay, güvenli denemeler için özel bir deneme ortamı modu sunar. Doğru test, arıza oranlarını azaltır ve sisteminizin gerçek dünya koşullarında web sitenizde kripto ödemelerini kabul etmeye gerçekten hazır olmasını sağlar.
Adım 5: Web Sitenizde Kripto Parayı Kabul Etmeye Başlayın
Test tamamlandıktan sonra:
- Faturalarınızı deneme ortamından canlı moda geçirin.
- OxaPay panosunda ödeme onaylarını izleyin.
- Artık OxaPay panosu aracılığıyla web sitenizde güvenli bir şekilde, gerçek zamanlı olarak ve tam görünürlükle kripto ödemelerini kabul etmeye hazırsınız.
🌟 Müşterilerinizin Deneyimi
- Temiz, mobil uyumlu ödeme ekranı.
- Gerçek zamanlı QR kod ve cüzdan adresi gösterimi.
- Fatura geçerlilik süresi için geri sayım sayacı.
- Ödeme başarılı olduğunda otomatik onay.
✨ Bu görsel ve işlevsel unsurlar güveni artırır ve vazgeçmeleri azaltır.
💸 İlk Kripto Ödemeniz (Adım Adım)
İlk işleminizde akış şu şekilde görünür:
- Faturanızı eklenti veya API aracılığıyla oluşturursunuz.
- Müşteri tamamen özelleştirilmiş bir ödeme sayfasıyla karşılaşır.
- Kripto cüzdanlarını kullanarak ödeme yapıyorlar (QR'yi tarayın veya adresi yapıştırın).
- OxaPay işlemi onaylar ve geri arama yoluyla sisteminizi günceller.
- Onayınızı kontrol panelinizde görürsünüz.
⚡ TRON veya BSC tabanlı ödemelerin çoğu 60 saniyeden kısa sürede onaylanır.
🧩 Uzun Vadeli Başarı İçin İpuçları
- Borsa cüzdanınıza veya soğuk depolamanıza otomatik çekim özelliğini etkinleştirin.
- Faturaları uzlaştırmak için işlem geçmişini haftalık olarak kontrol edin.
- İyileştirilmiş kurtarma oranı için düşük ücretli izlemeyi kullanın.
- Destek ekibinizi ödeme durumları ve fatura son kullanma tarihleri konusunda bilgilendirin.
- Markalamayı ve dilleri kullanıcı konumuna göre ayarlayın.
📊 Entegrasyon Yöntemi Karşılaştırması
| Yöntem | Kurulum Süresi | Karmaşıklık | En İyisi İçin |
| Eklenti | ~15 dk | Düşük | WooCommerce, WHMCS, Blesta |
| REST API | 1–3 saat | Orta | SaaS, özel web uygulamaları, arka uç |
Sonuç: Basitlik için Tasarlandı. Ölçeklenebilirliğe Hazır.
OxaPay ile, karmaşık blockchain kodları yazmanıza veya üçüncü taraf saklama kuruluşlarına bağlı kalmanıza gerek kalmadan web sitenizde kripto ödemeleri kabul edebilirsiniz. İşlem hızlı, güvenli ve basit eklentilerden tam API kontrolüne kadar ölçeklenebilir şekilde tasarlanmıştır.
🎯 Canlı yayına hazır mısınız?
Canlı yayına hazır mısınız? Başlayın OxaPay kripto ödeme ağ geçidi veya dalın API dokümantasyonu İşletmeniz için özel bir çözüm oluşturmak.
