Solana Pay, geliştiricilerin merkeziyetsiz ödemeleri uygulamalarına ve hizmetlerine entegre etmelerini sağlayan standart bir protokol ve referans uygulama setidir. Solana ekosistemi genelinde ödemeler için birleşik bir yaklaşım sunarak cüzdanlar, uygulamalar ve hizmetler arasında uyumluluk sağlar.
Protokole Genel Bakış
Solana Pay iki ana ödeme talebi türü tanımlar:
Transfer Talepleri (Etkileşimsiz)
Transfer talepleri, URL parametrelerini kullanarak basit SOL veya SPL token transferlerini tanımlar. Cüzdan, ek sunucu iletişimine gerek kalmadan doğrudan işlemi oluşturabilir ve imzalayabilir.
solana:recipient?amount=1.5&spl-token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Kullanım Alanları:
- Basit ödemeler ve bağışlar
- Satış noktasında QR kod ödemeleri
- E-postalarda veya mesajlarda ödeme linkleri
- Mobil uygulama derin bağlantı
İşlem Talepleri (Etkileşimli)
İşlem talepleri, cüzdanın herhangi bir Solana işlemini oluşturmak için bir sunucuyla iletişim kurmasını sağlayarak karmaşık etkileşimlere olanak tanır. Bu, basit transferlerin ötesinde gelişmiş kullanım senaryolarının önünü açar.
solana:https://merchant.com/api/payment
Kullanım Alanları:
- Satış noktasında NFT basımı
- Dinamik fiyatlandırma ve indirimler
- Çok aşamalı DeFi işlemleri
- Sadakat programı entegrasyonu
- Özel iş mantığı
Temel Avantajlar
Geliştiriciler İçin
- Standart Protokol: Tek bir uygulama tüm Solana cüzdanlarında çalışır
- Framework Bağımsız: Herhangi bir web framework veya mobil platformla kullanın
- Tip Güvenliği: JavaScript SDK'da tam TypeScript desteği
- Esnek: Basit transferlerden karmaşık çok talimat içeren işlemlere kadar
Kullanıcılar İçin
- Hızlı: İşlemler bir saniyenin altında onaylanır
- Ucuz: İşlem başına ortalama 0,0005 $ maliyet
- Güvenli: Aracı veya üçüncü taraf işlemci yok
- Evrensel: Herhangi bir Solana cüzdanıyla çalışır
Satıcılar İçin
- Komisyon Yok: İşlem ücreti olmadan doğrudan ödemeler
- Gerçek Zamanlı: Anında mutabakat ve onay
- Küresel: Dünyanın her yerinden ödeme kabul edin
- Birleştirilebilir: DeFi protokolleri ve NFT pazaryerleriyle entegre olun
Teknik Mimari
URL Şeması
Solana Pay, web tarayıcıları ve mobil işletim sistemlerinde çalışan özel bir
solana: URL şeması kullanır:
- Web: URL'ler bağlantı olarak kullanılabilir veya QR kodlarına kodlanabilir
- Mobil: Cüzdan uygulamalarıyla derin bağlantı entegrasyonu
- Masaüstü: Sorunsuz cüzdan başlatma için protokol işleyicileri
JavaScript SDK
@solana/pay SDK'sı (@solana/kit üzerine inşa edilmiştir) şunları sağlar:
- İstemci fabrikaları: Birleştirilebilir ödeme akışları için
createMerchantClient,createWalletClient,createSolanaPayClient - URL kodlama/ayrıştırma: Solana Pay URL'leri için
encodeURL,parseURL - Transfer oluşturma: SOL ve SPL token ödeme talimatları için
createTransfer - Ödeme doğrulama: Ödemeleri tespit etmek ve doğrulamak için
findReference,validateTransfer,watchReference - QR kodları: Taranabilir ödeme kodları oluşturmak için yerleşik
createQR - Kit eklentileri: Diğer
@solana/kiteklentileriyle birleştirme içinsolanaPayMerchant(),solanaPayWallet()
Cüzdan Entegrasyonu
Destekleyen cüzdanlar şunları uygular:
- URL şeması işleme ve ayrıştırma
- İşlem kompozisyonu ve doğrulama
- Kullanıcı onay akışları
- İşlem yayını ve izleme
Ödeme Akışı Örnekleri
Web Uygulamasından Mobil Cüzdana
- Web uygulaması Solana Pay URL'si ile QR kodu oluşturur
- Kullanıcı cüzdan uygulamasıyla QR kodunu tarar
- Cüzdan URL'yi ayrıştırır ve ödeme detaylarını gösterir
- Kullanıcı cüzdanda ödemeyi onaylar
- Cüzdan işlemi imzalar ve yayınlar
- Web uygulaması ödeme onayını algılar
Web Uygulamasından Tarayıcı Cüzdanına
- Web uygulaması "Solana ile Öde" düğmesini gösterir
- Kullanıcı cüzdanı başlatmak için düğmeye tıklar
- Cüzdan uzantısı ödeme onayını gösterir
- Kullanıcı işlemi onaylar
- İşlem imzalanır ve gönderilir
- Web uygulaması ödeme onayını alır
Mobil Uygulamadan Mobil Cüzdana
- Mobil uygulama ödeme deep link'i oluşturur
- Deep link, cüzdan uygulamasını başlatır
- Cüzdan, ödeme onayını gösterir
- Kullanıcı ödemeyi onaylar veya reddeder
- Cüzdan, orijinal uygulamaya geri döner
- Uygulama, ödeme sonucunu alır
Güvenlik Hususları
Satıcılar İçin
- İşlemleri Doğrulayın: İşlem detaylarını her zaman zincir üzerinde doğrulayın
- Referansları Kullanın: Ödemeleri tanımlamak için benzersiz referans anahtarları ekleyin
- Sunucu Taraflı Doğrulama: Tutarları hesaplayın ve ödemeleri sunucu tarafında doğrulayın
- Hız Sınırlama: Ödeme uç noktalarında uygun hız sınırları uygulayın
Cüzdan Geliştiricileri İçin
- URL Doğrulaması: Tüm URL bileşenlerini doğrulayın ve temizleyin
- Kullanıcı Onayı: Kullanıcılara her zaman net ödeme detaylarını gösterin
- İşlem Doğrulaması: İmzalamadan önce işlem içeriğini doğrulayın
- Yalnızca HTTPS: İşlem istekleri için yalnızca HTTPS URL'lerine izin verin
Entegrasyon Modelleri
E-ticaret Ödeme Sayfası
- Müşteri sepete ürün ekler
- Satıcı, sipariş detayları ile ödeme talebi oluşturur
- Müşteri QR kodu tarar veya ödeme butonuna tıklar
- Cüzdan, madde madde fiş ve toplam tutarı gösterir
- Müşteri ödemeyi onaylar
- Satıcı işlemi doğrular ve siparişi yerine getirir
Satış Noktası
- Kasiyer satış tutarını girer
- POS sistemi QR kodu gösterir
- Müşteri mobil cüzdanıyla tarar
- Ödeme anında işlenir
- Fiş otomatik olarak yazdırılır
Abonelik Hizmetleri
- Kullanıcı hizmete abone olur
- Hizmet, yinelenen ödeme takvimi oluşturur
- Otomatik sistem, ödeme talepleri oluşturur
- Kullanıcı, cüzdan üzerinden ödemeleri onaylar
- Hizmet, ödeme durumunu takip eder
En İyi Uygulamalar
URL Oluşturma
- Tüm işlem talebi uç noktaları için HTTPS kullanın
- Açıklayıcı etiketler ve mesajlar ekleyin
- Ödeme takibi için benzersiz referanslar oluşturun
- URL oluşturmadan önce tüm parametreleri doğrulayın
İşlem Yönetimi
- İşlemleri her zaman sunucu tarafında doğrulayın
- Güvenlik için uygun onay sayılarını kullanın
- Düzgün hata yönetimi ve yeniden deneme mekanizmaları uygulayın
- Mutabakat için ödeme olaylarını kaydedin
Kullanıcı Deneyimi
- Net ödeme onayları sağlayın
- İşlem durumu güncellemelerini gösterin
- Cüzdan bağlantısını sorunsuz bir şekilde yönetin
- Birden fazla cüzdan seçeneğini destekleyin
Sonraki Adımlar
Solana Pay'i entegre etmeye hazır mısınız? Bu kılavuzlarla başlayın:
- Kurulum Kılavuzu - SDK ve araçları kurun
- Transfer İstekleri - Basit ödeme URL'leri oluşturun
- İşlem İstekleri - Etkileşimli akışlar oluşturun
- Entegrasyon Örnekleri - Gerçek dünya uygulamalarını görün
Kaynaklar
- Resmi Spesifikasyon - Eksiksiz protokol spesifikasyonu
- GitHub Deposu - Kaynak kodu ve örnekler
- Marka Kuralları - Logolar ve marka varlıkları
Is this page helpful?