Kripto ödemeleri için operasyon kontrol listesi

Yayından önce

Bir kez yapın ve sunucunuzda her değişiklikten sonra tekrarlayın.

• API anahtarı yalnızca sunucuda, ortam değişkeninde veya sır yöneticisinde durur; ön yüz kodunda veya depoda asla.
• Callback URL kayıtlı, herkese açık ve HTTPS, ağınızın dışından erişilebilir.
• Webhook işleyicisi tam olarak HTTP 200 döndürür, hızlıdır ve iki kez çalıştırılması güvenlidir. Başka herhangi bir durum, zaman aşımı veya yönlendirme başarısız teslimat sayılır. Bkz. kripto ödeme webhook'ları nasıl güvenceye alınır.
• Test ödemesi baştan sona çalışır. Küçük bir gerçek tutar ödeyin, webhook'un gelişini ve siparişin ödendi olmasını görün. Henüz sandbox yok, bu yüzden küçük gerçek tutarlar kullanın.
• Yeniden deneme çalışır. Uç noktayı bir kez başarısız yaptırın ve Qvard'ın yeniden denediğini (yaklaşık altı dakikada beş deneme) siparişi iki kez karşılamadan doğrulayın.
• Çekim çalışır. Kendi cüzdanınıza küçük bir tutar çekin. Yalnızca ağ ücretine mal olur.
• Kurallar yazılıdır: eksik ödemede ne yapacağınız, iadeyi nasıl yapacağınız ve müşterilere kimin yanıt vereceği.

Her gün

Birkaç dakika, tercihen aynı saatte.

• Kur penceresini aşmış ödenmemiş siparişler. Ödeme sayfasındaki kur bir saat sabittir. Bundan sonra hâlâ bekleyen siparişlere bakın: ya terk edildi ya da bir bildirim kaçtı.
• Eksik ödemeler. partial durumundaki ödeme tamamlanma webhook'u göndermez. Bu ödemeleri panelde kontrol edin, siparişi beklemede tutun ve müşteriyle iletişime geçin. Bkz. USDT eksik ödemeleri nasıl ele alınır.
• Webhook uç noktasındaki hatalar. Art arda başarısız istekler veya 401 yanıtları bozuk bir uç noktaya ya da anahtar uyuşmazlığına işaret eder. Günün sonunda fark etmek yerine uyarı kurun.
• Günlük toplam. Ödendi işaretlediğiniz siparişleri paneldeki ödemelerle karşılaştırın. Herkese açık API'de ödemeleri listeleyen bir rota yoktur, bu yüzden bu, kendi webhook kaydınızla bir karşılaştırmadır. Bkz. kripto tüccarları için ödeme mutabakatı.

Her hafta

• Kaçan bildirimler. Panel tamamlanmış bir ödeme gösteriyor ama sipariş sisteminiz göstermiyorsa, bildirimi panelden yeniden gönderin ve idempotent işleyicinin uygulamasına izin verin.
• Destek kalıpları. Yanlış ağ, eksik ödeme ve «ödedim, bir şey olmadı» konulu talepleri sayın. Biri tekrar ediyorsa her talebi değil, ödeme sayfasındaki veya sipariş sayfasındaki ifadeyi düzeltin.
• İadeler. Gönderdiğiniz her iadenin asıl siparişine kaydedildiğini ve müşterinin onayladığı adres ve ağa gittiğini kontrol edin.
• Varlık ve ağa göre bakiyeler. Farklı ağlardaki ödemeler ayrı birikir. Neyi çekeceğinize karar vermeden önce neyin nerede durduğuna bakın.
• Stok ve süre dolumu. Ödenmemiş siparişler için stok ayırıyorsanız, süresi dolan siparişlerin onu serbest bıraktığını doğrulayın.

Her ay

• Tam mutabakat. Ayın siparişlerini, webhook kaydını ve panel ödemelerini eşleştirin ve her farkı açıklayın. Geliri sipariş değeri üzerinden dolar olarak kaydedin; komisyonu ve çekim ücretlerini ayrı satırlar olarak işleyin.
• Çekimleri gözden geçirin. Abonelik ücreti yoktur; komisyon projenize özeldir ve fiyatlandırma sayfasına göre %1'den başlar ve %0,1'e kadar inebilir. Çekim yalnızca ağ ücretine mal olur, genellikle transfer başına sabit bir tutardır; bu yüzden çok sayıda küçük çekim yerine makul boyutlarda çekin. Bkz. kripto ödeme operasyonlarında ağ ücretleri.
• Erişimleri değiştirin ve denetleyin. API anahtarını ve paneli kimin gördüğünü kontrol edin; anahtara sahip biri ayrıldıysa veya sızıntıdan şüpheleniyorsanız anahtarı değiştirin.
• Müşteri metnini yeniden okuyun. Ödeme sayfası kabul edilen varlıkları ve ağları, ücret notunu ve iade kuralını hâlâ belirtiyor mu? Hâlâ doğru mu?
• Muhasebecinize danışın. Kripto tahsilatlarının vergilendirilmesi ve muhasebeleştirilmesi ülkenize bağlıdır; uygulamayı düzenli gözden geçirin.

Bir şey ters göründüğünde

Sık görülen durumlar için kısa bir senaryo.

• Müşteri ödediğini söylüyor, sipariş ödenmemiş görünüyor. Ödemeye panelden bakın. Tamamlanmışsa bildirimi yeniden gönderin. partial ise farkı isteyin. Yoksa işlem bilgilerini ve kullandığı ağı isteyin.
• Yanlış ağ. Fonlar beklendiği gibi gelmez ve elle işlem gerektirir. Ödeme yolunda görünür bir destek iletişimi bulundurun.
• Ödenmiş sipariş iki kez karşılandı. İşleyici idempotent değil. Güncellemeyi tek bir veritabanı ifadesiyle koşullu yapın («henüz ödenmediyse ödendi»).
• Webhook gelmeyi bıraktı. Uç noktayı ağınızın dışından test edin, erişim günlüğündeki yanıt koduna bakın ve güvenlik duvarı, yönlendirme veya yavaş işleyici arayın. Bkz. ödeme sistemleri için webhook yeniden deneme stratejisi.
• API'nin ne yaptığından emin değilsiniz. Referans geliştiriciler için kripto ödeme API'si.

Bu listeyi tüm ekibin görebileceği bir yerde tutun ve her satırdan kimin sorumlu olduğunu yazın.

FAQ