Hazırlayan
Temorya Sistem Mimarı
29.05.2026
Okuma önerisi
3 dakikalık rehber
Adımları sırayla uygulayın ve kritik değişikliklerden önce yedek alın.
Kripto Ödeme Entegrasyonu (Bitcoin, USDT TRC20)
Merkeziyetsiz kripto para ödemelerini otomatik onaylama. Bu rehber, işlemi tek bir sihirli komuta indirgemeden; hazırlık, kontrollü değişiklik, doğrulama ve geri dönüş adımlarıyla ele alır.
Bu rehberin odağı: finansal işlem bütünlüğü. Ödeme ve e-ticaret akışlarında tutar, para birimi, sipariş kimliği ve sağlayıcı bildirimi aynı işlem kaydında uzlaştırılmalıdır.
Ön kontrol listesi
- Sandbox/canlı ortamı, mağaza anahtarını, callback adresini, para birimini ve sipariş durum modelini kaydedin.
- Tutar, para birimi, sipariş ve sağlayıcı ortamını sunucu tarafında doğrulayın.
- Sağlayıcı imzası doğrulanmadan sipariş, bakiye veya lisans durumunu değiştirmeyin.
Uygulama sırası
- Kapsamı sabitleyin: Yalnız bu makalenin hedeflediği hesap, alan adı, servis veya işlem kaydı üzerinde çalışın.
- Başlangıç durumunu kaydedin: Sandbox/canlı ortamı, mağaza anahtarını, callback adresini, para birimini ve sipariş durum modelini kaydedin.
- Tek değişiklik uygulayın: İşlemi idempotency anahtarıyla gönderin; kart verisini uygulama sunucusunda saklamayın veya günlüklemeyin.
- Kanıtı toplayın: işlem kimliği, imza, sipariş günlüğü ve uzlaştırma sonucu bilgilerini işlem kaydına ekleyin.
- Kabul veya geri dönüş kararı verin: Kabul kriteri sağlanmıyorsa yeni değişiklik eklemek yerine geri dönüş adımını uygulayın.
Karar ve kanıt tablosu
| Aşama | Sorulacak soru | Beklenen kanıt |
|---|---|---|
| Hazırlık | Doğru hedef ve yetki belirlendi mi? | Envanter ve başlangıç değeri |
| Uygulama | Tek ve izlenebilir değişiklik mi yapıldı? | Değişiklik zamanı ve işlem kaydı |
| Doğrulama | Kritik görev gerçek koşulda çalışıyor mu? | işlem kimliği, imza, sipariş günlüğü ve uzlaştırma sonucu |
| Geri dönüş | Kabul kriteri sağlanmadığında dönüş yolu hazır mı? | Finansal kaydı silmeyin; ters kayıt veya sağlayıcı iade akışını kullanın. |
Hata ve geri dönüş kontrolü
- Başarılı, başarısız, iptal, zaman aşımı ve yinelenen webhook senaryolarını test siparişiyle doğrulayın.
- Hata ve uyarı günlüklerini değişiklik öncesi zaman aralığıyla karşılaştırın.
- Sonucu yalnız ekranda görünmesine göre değil, gerçek kullanıcı göreviyle doğrulayın.
Sık karşılaşılan hatalar
- Frontend başarı dönüşünü tek doğruluk kaynağı kabul etmek
- Frontend dönüşünü tek ödeme kanıtı saymak
- Mükerrer webhooku ikinci kez işlemek
- Tutar ve para birimini sunucu tarafında yeniden doğrulamamak
Geri dönüş ve destek sınırı
Geri dönüş: Finansal kaydı silmeyin; ters kayıt veya sağlayıcı iade akışını kullanın.
Uzman desteği: Canlı tahsilat, chargeback, vergi veya sağlayıcı uzlaştırma farkı varsa finansal işlem kaydını koruyarak destek alın.
İşlem sonunda gizli anahtar, parola, kişisel veri veya tam sunucu günlüğü paylaşmayın; destek kaydına yalnız gerekli ve maskelenmiş kanıtı ekleyin.
Bu rehber yardımcı oldu mu?
Geri bildiriminiz içerikleri daha anlaşılır ve güncel tutmamıza yardımcı olur.