Ana içeriğe geç

Akıllı sözleşme entegrasyonu

Volet.com akıllı sözleşmeleriyle kripto para ödemelerini doğrudan kendi cüzdanınıza alın. Müşteriler kripto cüzdanlarını bağlayıp işlemleri onaylar; akıllı sözleşme ödemeyi işler, fonları ve işlem komisyonunu zincir üstünde dağıtır.

Ne sizin ne de müşterilerinizin Volet.com hesabına ihtiyacı vardır. Alıcı cüzdanınızın kontrolü sizdedir ve ödeme onayını kendi uygulamanızda yönetirsiniz.

Önemli: Bu entegrasyon Hosted Checkout veya Merchant API faturalarını kullanmaz. Ödeme arayüzünü uygulamanız sunar ve ödemeleri doğrudan blokzincir üzerinde doğrular. Volet.com bu akışta ödeme durumu bildirimi göndermez.

Nasıl çalışır​

Emanetçi olmayan bir ödeme entegrasyonunda üç bileşen yer alır:

  • Uygulamanız: Siparişleri oluşturur, ödemeleri başlatır ve işlemleri doğrular.
  • Müşterinin cüzdanı: Uygulamanıza bağlanır ve ödeme işlemlerini imzalar.
  • Volet.com akıllı sözleşmesi: Ödemeleri işler, fonları cüzdanınıza aktarır ve işlem komisyonunu tahsil eder.

Ödeme akışı​

  1. Sipariş oluşturun. Arka ucunuz ödeme tutarını, varlığı, blokzincir ağını ve üye işyerinin alıcı cüzdanını kaydeder.
  2. Müşterinin cüzdanını bağlayın. Uygulamanız uyumlu bir kripto cüzdanın bağlanmasını ister.
  3. Ödemeyi hesaplayın. Akıllı sözleşmenin previewPayment() fonksiyonu işlem komisyonunu ve müşterinin ödemesi gereken tutarı döndürür.
  4. Ödeme isteyin. Müşteri işlemi inceler ve imzalar. USDT gibi token ödemeleri önce ayrı bir onay gerektirebilir.
  5. İşlem gerçekleştirilir. Akıllı sözleşme fonları cüzdanınıza aktarır ve işlem komisyonunu tahsil eder.
  6. İşlemi kaydedin. Uygulamanız işlem hash'ini (txid) kaydeder ve siparişle ilişkilendirir.
  7. Ödemeyi doğrulayın. Arka ucunuz işlemi bağımsız olarak kontrol eder: durum, ağ, sözleşme, varlık, alıcı, tutar ve blokzincirdeki kesinlik.
  8. Siparişi tamamlayın. Doğrulama başarılı olduğunda uygulamanız siparişi ödendi olarak işaretler ve yalnızca bir kez teslim eder.

Önemli: İşlem hash'i, cüzdandaki onay veya başarılı işlem durumu tek başına siparişin ödendiğini kanıtlamaz. Siparişi teslim etmeden önce ödeme ayrıntılarını her zaman arka uçta doğrulayın.

Ağınızı seçin​

Kabul etmek istediğiniz ağlar ve varlıklar için entegrasyon kılavuzunu seçin.

AğBu kılavuzlardaki varlıklarMüşteri cüzdanlarıEntegrasyon kılavuzu
Ethereum ve BNB Smart ChainETH, BNB, USDT (ERC-20 ve BEP-20)MetaMask ve WalletConnect uyumlu cüzdanlarEVM entegrasyonu
TRONTRX, USDT (TRC-20)TronLink; ayrı bir entegrasyonla WalletConnectTRON entegrasyonu

Diğer ağlar ve varlıklar ayrı uygulamalar gerektirebilir. Ürüne ve mevcut seçeneklere genel bakış için Emanetçi olmayan kripto ödemeleri kabul etme sayfasına bakın.

Başlamadan önce​

İhtiyacınız olanlar:

  • Üye işyeri cüzdanı: Ödemeleri almak için kontrolünüzde olan bir kripto cüzdan.
  • Uygulama: Ödeme arayüzü olan bir web sitesi veya uygulama.
  • Arka uç ve veritabanı: Sipariş oluşturmak, işlem ayrıntılarını saklamak ve ödemeleri doğrulamak için.
  • Cüzdan entegrasyonu: Seçtiğiniz ağla uyumlu bir cüzdan bağlantı kütüphanesi.
  • Akıllı sözleşme bilgileri: Volet.com'un sağladığı işlemci sözleşme adresleri, ABI ve parametreler.
  • Blokzincir erişimi: İşlemleri doğrulamak için bir RPC sağlayıcısı veya barındırılan blokzincir hizmeti.

