Paddle'ı bağlayın
Yazılım ve SaaS satışlarını, iadeleri ve vergileri ürün ve ülke bazında içe aktarmak için salt okunur bir Paddle API anahtarı yapıştırın.
Paddle, uygulama mağazaları dışında sattığınız yazılımların merchant of record'udur: masaüstü uygulamalar, web uygulamaları, SaaS planları ve lisanslar. OAuth yerine tek bir salt okunur API anahtarıyla bağlanır. Anahtarı Paddle panelinde oluşturur, Revenue Sensor'a yapıştırır ve hangi Paddle ürünlerinin eşitleneceğini seçersiniz. Anahtar şifreli olarak saklanır ve sunucumuzdan asla çıkmaz; Paddle girişiniz hiçbir zaman kullanılmaz.
Başlamadan önce
- Satışlarını izlemek istediğiniz satıcı hesabının Paddle paneline erişim ve Developer tools altında API anahtarı oluşturma izni.
- Canlı hesabı mı yoksa sandbox'ı mı istediğinizi bilin. Paddle her biri için ayrı anahtar verir ve hangisini okuyacağımıza anahtar karar verir; seçilecek başka bir şey yoktur.
Salt okunur bir API anahtarı oluşturun
- 1
Developer tools'u açın
Paddle panelinde Developer tools → Authentication bölümüne gidin ve yeni bir API anahtarı oluşturun. Daha sonra tanıyacağınız bir ad verin, örneğin "Revenue Sensor".
- 2
Yalnızca okuma izni verin
Transactions, Adjustments, Products ve Addresses için okuma erişimini işaretleyin. Addresses, Customers altında yer alır ve bize alıcının ülkesini verir; alakasız görünse de açık bırakın. Yazma izni gerekmez.
- 3
Anahtarı bir kez kopyalayın
Paddle anahtarı yalnızca oluşturulduğu anda bir kez gösterir. Hemen kopyalayın; kaybederseniz iptal edip yenisini oluşturun.
Hesabı bağlayın
- 1
Anahtarı yapıştırın
Revenue Sensor konsolunda Integrations → Paddle → Connect yolunu izleyin ve API anahtarını yapıştırın. Revenue Sensor, canlı anahtarı sandbox anahtarından ayırt etmek için anahtarın ön ekini okur ve devam etmeden önce hangisini kullanacağını onaylar.
- 2
Ürünlerinizi seçin
Eşitlediğiniz birimler mağaza uygulamaları değil, Paddle ürünleridir. Defterde görmek istediğiniz ürünleri seçin; her biri gelirde kendi satırı olarak görünür ve bir uygulamaya aitse o uygulamayla eşleştirilebilir. Yalnızca seçtikleriniz çekilir ve yalnızca seçtikleriniz planınıza sayılır.
- 3
İlk eşitlemenin tamamlanmasını bekleyin
Paddle tüm geçmişinizi sakladığından ilk eşitleme bir yıla kadar ödenmiş işlemi ve iadeyi geriye dönük doldurur. Genellikle birkaç dakika sürer ve çalışırken sayfadan ayrılabilirsiniz.
Neler içe aktarılır
| Alan | Notlar |
|---|---|
| Gelir | Ödenmiş işlemler; faturanın kesildiği gün değil, paranın tahsil edildiği gün kaydedilir. Ürün, gün ve alıcı ülkesi bazında, vergi hariç gösterilir. Google Play'in Google komisyonu düşülmeden brüt gösterilmesi gibi, Paddle'ın kendi ücreti de düşülmez. |
| Vergi | Paddle, merchant of record olarak satış vergisi ve KDV'yi tahsil eder ve her satır öğesinde belirtir; bu nedenle vergi ayrı olarak içe aktarılır ve bu kaynak için vergi dahil görünüm kullanılabilir. |
| İadeler ve ters ibrazlar | Onaylanan iadeler ve ters ibrazlar, onaylandıkları gün geliri azaltır; tutar bağlam için ayrıca iade rakamı olarak da taşınır. Geri alınan bir ters ibraz parayı geri koyar. Krediler ve ters ibraz uyarıları iade olarak değerlendirilmez. |
| Ülke | Müşterinin fatura adresinden alınır. Yalnızca ülke kodu kullanılır. |
Her Paddle para birimi desteklenir
İşlemler, tahsil edildikleri para biriminde içe aktarılır ve diğer tüm kaynaklar gibi dönüştürülür. JPY ve KRW gibi ondalıksız para birimleri doğru okunur; böylece bir Japonya satışı değerinin yüzde biri olarak raporlanmaz.
Gerçek zamanlı güncellemeler (isteğe bağlı)
Revenue Sensor, Paddle'ı her 30 dakikada bir eşitler. Yeni bir satışı veya iadeyi bir iki dakika içinde görmek isterseniz bir Paddle bildirim hedefini bize yönlendirin. Rakamlar yine Paddle API'sinden gelir; webhook yalnızca daha erken eşitlememizi söyler.
- 1
Webhook URL'sini kopyalayın
Revenue Sensor konsolunda Paddle bağlantısını açın. "Real-time updates" paneli bu bağlantıya özel bir URL gösterir; onu kopyalayın.
- 2
Bir bildirim hedefi oluşturun
Paddle'da Developer tools → Notifications → New destination yolunu izleyin. URL'yi yapıştırın, tür olarak Webhook'u seçin ve transaction, adjustment ve subscription olaylarına abone olun.
- 3
Gizli anahtarı kaydedin
Paddle, hedef oluşturulduğunda bir imzalama gizli anahtarı gösterir. Bunu "Real-time updates" paneline yapıştırıp kaydedin. Her teslimatı doğrulamak ve imzasız her şeyi reddetmek için kullanırız; şifreli olarak saklanır ve bir daha gösterilmez.
Sorun giderme
- Anahtar reddediliyor: Transactions, Adjustments, Products ve Addresses'ın dördüne de okuma erişimi olduğundan emin olun. Addresses olmayan bir anahtar temel kontrolü geçer ama eşitlemede başarısız olur.
- Hiç ürün listelenmiyor: Anahtar farklı bir hesaba ya da canlı beklerken sandbox'a (veya tersi) ait. Hangisi olduğunu anahtarın ön eki söyler.
- Bir satış eksik: Yalnızca ödenmiş, tamamlanmış işlemler içe aktarılır. Taslaklar, ödenmemiş faturalar ve iptal edilen işlemler henüz gelir değildir.
- Gelir, ödemenizden yüksek görünüyor: Bu beklenen bir durumdur. Vergi ayrı tutulur ve Paddle'ın ücreti düşülmez; dolayısıyla rakam, Paddle'ın payı öncesindeki brüt gelirdir.
- Bir iade satıştan farklı bir günde görünüyor: İadeler, onaylandıkları gün kaydedilir; asıl satın alma tarihine geri götürülmez.