WooPayments Mutabakat Raporlari 10.9 Beta ile Geldi

🇬🇧 English: Read this in English →

Kart kabul eden her WooCommerce mağazasının aylık bir ritüeli vardır. Muhasebeden biri banka ekstresini açar, başka biri WooCommerce Siparişler ekranını, üçüncü bir sekmede ödeme sağlayıcının paneli döner ve iki saat boyunca bu üç rakamın uyuştuğu ispatlanmaya çalışılır. İyi bir ayda hiçbir şey bulamazsın. Kötü bir ayda ise iki kuruşluk bir kur farkı, geri dönmemiş bir itiraz, ödeme geçidine düşen ama siparişe işlenmemiş bir iade ve iki haftayı tek satıra sıkıştırmış bir payout ile karşı karşıya kalırsın.

Yıllarca müşterilerin bu ritüel etrafında koca sistemler kurduğunu gördüm. Dışa aktarılmış CSV’lerle VLOOKUP çeken Google Sheets dosyaları. Stripe balance transactions’ı çekip metadata üzerinden Woo siparişleriyle eşleyen özel mu-plugin’ler. Tanıdığım bir ajans, sırf bunun için ayakta tuttuğu bir Retool panosu işletiyor. Hepsi, “WooPayments bakiyem ayın başından ayın sonuna nasıl geldi” sorusunun cevabının şimdiye kadar tek bir yerde durmamasından dolayı var oldu: excel tablosu.

WooPayments 10.9 bu işin büyük kısmını sessizce emekliye ayırıyor. Fanfarsız, WooCommerce 11.0’ın sürüm notlarında yer almadan, çoğu satıcının kendi başına bulamayacağı bir ayarlar ekranı ile. Şimdilik açman gereken bir beta özelliği olarak.

Gerçekten yeni olan ne

6 Ağustos 2026’da WooCommerce Developer Blog, oleksandraratovskyi imzalı Introducing Reconciliation Reports for WooPayments yazısını yayımladı. Yazı, WooPayments 10.9 ile gelen ve kademeli olarak dağıtılan yeni bir bölümü duyuruyor: Payments → Reports altında iki rapor yaşıyor.

Bakiye Raporu (Balance Report) baş oyuncu. Bir dönem seçiyorsun ve rapor, muhasebecinin zaten kafasında kurduğu sırayla hesap hareketini yürüyor: Başlangıç bakiyesi → Charges → Fees → Refunds → Disputes → Payouts → Bitiş bakiyesi. Özeti yazdır, detayı CSV’ye dök. Manuel mutabakat ritüelinin yıllardır tekrar etmeye çalıştığı satır tam olarak budur; rakamların tutmasının sebebi de hesabın Stripe’ın kendi rakamlarıyla hizalanmak için UTC’de yürümesi.

Ücret Raporu (Fees Report) tamamlayıcı. Muhasebe ekibinin ikinci olarak açacağı ekran bu. Her ücretli işlemi tarih ve saat, ödeme yöntemi, tür, sipariş kimliği, işlem kimliği, para birimi, brüt tutar ve toplam ücret sütunlarıyla listeliyor; tarih, yöntem veya türe göre filtrelenebiliyor. Bakiye Raporu’ndaki ücret satırının arkasındaki iz düşümü burası.

Özellik oturana kadar bir bayrak arkasında duruyor. Bir snippet eklentisinde veya küçük bir mu-plugin’de add_filter( 'pre_option__wcpay_feature_reports_area', fn() => '1' ); ile açabilirsin, veya WP-CLI ile wp option update _wcpay_feature_reports_area 1 komutunu koşarsın. Kod dokunmak istemeyen satıcılar için Woo destek ekibi de açabiliyor. Yol haritasında zamanlanmış dışa aktarma, çok para birimli destek ve payout mutabakatına özel görünümler duruyor.

Takvime iki not. Bu duyuru, 4 Ağustos’ta yayınlanan WooCommerce 11.0‘dan iki gün sonra ve haftanın ikinci Stripe for WooCommerce güvenlik danışmanlığı ile aynı gün geldi. Bu bir WooPayments sürümü, WooCommerce Core sürümü değil; ve Stripe for WooCommerce eklentisiyle de aynı şey değil.

