Eksik ödeme geriye bir borç bırakır; fazla ödeme ise çözüme kavuşturulması gereken bir fazlalık yaratır. İkisi de gelişigüzel bir iadeye veya tutarın tamamı için yeni bir ödeme talebine yol açmamalıdır. Önce ne kadar para ulaştığını doğrulayın, bunu satın alımla eşleştirin, ardından siparişin yerine getirilmesini ve farkın nasıl kapatılacağını ayrı ayrı kararlaştırın.
Bu rehber, varlığın, ağın ve hedef adresin doğru olduğunu varsayar. Bunlar eşleşmiyorsa yanlış ağ olayları rehberini kullanın. Buradaki sorun, diğer yönlerden talebe uygun olan bir tahsilatın tutarı, zamanı veya hangi borca mahsup edileceğidir.
Aşağıdaki kontroller, satıcılara yönelik operasyon ve mühendislik önerileridir; Yolfi'nin otomatik özelliklerinin listesi değildir. Örnekler açıklama amaçlıdır, gerçek müşteri olayları değildir.
Çözümü seçmeden önce tutarı kesinleştirin
İlk talebi saklayın: sipariş referansı, istenen token tutarı, ağ, hedef adres, fiyat teklifinin dayanağı ve varsa geçerlilik süresi kuralı. Talebi, müşterinin cüzdan ekran görüntüsüyle veya tahmini bakiyesiyle değil, onay politikanızı karşılayan ve bağımsız olarak doğrulanmış tahsilatlarla karşılaştırın.
Üç tutarı ayrı tutun:
- Talep edilen tutar: ödeme talimatlarının gerektirdiği miktar.
- Doğrulanmış tahsilatlar: gerçekten ulaşmış ve mahsup edilmeye uygun, taleple eşleşen transferler.
- Çözümlenmemiş bakiye: önceki mahsuplar, müşteri alacakları ve iadeler sonrasında kalan eksik veya fazla tutar.
Daha sonra yapacağınız transferlerin masraflarını müşterinin ödeme tutarından düşmeyin. Sağlayıcı ücretlerini ve muhasebe düzeltmelerini, gerçekte ne kadar ulaştığını gösteren kanıtlardan ayrı tutun.
Bir borsa, çekim ücretini tutardan düşüyorsa müşterinin göndermeyi amaçladığından daha azı ulaşabilir. Tahmin etmek yerine tahsilatı kontrol edin. Buna karşılık Ethereum üzerinde standart bir USDC veya USDT transferinde Ethereum gas ücreti USDC ya da USDT düşülerek ödenmez: Ethereum gas ücretleri ETH ile ödenir. Müşterilere gas için tahmini bir stablecoin tutarı eklemelerini önermeyin.
Uygulamada, varlığın doğrulanmış ondalık hassasiyetini kullanarak tam sayı temel birimleri veya kesin ondalık değerleri karşılaştırın. İkili kayan noktalı karşılaştırmalardan kaçının; ödeme sayfası daha az ondalık basamak gösteriyor diye eksik tutarı yuvarlayarak yok saymayın.
Tutar uyuşmazlıkları için karar tablosu
Bunu kurum içi politika şablonu olarak kullanın. Bunlar işletme sınıflandırmalarıdır, Yolfi API durumları değildir.
| Doğrulanmış durum | Siparişin yerine getirilmesi kararı | Tutarı çözüme kavuşturacak işlem | Kapatmadan önce kontrol |
|---|---|---|---|
| Tutarın tamamı geçerli zamanlama kuralı içinde ulaştı | Onay gereksinimleri karşılandıktan sonra bir kez yerine getirin | Tahsilatı siparişe mahsup edin | Önceki mahsupları ve siparişin yerine getirilip getirilmediğini kontrol edin |
| Talep edilenden az ulaştı | Yetkili bir indirim kararı yoksa bekletin | Takip edilen bir bakiye talebini, indirimi veya iadeyi onaylayın | Kalan borcu ve sorumluyu kaydedin |
| Talep edilenden fazla ulaştı | Yalnızca ödeme kabul kuralları sağlanıyorsa bir kez yerine getirin | Fazlalığı iade veya mutabık kalınan müşteri alacağı için inceleyin | Siparişe mahsup edilen tutarı fazlalıktan ayırın |
| Birkaç transfer gerekli toplamı karşıladı | Birleştirme doğrulanıp izin verilene kadar bekletin | Uygun her transferi bir kez mahsup edin | Sağlayıcının ödemeleri birleştirdiğini varsaymayın |
| Tutarın tamamı süre dolduktan sonra ulaştı | Zamanlamayı, fiyat teklifini ve siparişin karşılanabilirliğini inceleyin | Politikaya göre kabul edin veya başka bir çözümde anlaşın | Bağlantılı yenileme taleplerini kontrol edin |
| Hem ilk talebe hem onun yerine oluşturulan talebe para geldi | Siparişi asla iki kez yerine getirmeyin | İki tahsilatın mutabakatını yapın ve fazlalığı çözün | Siparişi mükerrer işlemlere karşı kilitleyin |
Her istisnaya adı belli bir sorumlu ve bir sonraki bilgilendirme için son tarih atayın. Destek ile finans ekipleri birbirinin ilgilendiğini varsaydığı için bir tahsilat mahsup edilmeden kalmamalıdır.
Eksik ödemeler: yalnızca onaylanmış sonraki adımı talep edin
Bir talebin 100 USDC gerektirdiğini, ancak doğrulanmış tahsilatın 98 USDC olduğunu varsayalım. Eksik tutar 2 USDC olur. İlk tahsilat kaydını koruyun; onu sessizce 100 gösteren yeni bir kayıtla değiştirmeyin.
Belgelenmiş şu sonuçlardan birini seçin:
- Bakiyeyi tahsil edin. Entegrasyonunuzun ayrı tahsilatları uzlaştırabildiğini doğrulayın. Kalan tutar için aynı siparişe bağlı, güncel ödeme talimatları içeren ve takip edilen bir talep oluşturun.
- İndirim uygulayın. Yetkili kişi, vazgeçilen tutarı ve muhasebe kaydının nasıl tutulacağını kaydeder. Satıcının tanıdığı indirimin sağlayıcının ödemeyi tanıma kurallarını değiştirdiğini ileri sürmeyin.
- Kısmi tahsilatı iade edin. Ayrı bir giden ödeme yapmadan önce iade koşulları ve hedef adres üzerinde anlaşın.
Yolfi'nin kısmi ödeme hakkındaki yanıtı, eksik ödemelerin onaylanmadığını belirtir ve müşterilerden satıcıyla iletişime geçmelerini ister. Aynı adrese ek ödeme yapılmasını, satıcının sisteminin bunu desteklemesi koşuluna bağlar. Bu nedenle farkın gönderilmesinin ilk Yolfi talebini otomatik olarak tamamlayacağına söz vermeyin.
Bölünmüş ödemelerin işlenmesi doğrulanmadıysa müşteriden daha fazla para göndermesini istemeden önce konuyu yetkiliye aktarın. İlk kısmi tahsilatı tutarken yeniden tam ödeme istemek, öngörülebilir bir fazla ödeme yaratır.
Küçük eksik tutarlara ilişkin politikayı olaylar yaşanmadan önce belirleyin. Örneğin bir onay limiti, uygun satın alımlar ve denetim için gerekçe tanımlayın. Evrensel bir tolerans yüzdesi yoktur: BTCPay Server kendi yapılandırılabilir eksik ödeme toleransını belgelendirir, ancak bu, Yolfi'nin aynı ayarı sunduğunu göstermez.
Fazla ödemeler: satışı fazlalıktan ayırın
Müşterinin borcu 100 USDT iken 105 USDT gönderdiğini düşünün. Ödeme diğer kabul gereksinimlerini karşılıyorsa 100 USDT tutarını satın alıma mahsup edin ve 5 USDT tutarını çözümlenmemiş fazlalık olarak takip edin. Farkı varsayılan olarak ek gelir veya ilave ürün hakkı saymayın.
Müşteriden mevcut ve politikaya uygun çözümlerden birini seçmesini isteyin: iade veya açıkça mutabık kalınan bir müşteri alacağı. Anlaşmadan önce geçerli ücretleri açıklayın; yerel tüketici ve muhasebe yükümlülüklerini kontrol edin. Tutarın küçük olması, parayı sessizce tutma izni vermez.
Ayrıca fazla tutarlı bir transferi mükerrer ödemeden ayırın. 100 USDT tutarındaki tek satın alım için iki ayrı 100 USDT transferi, düzeltilmiş tek tahsilat değil iki tahsilattır. İki işlem kaydını da saklayın, siparişi bir kez yerine getirin ve ek 100 USDT tutarını ayrı inceleyin.
Geç ödemeler: sürenin dolması, gelen paranın durumunu çözmez
Ödeme talebinin son tarihini, transferin tespit zamanını ve onay zamanını ayrı kaydedin. Süre dolmadan görülen ancak sonradan onaylanan bir ödeme, ilk kez fiyat teklifinin süresi dolduktan sonra alınan transferden farklıdır. Belgelenmiş kuralı uygulayın; evrensel bir ek süre uydurmayın.
Geç gelen tahsilatlarda şunları inceleyin:
- ilk fiyatın hâlâ geçerli olup olmadığı;
- stok, kapasite veya erişimin hâlâ mevcut olup olmadığı;
- aynı siparişin başka bir taleple zaten ödenip ödenmediği;
- iade, müşteri alacağı veya indirimin zaten onaylanıp onaylanmadığı.
Token cinsinden düzenlenmiş 100 USDC talebiyle itibari para cinsinden düzenlenip kriptoya çevrilen bir talebin geç ödeme politikaları aynı olmak zorunda değildir. Geçmişi yeniden fiyatlandırmak yerine ilk fiyat teklifini saklayın ve yeni bir fiyat teklifi varsa bunu açıklayın.
Yeni bir talep gerekiyorsa kayıtlarınızda ilk siparişle ilişkilendirin ve müşteriyi ikisini birden ödememesi için uyarın. Eski girişimi izlemeye devam edin. Destek kaydını kapatmak, daha önce gönderilmiş bir transferin sonradan onaylanmasını engellemez.
İkinci bir olay yaratmadan güvenli iade yapın
İade, gelen transfer üzerinde yapılan bir düzeltme değil, ayrı bir giden ödemedir. Yolfi'nin saklama hizmeti sunmayan yapısına ilişkin açıklaması, ödemelerin doğrudan satıcının yapılandırdığı cüzdana gittiğini belirtir. Yolfi'nin iade edilebilir bir bakiye tuttuğunu veya fazlalığı otomatik olarak geri gönderdiğini varsaymayın.
İadeye izin vermeden önce:
- İlk tahsilatı, müşterinin talebini ve kalan iade edilebilir tutarı doğrulayın.
- Talepte bulunan kişinin kimliğini mevcut müşteri iletişim kanalı üzerinden doğrulayın.
- İade için kullanılacak varlığı, ağı ve hedef adresi alın ve doğrulayın. Parayı sorgulamadan işlem göndericisine geri göndermeyin; adres bir borsaya veya başka bir aracıya ait olabilir.
- Geçerli yükümlülüklere tabi olarak brüt iade, ücretlerin nasıl karşılanacağı ve beklenen net tutar üzerinde anlaşın.
- Cüzdan güvenliği politikanız kapsamında onay isteyin; nedeni ve onaylayan kişiyi kaydedin.
- Giden işlem referansını kaydedin ve iadeyi tamamlandı olarak işaretlemeden önce sonucunu doğrulayın.
Asla kurtarma ifadesi veya özel anahtar istemeyin. İade gönderimi zaman aşımına uğrarsa yeniden göndermeden önce işlem durumunu araştırın. Belirsiz bir yanıt, hiçbir ödemenin ağa yayınlanmadığını kanıtlamaz.
Her çözümü idempotent hâle getirin
İdempotentlik, yeniden denemelerin aynı iş eylemini tekrarlayamaması demektir. Stripe'ın webhook rehberi, Stripe için mükerrer olayları ve sıralamanın garanti edilmediğini belgeler; yararlı bir mühendislik kaynağıdır, Yolfi'nin bildirim teslim garantilerinin açıklaması değildir.
Kendi entegrasyonunuzda:
- Bildirimlerin gerçekliğini sağlayıcının belgelenmiş doğrulama yöntemiyle kontrol edin.
- Gelen olayları kalıcı olarak saklayın ve belgelenmiş tanımlayıcılarla mükerrerleri ayıklayın.
- Her tahsilatı ağı ve işlem referansıyla tanımlayın; tek işlem birden çok ilgili transfer içeriyorsa transfer veya olay indeksini de ekleyin.
- Veritabanı kısıtları veya eşdeğer işlemsel kontrollerle her tahsilatın bir kez mahsup edilmesini ve her siparişin bir kez yerine getirilmesini sağlayın.
- Onaylanmış bir iade işlemini göndermeden önce işleme alınmak üzere ayırın; eşzamanlı çalışan süreçlerin iki kez göndermesini önleyin.
Tekrarlanan bir webhook başka bir ödeme değildir. İkinci bir geçerli transfer başka bir tahsilattır, ancak yine de ikinci bir sevkiyat izni değildir. İstisnaları kapatmadan önce hem cüzdan kanıtları hem de işletme kayıtlarıyla uzlaştırın.
Sık sorulan sorular
Çok küçük bir eksik ödemeyi kabul etmeli miyiz?
Yalnızca onaylanmış bir satıcı politikası kapsamında. İndirimi ayrı kaydedin ve ödemenin nasıl tanındığını doğrulayın; otomatik tolerans bulunduğunu varsaymayın.
Fazla ödeme otomatik iadeyi tetiklemeli mi?
Sahiplik, hedef adres, tutar ve mükerrer işlem kontrolleri doğrulanmadan hayır. Test edilmiş, yetkilendirilmiş bir süreç güvenle işlemiyorsa fazlalığı inceleme sırasına alın.
İki kısmi transfer bir siparişi ödeyebilir mi?
Politikanız izin veriyorsa kayıtlarınızda birden çok tahsilatı mahsup edebilirsiniz. Ödeme sağlayıcısının bunları birlikte tanıyıp tanımadığı ayrıca doğrulanmalıdır.
Sonuç: yalnızca destek kaydını değil, bakiyeyi de kapatın
Anlaşılır bir Yolfi ödeme linkiyle başlayın; ardından satıcının istisna defterini ödeme kaydıyla birlikte tutun. Bir vakayı yalnızca siparişe mahsup edilen tutar, siparişi yerine getirme kararı, kalan bakiye ve varsa iade veya müşteri alacağı birbiriyle tutarlı olduğunda kapatın. Böylece küçük bir tutar uyuşmazlığının ikinci bir ödemeye, mükerrer teslimata veya güvensiz bir iadeye dönüşmesini önlersiniz.
