Özet
Statik bir kripto cüzdanı, bir müşteriye birden fazla ödeme boyunca değişmeyen kalıcı bir zincir üstü yatırma adresi atar. Ödeme penceresi olan ve bu pencere kapanınca süresi dolan dinamik faturaların aksine, kalıcı ödeme kanalları kullanıcıların yeni bir ödeme oturumu açmadan asgari yatırma tutarı (minimum_deposit) ve üzerindeki tekrarlayan transferleri göndermesine olanak tanır. Gelen her transfer AML taramasından geçer; onaylandıktan sonra üye işyeri bakiyesine kaydedilir ve webhook ile bildirilir.
Geleneksel e-ticarette kripto para ödemeleri genellikle dinamik faturalar üzerinden yürütülür: kullanıcı bir sipariş oluşturur, geri sayım sayacı olan bir karekod görür, tam tutarı transfer eder. Bu model tek seferlik alışverişler için uygundur ancak abonelik, SaaS veya bakiye yükleme gerektiren platformlarda ciddi bir sürtünme yaratır.
SaaS platformları, iGaming işletmeleri ve kripto borsaları için statik cüzdanlar (ödeme kanalları) endüstri standardıdır. Her kullanıcıya, tıpkı kişisel bir banka hesap numarası gibi, dilediği zaman para yatırabileceği kalıcı bir kripto adresi tahsis edilir.
Statik Kripto Cüzdanı Nedir?
Statik kripto cüzdanı, bir kullanıcının kimliğine kalıcı olarak atanan ve süresi dolmayan bir zincir üstü yatırma adresidir. Müşteri her bakiye yüklemesinde yeni bir ödeme sayfası açmak zorunda kalmaz; adresi kişisel cüzdanına veya borsa rehberine kaydederek istediği zaman para gönderebilir.
Öne çıkan avantajlar:
- Süresi Dolmaz: Adres ömür boyu geçerlidir (açıkça bloke edilene kadar).
- Esnek Tutar: Her token ve ağ için asgari yatırma tutarına (
minimum_deposit) eşit veya daha yüksek tutarlar gönderilebilir. - Otomatik Tanıma: Gelen transfer zincir üstünde görüldüğü anda taranır. Transfer onaylanıp taramadan geçtikten sonra yatırma webhook'u sunucunuza ulaşır.
Geliştirici entegrasyonu hakkında ayrıntılı bilgi için Host-to-Host REST API dokümantasyonunu inceleyin.
Ödeme Kanalları ile Dinamik Faturaların Farkı
Temel mimari fark, adresin neye bağlandığıdır: dinamik fatura tek bir siparişe ve süreye bağlanırken, ödeme kanalı doğrudan müşteri hesabına bağlanır.
Düzenli müşterisi olan işletmelerde statik cüzdanlar, tekrarlayan yatırmalardan ödeme sayfası adımını çıkarır: kullanıcı adresi bir kez kopyalar, sonra doğrudan kendi cüzdanından veya borsa hesabından gönderir. Maliyet yapıları hakkında daha fazla bilgi edinmek için kripto işlem komisyonlarını kimin ödediğini anlatan kılavuzumuzu okuyabilirsiniz.
Çoklu Ağ Desteği: TRC-20, ERC-20 ve TON
Kurumsal ödeme altyapıları, müşteriye tek bir hesap altında birden fazla blokzincir ağı için statik adres sunar. Müşteriler USDT ve diğer stablecoin'leri Tron (TRC-20), Ethereum (ERC-20) ve TON gibi farklı ağlarda tutar; bu yüzden para yatırma kabul eden bir platform, kullanıcı muhasebesini bölmeden çoğu zaman birkaç ağda adrese ihtiyaç duyar.
Bir kanal oluşturduğunuzda Paymos desteklediği ağlar için yatırma adreslerini hazırlar; bunlar arasında Arbitrum, BSC ve Polygon da vardır (Base ağı Paymos'ta yalnızca USDC desteklemektedir). Hazırlık biraz zaman alır, bu yüzden bir adresi ancak kanal onu hazır olarak bildirdiğinde gösterin (aşağıdaki API bölümüne bakın).
Müşteri hangi ağdan gönderirse göndersin, onaylanan yatırma o varlık cinsinden üye işyeri bakiyesine kaydedilir. Yatırma almak için sunucunuzun her zincirde gaz tutmasına veya kendi zincir altyapısını işletmesine gerek yoktur.
REST API Entegrasyonu
Statik adres altyapısını kurmak iki temel adımdan oluşur: kanalın açılması ve gelen ödeme webhooklarının dinlenmesi.
1. Müşteriye Özel Kanal Açma
İsteği bir Payment API anahtarıyla HMAC-SHA256 şemasına göre imzalayın. Yer tutucular anahtar kimliğini, güncel Unix zaman damgasını ve timestamp\nMETHOD\npath\nquery\nbodyHash metninin Base64 imzasını gösterir. bodyHash, isteğin tam gövdesinin küçük harfli onaltılık SHA-256 özetidir. Alanları LF satır sonlarıyla ayırın.
POST /v1/payment-channels HTTP/1.1
Host: api.paymos.io
Authorization: HMAC-SHA256 {api_key_id}:{base64_signature}
X-Request-Timestamp: {unix_seconds}
Content-Type: application/json
{
"project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
"external_id": "usr_991824"
}
İlk istek HTTP 201 Created döndürür; aynı ortamda aynı project_id ve external_id ile yapılan tekrar HTTP 200 OK ile mevcut kanalı getirir. Production ortamında yeni kanal provisioning durumunda, henüz adres olmadan açılır:
{
"id": "pc_2QhKZv6mRt9WdA3nYpLbXf",
"project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
"external_id": "usr_991824",
"status": "provisioning",
"is_accepting_payments": false,
"is_fully_provisioned": false,
"is_test": false,
"applied_fee_percent": 1,
"customer_fee_percent": 0,
"networks": [
{
"network": "TRC20",
"status": "provisioning",
"tokens": [
{
"symbol": "USDT",
"minimum_deposit": "1.00"
}
]
}
],
"created_at": 1767225600,
"updated_at": 1767225600
}
Hazırlık sürerken GET /v1/payment-channels/{id} ile kanalı okuyun. Bir ağın adresini yalnızca is_accepting_payments değeri true olduğunda, o ağ active durumundayken ve tokens dizisi boş değilken gösterin. Her token'ın güncel minimum_deposit değerini adresin yanında gösterin ve göndermeden önce kontrol edin; örnekteki asgari tutar yalnızca örnektir. Değer yoksa veya null ise güncel bir tutar verilmesini bekleyin. Sınırın altındaki transferler kanala kaydedilmez ve otomatik olarak iade edilmez. Ayrıntılar için kanal bilgilerine bakın.
2. Gelen Ödeme Webhook Bildirimi
Yatırma taramadan geçip gerekli ağ onaylarına ulaştıktan sonra payment_channel.deposit.confirmed webhook'u tamamlanan yatırmayı bildirir:
{
"event_id": "evt_J7EEYeL9pZJukfj2c5OQ44",
"event_type": "payment_channel.deposit.confirmed",
"version": 1,
"occurred_at": 1767225930,
"data": {
"id": "pcd_8ScRvL4jNq2XkB7mTfZdWu",
"payment_channel_id": "pc_2QhKZv6mRt9WdA3nYpLbXf",
"project_id": "prj_xFukZuAJZR06pLVBh3uwzv",
"payment_channel_external_id": "usr_991824",
"status": "confirmed",
"is_final": true,
"is_test": false,
"currency": "USDT",
"network": "TRC20",
"chain_id": 728126428,
"contract_address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
"gross": "100",
"fee": "1",
"net": "99",
"applied_fee_percent": 1,
"customer_fee_percent": 0,
"tx_hash": "9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25",
"transfer_id": "9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25:41a614f803b6fd780986a42c78ec9c7f77e6ded13c:41c9f6a2b7d0138e54ca3b91f6072ed48a5c1e93b7:0",
"source_address": "TQiBwkXtUUNygicvHJVVDCDKyVFr2YNTey",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"block_height": 68421905,
"first_included_block_timestamp": 1767225900,
"explorer_url": "https://tronscan.org/#/transaction/9f4c1b7e30ad52c8ef6a1d84b0c39f27a5e6d138f4b90c72ae51d63b8407fc25",
"created_at": 1767225870,
"updated_at": 1767225930,
"confirmed_at": 1767225930
}
}
Webhook doğrulama kılavuzuna göre imzayı ham istek gövdesi üzerinden doğrulayın. data.net tutarını tek bir veritabanı işlemiyle, her data.id (pcd_…) için yalnızca bir kez hesaba ekleyin; yinelenen teslimatları event_id ile takip edin. Webhook idempotency kuralları ayrıntıları açıklar.
Gelen Transferlerin AML Taraması
Statik adresler rastgele üçüncü taraflardan transfer alabildiği için gelen transferlerin otomatik taranması önemlidir. Gelen bir transfer zincir üstünde görüldüğü anda Paymos gönderen adresi (KYT) şu kaynaklarla tarar: TRM Labs, Binance AML, AMLBot, PureFi ve tarama sağlayıcısının veritabanı. Sonuç temizse yatırma normal şekilde onaylanır ve bakiyeye kaydedilir. Tarama başarısız olursa veya sonuç dönmezse yatırma Held for review durumuna alınır: bakiyeye hiçbir şey kaydedilmez, onay webhook'u gönderilmez ve üye işyeri panelde bildirim alır.
Tarama, üye işyeri olarak sizin kendi AML ve yaptırım yükümlülüklerinizin yerini tutmaz; bekletilen bir yatırmanın serbest bırakılması da garanti değildir.
Ağ Ücretleri ve Bakiye Toplama: Yatırmaları Toplamanın Maliyetini Kim Öder?
Yatırmayı göndermenin ağ ücretini müşterinin cüzdanı öder. Yatırmaların kabulü ve toplanmasının ağ maliyetini Paymos karşılar ve üye işyerine ayrı bir transfer veya toplama (sweep) komisyonu eklemez. Ağ ücretlerini her zincir kendisi belirler ve yoğunluğa göre değişir, bu yüzden sabit bir tutar yoktur.
Toplamayı kendiniz kurarsanız her adres kendi toplama transferinin ücretini ödemek zorundadır; çok küçük bir yatırmayı toplamak, yatırmanın değerinden pahalıya gelebilir. Paymos'ta her rota güncel bir minimum_deposit uygular ve bu tutarın altındaki transfer kanala kaydedilmez. Tüm fiyatlandırma detaylarını fiyat sayfamızda bulabilirsiniz.
| Özellik | Statik Cüzdan (Kanal) | Dinamik Fatura |
|---|---|---|
| Adres Geçerlilik Süresi | Kalıcı (süresiz kullanım) | Geri sayımlı ödeme penceresi |
| Beklenen Tutar | Asgari tutar ve üzeri (minimum_deposit) | Sabit sipariş tutarı; kur, ödeyen varlığı ve ağı onayladığında sabitlenir |
| Temel Kullanım Alanı | SaaS bakiyeleri, iGaming, borsalar | E-ticaret sepetleri, tek seferlik alışverişler |
| Webhook Döngüsü | payment_channel.deposit.confirmed | invoice.paid / invoice.expired |
| Adres Üretimi | Kayıt başına bir kez | Fatura başına bir kez, ödeyen varlığı ve ağı onayladığında |
| Ödeme Kabulünün Ağ Maliyeti | Paymos karşılar | Paymos karşılar |
Sık sorulan sorular
Statik cüzdan ile dinamik kripto faturası arasındaki fark nedir?
Dinamik fatura tek bir sipariş için, sabit tutar ve bir ödeme penceresiyle oluşturulur; pencere kapanınca süresi dolar. Statik cüzdan (ödeme kanalı) ise kullanıcı hesabına ödeme penceresi olmayan, tekrar kullanılabilir bir adres tahsis eder. Bu adrese gönderilen tutar, ilgili token ve ağ için asgari yatırma tutarına (minimum_deposit) eşit veya daha yüksek olmalıdır.
Müşteri aynı statik cüzdana farklı ağlardan USDT gönderebilir mi?
Evet, ödeme altyapısı çoklu ağ yönlendirmesini destekliyorsa mümkündür. Kalıcı bir ödeme kanalı, aynı müşteri kimliğine (external_id) bağlı olarak Tron (TRC-20), Ethereum (ERC-20), BSC ve TON ağlarında benzersiz yatırma adresleri oluşturur.
Sistem hangi müşterinin para yatırdığını nasıl anlar?
Her statik adres, oluşturulduğu anda üye işyerinin sistemindeki müşteri kimliğiyle (external_id) eşleştirilir. İşlem ağda onaylandığında webhook bu kimliği sunucunuza iletir.
Asgari tutarın altında bir ödeme gelirse ne olur?
minimum_deposit her token ve ağ için güncel olarak verilir. Göndermeden önce kontrol edin: sınırın altındaki transferler kanala kaydedilmez ve otomatik olarak iade edilmez. Değer yoksa veya null ise güncel bir tutar verilmesini bekleyin.
Paymos statik cüzdanları emanet tabanlı (custodial) mıdır?
Evet. Ödeme kanallarının imzalama anahtarlarını Paymos saklar. Onaylanan transferler üye işyerinin Paymos'taki bakiyesine kaydedilir.
statik kripto cüzdanlarının ne zaman KULLANILMAMALI
- Stok rezervasyonu gerektiren fiziksel e-ticaret sitelerinde — geri sayımlı dinamik kripto faturaları tercih edin.
- Kayıtsız misafir siparişlerinde birebir kesin sipariş eşleşmesi gerekiyorsa.
- Sunucunuzda asenkron webhook dinleyicisi bulunmuyorsa.
- İş modeliniz kesin UTXO gizliliği için sıfır adres tekrarı gerektiriyorsa.
Kaynaklar
Son gözden geçirme: 7 Kas 2026


