Genel Bakış

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/kit eklentileriyle birleştirme için solanaPayMerchant(), 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

  1. Web uygulaması Solana Pay URL'si ile QR kodu oluşturur
  2. Kullanıcı cüzdan uygulamasıyla QR kodunu tarar
  3. Cüzdan URL'yi ayrıştırır ve ödeme detaylarını gösterir
  4. Kullanıcı cüzdanda ödemeyi onaylar
  5. Cüzdan işlemi imzalar ve yayınlar
  6. Web uygulaması ödeme onayını algılar

Web Uygulamasından Tarayıcı Cüzdanına

  1. Web uygulaması "Solana ile Öde" düğmesini gösterir
  2. Kullanıcı cüzdanı başlatmak için düğmeye tıklar
  3. Cüzdan uzantısı ödeme onayını gösterir
  4. Kullanıcı işlemi onaylar
  5. İşlem imzalanır ve gönderilir
  6. Web uygulaması ödeme onayını alır

Mobil Uygulamadan Mobil Cüzdana

  1. Mobil uygulama ödeme deep link'i oluşturur
  2. Deep link, cüzdan uygulamasını başlatır
  3. Cüzdan, ödeme onayını gösterir
  4. Kullanıcı ödemeyi onaylar veya reddeder
  5. Cüzdan, orijinal uygulamaya geri döner
  6. 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ı

  1. Müşteri sepete ürün ekler
  2. Satıcı, sipariş detayları ile ödeme talebi oluşturur
  3. Müşteri QR kodu tarar veya ödeme butonuna tıklar
  4. Cüzdan, madde madde fiş ve toplam tutarı gösterir
  5. Müşteri ödemeyi onaylar
  6. Satıcı işlemi doğrular ve siparişi yerine getirir

Satış Noktası

  1. Kasiyer satış tutarını girer
  2. POS sistemi QR kodu gösterir
  3. Müşteri mobil cüzdanıyla tarar
  4. Ödeme anında işlenir
  5. Fiş otomatik olarak yazdırılır

Abonelik Hizmetleri

  1. Kullanıcı hizmete abone olur
  2. Hizmet, yinelenen ödeme takvimi oluşturur
  3. Otomatik sistem, ödeme talepleri oluşturur
  4. Kullanıcı, cüzdan üzerinden ödemeleri onaylar
  5. 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:

Kaynaklar

Is this page helpful?

Yönetici

© 2026 Solana Vakfı.
Tüm hakları saklıdır.
Bağlanın