WooCommerce tarafında bunun anlamı ne

Mutabakat, pazarlama sitesinin sessiz kaldığı ama retainer görüşmelerinin en yüksek sesle konuştuğu o gösterişsiz sorunlardan biri. Belirli bir büyüklüğün üzerindeki her mağazada var. Çoğu ekip bunu tablolar ve bir kişinin kafasındaki kurumsal bilgiyle çözüyor. O kişi işten ayrıldığında mutabakat bir sonraki alıma anlamlı gelmiyor ve ajans, iki ay önceki bir Salı payout’unun neden on beş euro eksik olduğuna dair bir ticket alıyor.

Raporu WooCommerce yönetim panelinin içine taşımak somut olarak üç şeyi kesiyor. Mutabakat hatalarının aslında yaşadığı yer olan CSV gidiş-dönüşünü öldürüyor. Hesaplamayı ham verinin durduğu yerin yanına koyuyor; yani Pazartesi görülen bir itiraz, kimse yeniden export almadan Salı düzeltilmiş bir bakiye satırına dönüşüyor. Ve ödeme sağlayıcıyla aynı UTC saatini kullanıyor; bu da çok saat dilimli her satıcının en az bir kere yaşadığı “bizim rakam neden Stripe’ın rakamıyla dokuz saatlik işlem kadar farklı” tartışmasını sessizce bitiriyor.

Bunun ötesindeki sinyal, bu hafta yazdığım WooCommerce Core Foundations girişimi ve iki içeriden gelen güvenlik danışmanlığı ile aynı çizgi. Woo, ağır operasyonel yükü üçüncü taraf eklentilerden alıp core yüzeyine, yani sürümlenip destek gören bir yere taşıyor. Mutabakat bu duvarın küçük bir taşı. Aynı zamanda ikinci ayda daha çok fark ettiğin türden bir özellik; ritüel birinci ay olduğundan daha sessiz geçtiğinde.

Ben ne yapardım (ya da yapmazdım)

Beta beta demek. Bu hafta, WooPayments kullanan ve gerçekten aylık mutabakat yapan bir müşterinin staging ortamında açarsın. Bakiye Raporu’nu geçen ayın dönemine yönlendirir ve tek bir soruyu sorarsın: bitiş bakiyesi, muhasebecinin bulduğu rakamı tutuyor mu? Tutuyorsa cevabın hazır. Tutmuyorsa asıl ilginç sayı bu farktır; developer yazısı da yüzey oturana kadar edge case’lerin süreceği konusunda dürüst.

Bugün tüm filoda açma. Bayrağın var olma sebebi var; ve production mağazalarda yönetici paneline tanıdık olmayan bir rapor sekmesinin belirmesi kendi ticket kuyruğunu yaratmak için fazlasıyla yeter. Sana geri dönüş verecek bir muhatabın olduğu yerde aç. Diğer her yerde, gelecekteki bir WooPayments changelog’unda “artık beta değil” satırını bekle ve düzenli bir change window’da aç.

Ve lütfen “WooPayments’a mutabakat raporu ekliyor” iddiasıyla çıkan üçüncü taraf eklentileri kurma. Raporlar WooPayments’ın kendisi ile geliyor. Hâlâ beta olan birinci taraf bir özelliğin üstüne üçüncü taraf sarmalayıcı koymak, ihtiyacın olmayan teknik borcun tanımıdır. Bugün excel tabanlı mutabakat sürecin varsa, beta açıldıktan sonra bir ay boyunca ikisini paralel çalıştır. İkisinin tuttuğunu gördükten sonra tabloyu emekli et. On yıllık iş akışından iz kaybetmeden çıkmanın yolu bu.

İç Retool panoları ve Stripe işlemlerini çeken mu-plugin’ler daha yavaş emekli olabilir. Alternatif yokken kurulmuşlardı. Şimdi alternatif var; beta’da, sağlayıcının kendisinden, eklentiyle sürümlenmiş halde. Özel kodu arşivlemeden önce production’da iki ay geçir, sonra sebebini yazan bir notla birlikte arşivle.

Mutabakat gösterişli bir iş değil ve bu özellik de gösterişli değil. Zaten tanıtım videosuyla çıkan özelliklerden daha fazla güvenmemin sebebi tam olarak bu.