Entegrasyonunuza bağlı olarak bir WalletConnect Project ID veya TronGrid API anahtarına da ihtiyacınız olabilir.

Akıllı sözleşme bilgilerini almak ve entegrasyonunuzu konuşmak için ekibimizle iletişime geçin.

İşlem komisyonları​

Akıllı sözleşme işlem komisyonunu previewPayment() ile hesaplar. Komisyonu kimin ödeyeceğini uygulamanız seçer:

  • Müşteri öder: Komisyon ödeme tutarına eklenir. Üye işyeri talep edilen tutarı alır.
  • Üye işyeri öder: Komisyon talep edilen tutardan düşülür. Üye işyeri kalanı alır.

Ethereum'daki gas veya TRON'daki Energy ve Bandwidth maliyetleri gibi blokzincir ağ ücretleri, Volet.com işlem komisyonundan ayrıdır.

İşlem komisyonunu elle hesaplamak yerine her zaman previewPayment() tarafından döndürülen tutarları kullanın.

Sözleşme parametreleri ve komisyon hesaplama ayrıntıları için Akıllı sözleşme referansı sayfasına bakın.

Entegrasyon kılavuzları​

Entegrasyonu tamamlamak için şu adımları izleyin:

  1. Ödeme akışını uygulayın. Müşteri cüzdanlarını bağlamak, akıllı sözleşmeleri yapılandırmak ve ödemeleri göndermek için Ethereum ve BNB Smart Chain kılavuzunu veya TRON kılavuzunu izleyin.
  2. Ödeme doğrulamasını uygulayın. Blokzincir işlemlerini siparişlerle eşleştirmek ve mükerrer teslimatı önlemek için Ödeme doğrulama ve sipariş takibi sayfasını izleyin.
  3. Entegrasyonunuzu test edin. Yayına almadan önce başarılı ve başarısız ödemeleri, token onaylarını, reddedilen işlemleri ve ödeme doğrulamasını test edin.

Ek kaynaklar:

Entegrasyon örnekleri​

Ağlara özel kılavuzlar, tarayıcıda açabileceğiniz veya indirebileceğiniz HTML örnekleri içerir:

  • EVM örneği (example-evm.html): Cüzdan bağlantısı, komisyon hesaplama, ETH, BNB ve USDT ödemeleri ile işlem takibi.
  • TRON örneği (example-tron.html): TronLink bağlantısı, komisyon hesaplama, TRX ve USDT ödemeleri ile işlem takibi.

Her kılavuz kendi örneğinin nasıl kullanılacağını açıklar.

Önemli: İki örnek de ana ağdaki (mainnet) sözleşmeleri kullanır. Cüzdanınızda onayladığınız her ödeme gerçek fon hareketidir. Ödemeleri test etmek için iki cüzdan gerekir: biri fon göndermek, diğeri almak için.

Demo sınırlamaları: Örnekler işlem geçmişini tarayıcının localStorage alanında saklar. Üretime hazır bir arka uç veya eksiksiz ödeme doğrulaması içermez. Gerçek müşteri ödemelerini kabul etmeden önce örnekleri uyarlayın ve test edin.

Yapay zekâ kodlama asistanıyla entegrasyon​

Volet.com akıllı sözleşme ödemelerini mevcut uygulamanıza entegre ederken bir yapay zekâ kodlama asistanından yardım alabilirsiniz.

Cüzdan bağlantılarını, ödeme işlemeyi, arka uç doğrulamasını, sipariş takibini ve testleri kapsayan kullanıma hazır entegrasyon istemimizi kullanın.

Yapay zekâ asistanınıza istemi, uygulamanızın kaynak kodunu ve ilgili entegrasyon kılavuzlarını verin.

Önemli: Gerçek ödemeleri işlemeden önce yapay zekânın ürettiği tüm kodu gözden geçirin ve test edin. Sözleşme adreslerini, ödeme doğrulama mantığını ve işlem yönetimini kontrol edin.