Tanıtım
Bir ödemenin şekli
InfraIO Pay’i entegre eden bir satıcı, dört hareketli parçayla ilgilenir:
Checkout oturumu
Sunucu tarafında, line item’lar ve toplamlarla bir oturum oluşturursunuz.
Yanıt, bir session_key (cst_…) ve bir checkout_url içerir. Oturumlar
TTL’lidir (varsayılan 30 dk) ve tek kullanımlıktır.
Barındırılan checkout sayfası
Tarayıcı SDK’mızı yükler ve oturumu açarsınız — popup, yönlendirme veya gömülü iframe. Alıcı bir zincir × varlık seçer (Polygon üzerinde USDT, Base üzerinde ETH, …), oluşturulan bir depozito adresi + QR görür ve cüzdanından fon gönderir.
Ödeme onayı
payment-service, oturumun depozito adresine eşleşen zincir üstü gelen
transferleri ilgili zincir üzerinde izler. Yapılandırılmış onay sayısı için
temizlendiğinde (örn. Ethereum mainnet’te 12, Polygon’da 5 — bkz.
Zincirler ve varlıklar), temel PaymentIntent SETTLED
durumuna geçer ve üst Order PAID durumuna geçer.
Webhook
Kayıtlı webhook URL’nize imzalı bir payment.settled event’i POST ederiz.
Sunucunuz imzayı doğrular, external_ref üzerinden kendi siparişinize geri
bağlanır ve siparişi karşılar.
Bir diyagramda veri modeli
CheckoutSession ← 1:1 → Order ← 1:N → PaymentIntent
(TTL'li) (kalıcı) (her ödeme denemesi için bir adet)Sipariş karşılama için Order’ları düşünür, ödeme almak için Session oluşturur ve sistem, arka planda yeniden denemeler / zincir seçimi için PaymentIntent’leri yönetir.
Biz neyi hallederiz, siz neyi halledersiniz
| InfraIO Pay halleder | Siz hallediyorsunuz |
|---|---|
| Barındırılan checkout arayüzü (depozito adresi, QR, varlık seçici) | Veritabanınızda katalog + Order oluşturma |
| 8 EVM zinciri arasında zincir izleme + onay mantığı | Webhook alıcısı + imza doğrulama |
| Çoklu varlık checkout (USDT, USDC, zincir başına yerel ETH/BNB/POL/MNT) | order_id’mizi external_ref üzerinden kendi sipariş ID’nizle eşleştirme |
| İade muhasebesi (durum makinesi, panel, API) | Zincir üstü iade tx’ini imzalama + yayma |
| Test modu anahtarları + izole test webhook’ları | Faucet’lerden testnet cüzdanlarını fonlama |
Satıcı fonlarının saklamasını yapmıyoruz. Alıcıdan satıcıya transferler zincir üstünde doğrudan gerçekleşir; biz transferin temizlendiğini size bildiren indeksleyici + mutabakat katmanıyız.
Test modu ve canlı mod karşılaştırması
Her hesap test modunda başlar. Test anahtarları pk_test_ / sk_test_
ön ekine sahiptir. Canlı anahtarlar (pk_live_ / sk_live_) şunlara
bağlıdır:
- KYB tamamlama
- Treasury cüzdan onayı (almak istediğiniz her zincir üzerinde hedef cüzdanı kontrol ettiğinizi kanıtlayan bir mesajı imzalarsınız)
Aynı API ana URL’si her ikisine de hizmet eder — ortam URL ile değil, anahtar öneki ile belirlenir. Test modu gerçek testnet’lere karşı çalışır (Sepolia, Base Sepolia, BSC Testnet, vb.) — mock chain yoktur. Test ödemesi tetiklemek için bir faucet’ten gerçek testnet fonlarına ihtiyacınız vardır.
InfraIO Pay neler değildir
- Saklama hizmeti değildir. Fonlar zincir üstünde doğrudan alıcı → satıcı cüzdanı arasında akar. Bakiyeyi asla biz tutmayız.
- Bir cüzdan sağlayıcısı değildir. Müşteriler kendi cüzdanlarını getirir; barındırılan checkout’ta yerleşik bir WalletConnect seçeneği vardır ama yerel bir saklama hizmeti yoktur.
- Bir fiat geçidi değildir. Alıcılar sahip oldukları kripto varlıkla öder; dönüşüm yapmıyoruz.
- Bugün bir Tron veya Solana geçidi değildir. EVM önceliklidir. Canlı matris için bkz. Zincirler ve varlıklar.
Sırada ne var
- Hızlı başlangıç — ilk entegrasyonunuzu ~10 dakikada kopyala-yapıştır.
- Kavramlar → Oturumlar — veri modelini ayrıntılı olarak.
- SDK → JavaScript — bugün yayımlanan tek SDK.