Ödeme eşleştirme ve tutar uyuşmazlıkları

Bu bölüm, hizmetin gelen on-chain işlemi kesilen faturayla eşleştirmek için kullandığı kuralı, tutar farklı olduğunda ne olduğunu ve satıcının bu durumda ne yapabileceğini anlatır.

Fatura durumları, süreler ve durum geçişleri Fatura yaşam döngüsü sayfasında anlatılır.

Tutar eşleşme kuralı

Fatura oluşturulurken hizmet, itibari tutarı kriptoya dönüştürür ve ortaya çıkan tutarları fatura için sabitler. Bunlar ödemenin tanımlayıcısı olur: alıcı bunları ödeme formunda görür ve hizmet, on-chain tam olarak bu tutarda bir işlem arar.

Ödeme tutarı, fatura tutarıyla tam olarak eşleşmelidir. Tolerans yoktur. Ödenecek tutar, USDT ve USDC stablecoin'leri için 2, diğer kripto paralar için 8 ondalık basamakla oluşturulur ve gelen ödeme bununla birebir karşılaştırılır. Her sapma — ne kadar küçük olursa olsun eksik veya fazla ödeme — otomatik eşleştirmenin olmayacağı anlamına gelir.

Örnek. 100.00 USD tutarında bir fatura, 100.12 USDT sabitlenmiş tutarla kesilir.

Gelen ödeme tutarı	Sonuç
100.12 USDT	Fatura otomatik olarak Ödendi (Paid) durumuna geçer
100.11 USDT	Otomatik eşleştirme yok
100.50 USDT	Otomatik eşleştirme yok

Aynı itibari tutar için aynı anda tek bir adrese birden fazla fatura kesilirse hizmet, her birine biraz farklı bir kripto tutarı atar. Benzersizlik, o cüzdandaki tüm ödenmemiş faturalarınız genelinde kontrol edilir; bu yüzden bir adres, birden fazla projenizde güvenle kullanılabilir — tutarlar çakışmaz.

Uyuşmazlığın en yaygın nedenleri, alıcının tutarı elle yuvarlaması veya borsadan çekimde ağ ücretinin kesilmesidir. Alıcıyı, tam olarak ödeme formunda gösterilen tutarı göndermesi için uyarın.

Tutar uyuşmazlığında ne olur

Hizmet, paranın geldiğini kaydeder ama faturayla ilgili hiçbir işlem yapmaz:

• Fatura durum değiştirmez. Ödeme süresine kadar ödenmemiş kalır. Arama penceresi açıkken alıcı, faturayı doğru tutarla yine de kapatabilir.
• Webhook gönderilmez. Webhook URL'ye bildirim, yalnızca faturanın Ödendi durumuna geçtiği anda gider.
• Kısmi ödeme izlenmez. Hizmet, eksik ödemeyi tanımaz ve faturada kalan borç tutmaz.
• Ödemeler toplanmaz. Alıcı, eksik ödemenin ardından eksik fark için ikinci bir işlem gönderirse iki ödeme toplanmaz. İkisi de ayrı, eşleşmemiş ödemeler olarak kalır.
• Fazla ödeme otomatik olarak iade edilmez. Para doğrudan cüzdanınıza gider; farkın alıcıya iadesi, hizmetin dışında halledilir.

Hizmette Kısmen ödendi veya Fazla ödendi gibi ara durumlar yoktur.

Satıcı sorunu nasıl öğrenir

Proje ayarlarında bildirimler etkinse satıcı, her gelen ödeme hakkında bir e-posta ve Telegram botu mesajı alır — ödemenin bir faturayla eşleşip eşleşmediğine bakılmaksızın.

Bu, basit bir tanı kuralı verir: gelen ödeme bildirimi geldiyse ama ardından fatura ödendi bildirimi gelmediyse, ödeme tutar uyuşmazlığı nedeniyle eşleşmemiştir ve manuel işlem gerektirir.

Kural yalnızca arama penceresi içinde işler. Hizmet, cüzdanları yalnızca en az bir faturanın araması hâlâ etkinken izler. Alıcı, böyle bir fatura yokken öderse ödeme sisteme hiç girmez — ne bildirim olur ne de onu manuel eşleştirmenin bir yolu.

Eşleşmemiş ödemeleri programatik olarak da bulabilirsiniz. payments/list metodu, tüm cüzdanlarınızdaki ödemeleri döndürür; bir faturayla eşleşmemiş ödemenin yanıtta invoice bloğu yoktur. Manuel eşleştirmenin adayları bunlardır: tutarı ve zamanı beklenen faturayla karşılaştırın ve invoices/bindPayment metodunu çağırın.

Manuel ödeme eşleştirme

Hangi ödemenin hangi faturaya karşılık geldiğinden eminseniz bunları manuel olarak eşleştirin — panelde fatura sayfasında veya ödeme listesinde ya da API'de invoices/bindPayment metoduyla.

Eşleştirme koşulları

Eşleştirme, yalnızca tüm koşullar aynı anda sağlandığında mümkündür:

1. Fatura Ödenmedi (Unpaid) veya Süresi doldu (Expired) durumunda. İptal edilmiş ve zaten ödenmiş faturalar eşleştirilemez.
2. Ödeme henüz başka bir faturayla eşleştirilmemiş. Bir ödeme yalnızca tek bir faturaya bağlanabilir.
3. Ödeme, bu faturada yer alan bir cüzdana gelmiş.
4. Ödeme, kullanılabilir ödeme penceresi içinde — fatura oluşturulmadan 24 saat öncesi ile 24 saat sonrası arasında.

Pencere, faturanın geçerlilik süresinden geniştir ve bu iki olanak açar: süresi zaten dolmuş bir faturaya ödeme eşleştirebilirsiniz ve faturayı, fatura oluşturulmadan önce gelmiş bir ödemeyle eşleştirebilirsiniz. İkincisi, alıcının parayı kendi girişimiyle gönderdiği ve faturanın para geldikten sonra kesildiği durumlarda işe yarar.

Eşleştirmeden sonra ne olur

• Fatura Ödendi durumuna geçer — tıpkı otomatik eşleştirmedeki gibi.
• Webhook her zaman gönderilir. Bildirim, eşleştirmenin nasıl yapıldığından bağımsız olarak Ödendi durumuna her geçişte gider.
• Faturanın USD tutarı, fiili ödemeden yeniden hesaplanır. amountFiatUSD alanının üzerine, eşleştirme anındaki kurla, fiilen alınan tutar yazılır. amountFiat alanındaki orijinal tutar değişmez.
• Ücret, fiili tutardan yeniden hesaplanır. Aldığınız tutar üzerinden, projenin ücret oranıyla alınır.