Özet
Toplu kripto ödemelerde her alıcı için ayrı bir ödeme emri oluşturun. POST /v1/withdrawals her çağrıda tek alıcı kabul eder; external_order_id değerini ödeme kaydıyla saklayın ve yeniden denemede aynı kimliği, aynı istek gövdesiyle kullanın. Kuyruktaki eşzamanlı istekleri sınırlayın; hesap genelinde paylaşılan saniyede 30 istek sınırını aşmayın. Kontrol panelinde yalnızca Production ortamında, aynı varlık ve ağ için tek seferde en fazla 50 alıcıya manuel gönderim yapılabilir. Paymos çekim komisyonu %0'dır; ayrıca sübvanse edilmiş ağ ücreti uygulanır.
Kripto para ile toplu ödeme dağıtımı, global iş modellerinde kullanılır. Yayıncılara ödeme yapan reklam ağları, kazanç ödemeleri yapan oyun siteleri ve uluslararası maaş ödeyen yazılım şirketleri alıcılarına ayrı transferler gönderir.
Blokzincirinde transferlerin geri alınamaz olması, sıralı nonce kuralları ve mempool açık artırmaları geleneksel banka dosya aktarımlarından çok daha dikkatli bir mühendislik gerektirir.
Sıralı Gönderimlerde Nonce Darboğazı
EVM ağlarında bir adresten çıkan her işlem ardışık bir numara (nonce: 0, 1, 2...) taşır. Önceki işlem gecikirse sonraki işlemler de bekleyebilir. Kendi RPC entegrasyonunuzda nonce sırasını ve bekleyen işlemleri izleyin; API istek sayısını tamamlanan zincir işlemi sayısıyla eş tutmayın.
Transactional Outbox Deseni
Transactional Outbox deseniyle kendi ödeme kaydınızı ve gönderim emrinizi aynı veritabanı işleminde saklayabilirsiniz. Her ödeme için tek bir external_order_id atayın ve ilk istekten önce kalıcı olarak kaydedin. Zaman aşımından sonra yeniden denerken aynı kimliği ve aynı istek gövdesini kullanın. İnceleme için webhook idempotency rehberimizi okuyabilirsiniz.
Çoklu Kasa Rotasyonu
API entegrasyonunda sıcak cüzdan sayısına göre kapasite hesabı yapmayın. Gönderim kuyruğunda eşzamanlı istek sayısını sınırlayın ve yeniden denemeler arasındaki beklemeyi artırın. Özel anahtar güvenliği hakkında sıcak cüzdan güvenliği içeriğimize göz atın.
Ağ Ücretleri: Ödeme Sübvansiyonu ve TRON Enerjisi
Paymos çekim komisyonu %0'dır. Yalnızca rotanın bildirilen ağ ücretini ödersiniz ve her ödeme rotası sübvanse edilir: zincirin aldığından daha az ödersiniz. Bir ödeme başarısız olursa veya iptal edilirse ayrılan tutarın tamamı ve ücret kullanılabilir bakiyeye döner.
TRON'da enerji ve diğer ağ kaynakları transfer maliyetini etkiler. Transfer başına sabit bir dolar maliyeti varsaymak yerine seçilen ödeme rotasının bildirilen ücretini esas alın. Ücretler için Paymos fiyatlandırma sayfasına, arka plan için TRON enerji kiralama yazımıza bakın.
Geliştiriciler için REST API Entegrasyonu
Backend'iniz Host-to-Host REST API üzerinden her alıcı için kimliği doğrulanmış bir POST /v1/withdrawals isteği gönderir. HMAC-SHA256 kimlik doğrulamasıyla bir Payout (rk_) anahtarı kullanın; hedef adreslerin normalde çekim beyaz listenizde olması gerekir. Örnekteki başlık değerleri yer tutucudur.
POST /v1/withdrawals HTTP/1.1
Host: api.paymos.io
Authorization: HMAC-SHA256 rk_live_<key_id>:<base64_signature>
X-Request-Timestamp: <current_unix_seconds>
Content-Type: application/json
{
"currency": "USDT",
"network": "TRC20",
"amount": "25.00",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"external_order_id": "payout_usr_101"
}
Yeni çekim HTTP 201 Created ve created durumuyla döner; aynı external_order_id ile yapılan yeniden deneme HTTP 200 OK ve mevcut çekimi döndürür. Örnekteki tutar ve ücretler temsilidir, tarife değildir:
{
"withdrawal_id": "wdr_7K2M9P4Q8R1X5Z3A0bC2dE",
"external_order_id": "payout_usr_101",
"status": "created",
"is_final": false,
"is_test": false,
"amount": "25.00",
"fee": "0.50",
"currency": "USDT",
"network": "TRC20",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"created_at": 1739277600
}
Standart saniyede 30 istek kotası hesabın tüm API çağrıları arasında paylaşılır. Worker eşzamanlılığını sınırlayın, yeniden denemelerde beklemeyi artırın ve HTTP 429 yanıtında Retry-After başlığına uyun; bu kota tamamlanan transfer hızını garanti etmez. Kontrol panelinde ayrıca yalnızca Production ortamında, aynı varlık ve ağ için tek seferde en fazla 50 alıcıya manuel gönderim yapılabilir.
Çekim tamamlandığında Paymos, sürümlü webhook zarfı içinde withdrawal.completed gönderir:
{
"event_id": "evt_CbYeOgBp9Kt2U3j74fxxLl",
"event_type": "withdrawal.completed",
"version": 1,
"occurred_at": 1739281200,
"data": {
"withdrawal_id": "wdr_7K2M9P4Q8R1X5Z3A0bC2dE",
"external_order_id": "payout_usr_101",
"status": "completed",
"is_final": true,
"is_test": false,
"amount": "25.00",
"fee": "0.50",
"currency": "USDT",
"network": "TRC20",
"destination_address": "TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9",
"tx_hash": "7f8a9b0c1d2e3f4a5b6c7d8e9f00112233445566778899aabbccddeeff001122",
"explorer_url": "https://tronscan.org/#/transaction/7f8a9b0c1d2e3f4a5b6c7d8e9f00112233445566778899aabbccddeeff001122",
"created_at": 1739277600,
"completed_at": 1739281200
}
}
Başarısız ödeme withdrawal.failed, iptal ise withdrawal.cancelled olayını üretir; iki durumda da ayrılan tutarın tamamı ve ücret kullanılabilir bakiyeye döner. Webhook imzalarını ham gövde üzerinden doğrulayın, teslimleri event_id ile tekilleştirin ve iş değişikliklerini teslim sırası varsaymadan data.withdrawal_id üzerinden uygulayın. withdrawal.completion_rewound geldiğinde tamamlanmış çekim signed durumuna döner; sonraki durum değişikliklerini takip edin.
Kripto çekim hızları ve SaaS çözümleri hakkında detaylı bilgi edinebilirsiniz.
| Mimari Model | Gönderim Birimi ve Sınır | Nonce Yönetimi | Ağ Maliyeti | En Uygun Alan |
|---|---|---|---|---|
| 1. Sıralı RPC Döngüsü | Ağ ve uygulamaya bağlı | Uygulama yönetir | Ağ ve kaynak kullanımına bağlı | Dahili testler, küçük projeler |
| 2. Panelden Manuel Dağıtım | Production; aynı varlık ve ağda en fazla 50 alıcı | Panelden ayrı nonce yönetimi gerekmez | Sübvanse ağ ücreti | Maaş dağıtımı, periyodik iş ortağı ödemeleri |
| 3. Otomatik API Outbox (POST /v1/withdrawals) | Tek alıcı / istek; hesap genelinde 30 istek / sn | API istemcisi nonce yönetmez | Sübvanse ağ ücreti; %0 Paymos komisyonu | Borsalar, iGaming, yüksek hacimli platformlar |
Sık sorulan sorular
Sıralı transferler yoğunluk altında neden tıkanır?
EVM ağlarında aynı gönderici adresinin işlemleri nonce sırasına göre yürütülür. Bir işlem beklemede kalırsa aynı adresten sonraki işlemler de bekleyebilir.
Ağ kopmalarında mükerrer ödemeler nasıl engellenir?
Her ödeme için external_order_id değerini saklayın. API zaman aşımına uğrarsa aynı kimlik ve aynı istek gövdesiyle yeniden deneyin; mevcut ödeme yeniden oluşturulmaz. Transactional Outbox deseni, kendi uygulamanızdaki ödeme kaydı ile gönderim kuyruğunu birlikte yönetmek için kullanılabilir.
Otomasyon ve paket işlemler transfer komisyonlarını nasıl düşürür?
Paymos çekim komisyonu %0'dır; ayrıca sübvanse edilmiş ağ ücreti uygulanır. Kontrol panelinde yalnızca Production ortamında, aynı varlık ve ağ için tek seferde en fazla 50 alıcıya manuel gönderim yapılabilir.
Alıcı adresi yaptırım veya AML listesindeyse ne olur?
Paymos, bir çekimi yönlendirmeden önce alıcı adresini TRM Labs, Binance AML, AMLBot, PureFi ve tarama sağlayıcısının veritabanında kontrol eder. Adres kontrolden geçemezse çekim gönderilmez ve failed durumuna geçer. Ayrılan tutarın tamamı ve ağ ücreti işletmenin kullanılabilir bakiyesine iade edilir.
kripto toplu ödeme API'lerinin ne zaman KULLANILMAMALI
- Az sayıda transfer yapıyorsanız ve Production ortamında kontrol panelinden manuel gönderim ihtiyacınızı karşılıyorsa.
- Manuel emanet denetimi gerektiren likit olmayan tokenler için.
- Altyapınız Transactional Outbox desenini desteklemiyorsa.
- Uyum politikanız tutardan bağımsız olarak her giden işlemin iki kişi tarafından onaylanmasını gerektiriyorsa: Paymos'ta çok kişili onay zinciri yoktur, bu nedenle API'yi çağırmadan önce bu adımı kendi arka ofisinizde kurun.
Kaynaklar
Son gözden geçirme: 7 Kas 2026


