Ana içeriğe geç

Akıllı sözleşme entegrasyonu

Tipik bir emanetçi olmayan ödeme entegrasyonu üç bileşenden oluşur:

  • Uygulamanız
  • Bir cüzdan bağlantı sağlayıcısı
  • Ödeme akıllı sözleşmesi

Cüzdan bağlantı sağlayıcısı yalnızca müşterinin cüzdanını bağlamaktan ve işlem imzası istemekten sorumludur. Ödemenin kendisi blokzincir üzerindeki akıllı sözleşme tarafından gerçekleştirilir.

ipucu

Entegrasyona başlamadan önce ekibimizle iletişime geçin. Gerekli akıllı sözleşme bilgilerini ve ABI'yi sağlar, uygulamanız için uygun mimariyi seçmenize yardımcı oluruz.

Ödeme akışı​

  1. Müşteri ödeme sayfanıza gelir.
  2. Müşteri cüzdanını bağlar.
  3. Uygulamanız bir ödeme işlemi hazırlar.
  4. İşlem bağlı cüzdana gönderilir.
  5. Müşteri işlemi inceler ve imzalar.
  6. Cüzdan imzalı işlemi blokzincire yayınlar.
  7. Akıllı sözleşme fonları aktarır.
  8. Cüzdan bir işlem hash'i (txid) alır ve uygulamanıza iletir.
  9. Uygulamanız işlemi gerekli onay durumuna ulaşana kadar izler.
  10. Sisteminiz siparişi ödendi olarak işaretler.

Ön koşullar​

Entegrasyondan önce şunlara ihtiyacınız vardır:

  • Kripto cüzdanları bağlayabilen bir ön uç (frontend) uygulaması.
  • Ödeme talepleri oluşturmak ve blokzincir işlemlerini izlemek için bir arka uç (önerilir).
  • Volet.com tarafından sağlanan akıllı sözleşme bilgileri.
  • Desteklemeyi planladığınız blokzincir ağlarına uygun bir cüzdan bağlantı sağlayıcısı.

Tek seferlik kurulum​

Adım 1. Cüzdan bağlantısını kurun​

Desteklemeyi planladığınız blokzincir ağlarına uygun bir cüzdan bağlantı sağlayıcısını entegre edin.

Tipik seçenekler:

  • WalletConnect — Ethereum, BNB Chain, Polygon, Arbitrum, Optimism, Avalanche ve EVM uyumlu diğer ağlar.
  • TronLink — Tron.
  • TON Connect — TON.
  • Solana Wallet Adapter — Solana.

WalletConnect gibi bazı sağlayıcılar kullanılmadan önce bir Project ID veya API kimlik bilgileri gerektirir.

Adım 2. Akıllı sözleşme bilgilerini alın​

Akıllı sözleşme adresini, ABI'yi ve entegrasyona özgü parametreleri almak için Volet.com ile iletişime geçin.

Ödeme akışının uygulanması​

Adım 1. Müşterinin cüzdanını bağlayın​

Müşteriden uyumlu bir cüzdan bağlamasını isteyin.

Örneğin:

  • WalletConnect üzerinden MetaMask veya Trust Wallet.
  • Tron için TronLink.
  • TON Connect üzerinden Tonkeeper.
  • Solana Wallet Adapter üzerinden Phantom veya Solflare.

Adım 2. İşlemi hazırlayın​

Uygulamanızda bir işlem talebi hazırlayın.

Genellikle şunları içerir:

  • Alıcı cüzdan adresi
  • Ödeme tutarı
  • Token
  • Blokzincir ağı (chainId)
  • Sipariş kimliği
  • İsteğe bağlı meta veriler

İşlem ön uçta veya arka uçta hazırlanabilir.

Adım 3. İşlem imzası isteyin​

Hazırlanan işlemi bağlı cüzdana gönderin.

Cüzdan, belirtilen chainId değerine göre uygun blokzincir ağını ve RPC uç noktasını otomatik olarak seçer.

Müşteri işlem ayrıntılarını inceler.

Her şey doğruysa işlemi cüzdanında imzalar.

Adım 4. İşlemi yayınlayın​

İşlem imzalandıktan sonra cüzdan onu uygun RPC uç noktası üzerinden blokzincire yayınlar.

İşlem ağ tarafından kabul edilirse cüzdan bir işlem hash'i (txid) alır ve uygulamanıza iletir.

İşlem hash'ini siparişinizle birlikte saklayın.

Adım 5. İşlem onaylarını doğrulayın​

Ödeme gerekli onay durumuna ulaşana kadar işlem hash'ini kullanarak blokzinciri izleyin.

İşlem yeterli onaya ulaştığında siparişi sisteminizde ödendi olarak işaretleyin.

RPC sağlayıcıları​

Müşteri cüzdanları işlemin chainId değerine göre RPC uç noktasını otomatik seçer; bu nedenle temel entegrasyonlarda ek yapılandırma gerekmez.

Uygulamanız çok sayıda blokzincir isteği yapıyorsa (örneğin ödeme işlemlerini izlemek veya blokzincir verilerini büyük ölçekte sorgulamak için) şunları kullanmayı düşünün:

  • Özel bir RPC sağlayıcısı.
  • Kendi RPC düğümünüz.

Özel altyapı, herkese açık RPC istek sınırlarından kaçınmanıza yardımcı olur ve yoğun yük altında güvenilirliği artırır.

Sırada ne var​

  • Akıllı sözleşme referansını inceleyin.
  • Başarılı ve başarısız ödeme senaryolarını test edin.
  • İşlem onaylarının işlenmesini doğrulayın.
  • Canlı ortama dağıtın.