Akıllı sözleşme ödemelerinde sorun giderme
Bu kılavuz, Ethereum, BNB Smart Chain ve TRON'da Volet.com akıllı sözleşmeleriyle emanetçi olmayan ödemeleri kabul ederken sık karşılaşılan sorunları çözmenize yardımcı olur.
Sorununuzu aşağıda bulun ve önerilen adımları izleyin. Sözleşme adresleri, parametreler ve hata tanımları için Akıllı sözleşme referansı sayfasına bakın.
Cüzdan ve ağ sorunları
| Sorun | Olası neden | Çözüm |
|---|---|---|
| Cüzdan bağlantısı reddedildi | Müşteri isteği reddetti veya cüzdan kilitli | Müşteriden cüzdanının kilidini açıp yeniden bağlanmasını isteyin |
| MetaMask algılanmadı | Uyumlu bir tarayıcı cüzdanı yüklü veya kullanılabilir değil | MetaMask'i yükleyin veya WalletConnect destekleyen bir cüzdanla bağlanın |
| Yanlış EVM ağı | Cüzdan, ödeme sırasında seçilenden farklı bir ağa bağlı | Ağ değişikliği isteyin ve chain ID'yi doğrulayın |
| WalletConnect bağlantısı başarısız | Geçersiz Project ID, hatalı yapılandırma veya desteklenmeyen cüzdan ya da ağ | Reown proje yapılandırmasını ve desteklenen ağları kontrol edin |
| TronLink algılanmadı | Uzantı yüklü, etkin veya kilidi açık değil | TronLink'i yükleyin veya kilidini açın ve sayfayı yenileyin |
| Yanlış TRON ağı | Cüzdan bir test ağına veya beklenmeyen bir ağa bağlı | TRON Mainnet'e geçin ve etkin ağı doğrulayın |
Ödeme başlatmadan önce, özellikle cüzdan bağlantısından veya ağ değişikliğinden sonra, cüzdan adresini ve seçilen ağı her zaman yeniden doğrulayın.
USDT onay sorunları
USDT ödemelerinde, işlemci sözleşmesinin token aktarabilmesi için önce bir onay işlemi gerekebilir.
| Sorun | Olası neden | Çözüm |
|---|---|---|
| Onay işlemi reddedildi | Müşteri cüzdanındaki isteği reddetti | Müşterinin onayı yeniden denemesine izin verin |
| Yetersiz harcama izni (allowance) | İşlemcinin gereken tutarı harcama yetkisi yok | allowance() değerini kontrol edin ve gereken tutar için onay isteyin |
| Ethereum'da USDT onayı başarısız | Sıfır olmayan mevcut bir izin, doğrudan sıfır olmayan başka bir tutara değiştirilemez | 0 onaylayın, onaylanmasını bekleyin, ardından gereken tutarı onaylayın |
| Yetersiz USDT bakiyesi | Müşterinin toplam ödeme için yeterli token'ı yok | balanceOf() değerini previewPayment().totalPay ile karşılaştırın |
| Onay başarılı ama ödeme beklemede | Onay tamamlandı, ancak ödeme işlemi gönderilmedi veya doğrulanmadı | Mevcut izni kontrol edin, ardından ayrı ödeme işlemini başlatın veya doğrulayın |
Önemli: Başarılı bir approve() işlemi tamamlanmış bir ödeme değildir. Sipariş ödemesini doğrulamak için yalnızca işlemci sözleşmesinin transfer() işlemi kullanılabilir.
İşlem ve sözleşme hataları
| Hata veya sorun | Olası neden | Çözüm |
|---|---|---|
InvalidTotalAmountValidation | Yerel value veya callValue, beklenen toplam ödeme tutarıyla eşleşmiyor | previewPayment() fonksiyonunu yeniden çağırın ve döndürülen totalPay değerini gönderin |
SellerIsBuyer | Alıcının ve üye işyerinin cüzdan adresleri aynı | Üye işyerinin alıcı cüzdanının, bağlı alıcı cüzdanından farklı olduğunu kontrol edin |
SellerZeroAddress | Üye işyerinin alıcı adresi sıfır adres | Geçerli bir üye işyeri cüzdanı yapılandırın |
AmountIsZero | Ödeme tutarı sıfır | İşlemi göndermeden önce sipariş tutarını doğrulayın |
CommissionExceedsAmount | İşlem komisyonu talep edilen tutardan düşülemiyor | Sipariş tutarını ve komisyon ayarını gözden geçirin |
SellerNotWhitelisted | Üye işyerinin alıcı cüzdanı işlemci tarafından yetkilendirilmemiş | Cüzdanın yetkisini kontrol etmek için Volet.com ile iletişime geçin |
EnforcedPause | Sözleşmede ödeme işleme duraklatılmış | Bu işlemci üzerinden ödeme göndermeyi durdurun ve Volet.com ile iletişime geçin |
| Token aktarımı başarısız | Yetersiz token bakiyesi, yetersiz izin veya token'a özgü kısıtlamalar | Token sözleşmesini, bakiyeyi, izni ve seçilen ağı doğrulayın |
| Yetersiz gas | Müşterinin ağ ücretleri için yeterli ETH veya BNB'si yok | Müşteriden yeterli yerel coin bakiyesi tutmasını isteyin |
| Yetersiz TRON kaynakları | Müşterinin Energy, Bandwidth veya kullanılabilir TRX'i yetersiz | Kaynak gereksinimlerini ve kullanılabilir TRX'i gözden geçirin |
TRON OUT_OF_ENERGY | Sözleşme yürütmesi kullanılabilir Energy'yi veya yapılandırılan ücret limitini tüketti | Kaynak tüketimini tahmin edin ve işlemin feeLimit değerini gözden geçirin |
TronGrid HTTP 429 | API istek limiti aşıldı | Sunucu tarafında bir API anahtarı kullanın ve istekleri artan bekleme süreleriyle yeniden deneyin |
Sözleşme hataları dağıtılan işlemciye bağlıdır. Hata tanımları için Akıllı sözleşme referansı sayfasına bakın.
Ödeme beklemede kalıyor
Müşteri bir işlem gönderdikten sonra bile sipariş beklemede kalabilir.
| Durum | Neyi kontrol etmeli | Önerilen işlem |
|---|---|---|
| İşlem hash'i döndü ama makbuz yok | İşlem henüz bir bloğa eklenmemiş olabilir | Aynı txid değerini kontrol etmeye devam edin |
| İşlem yürütüldü ama kesinleşmedi | Gereken ağ kesinliğine henüz ulaşılmadı | Siparişi tamamlamadan önce kesinleşmeyi bekleyin |
| USDT onayı doğrulandı ama ödeme bulunamadı | Yalnızca onay işlemi gönderildi | Ayrı bir ödeme işlemi olup olmadığını kontrol edin |
| İşlem başarılı ama sipariş hâlâ beklemede | Ödeme ayrıntıları siparişle eşleşmiyor olabilir veya arka uç doğrulaması tamamlanmamış olabilir | İşlemciyi, varlığı, alıcıyı, tutarı ve sözleşme çağrısını siparişle karşılaştırın |
| TRON işlemi görünüyor ama solidified değil | İşlem henüz SolidityNode verilerinde görünmüyor | İşlemin solidified makbuzunu kontrol etmeye devam edin |
| RPC isteği başarısız oluyor veya zaman aşımına uğruyor | Sağlayıcı geçici olarak kullanılamıyor | İşlemi başarısız olarak işaretlemeden doğrulamayı yeniden deneyin |
| Müşteri ödeme sayfasını kapattı veya yeniledi | Tarayıcı oturumu ödeme onayından önce sona erdi | Doğrulamaya arka uçtaki mutabakat işleyicisi üzerinden devam edin |
| Ödeme süresi onaydan önce doldu | İşlem, ödeme süresi kapandıktan sonra onaylanabilir | Gönderilen ödeme denemelerini izlemeye devam edin ve geç gelen ödemelerin mutabakatını yapın |
İşlem başarılı ama sipariş ödendi olarak işaretlenmedi
Blokzincirde başarılı bir işlem, doğru siparişin ödendiği anlamına gelmeyebilir.
Arka ucunuz şunları doğrulamalıdır:
- İşlemin beklenen işlemci sözleşmesini kullandığı.
- Varlığın ve üye işyerinin alıcı cüzdanının siparişle eşleştiği.
- Ödeme tutarının ve komisyon ayarlarının doğru olduğu.
- Üye işyerinin beklenen fonları aldığı.
- İşlemin blokzincirde gereken kesinliğe ulaştığı.
- İşlem hash'inin daha önce başka bir sipariş için kullanılmadığı.
Gerekli ayrıntılardan biri eşleşmezse siparişi otomatik olarak ödendi diye işaretlemeyin. Ödemeyi inceleme için beklemede tutun.
Doğrulama sürecinin tamamı için Ödeme doğrulama ve sipariş takibi sayfasına bakın.
Destekle iletişime geçin
Sorun devam ederse Volet.com ile iletişime geçin ve şunları iletin:
- Blokzincir ağı ve varlık.
- Varsa ödeme işleminin hash'i (
txid). - İşlemin yaklaşık tarihi ve saati.
- Üye işyerinin sipariş kimliği.
- İşlemci sözleşmesinin adresi.
- Hata mesajı veya sorunun açıklaması.
Ekibimize Volet.com desteği üzerinden ulaşabilirsiniz.
Güvenlik: Cüzdan kurtarma ifadelerini (seed phrase), özel anahtarları veya gizli API kimlik bilgilerini asla paylaşmayın.
İlgili sayfalar
- Akıllı sözleşme entegrasyonu — emanetçi olmayan ödemelere genel bakış.
- Ethereum ve BNB Smart Chain entegrasyonu — ETH, BNB ve USDT kabul edin.
- TRON entegrasyonu — TRX ve USDT TRC-20 kabul edin.
- Akıllı sözleşme referansı — sözleşme adresleri, parametreler ve hatalar.
- Ödeme doğrulama ve sipariş takibi — işlemleri doğrulayın ve siparişlerin mutabakatını yapın.