Gumroad

Bu rehberde: E-kitap, şablon, kurs ya da üyelik sattığınız Gumroad hesabını bir erişim anahtarıyla bağlarsınız. Her yeni satış bir iş akışı başlatır; akış içinden satışlarınızı ve ürünlerinizi listeleyebilirsiniz.

⏱ 5 dakika

Kimlik kartı#

Ne işe yarar?#

Tetikleyici: New sale – biri ürününüzü satın aldığında veya bir üyelik yenilendiğinde başlar. Akış şu alanlarla başlar: saleId, orderId, productId, productPermalink, productName, total (3000 sent → 30), quantity, customerName, customerEmail, items, variants (ör. { "Tier": "Pro" }), customFields, offerCode, isRecurringCharge (üyelik yenilemesi mi), subscriptionId, recurrence, refunded, ipCountry, referrer, test, createdAt ve kısaltılmış raw.

Gumroad kutusunun işlemleri:

Ön koşullar#

• Bir Gumroad satıcı hesabı.
• Gumroad'da bir uygulama (application) oluşturup ondan erişim anahtarı üretmek (aşağıda).

Adım adım kurulum#

A) Gumroad'da erişim anahtarı#

1. Gumroad'da Settings → Advanced sayfasına gidin.
2. Applications bölümünde bir uygulama oluşturun: ad OrqLabs, Redirect URI alanına https://orqlabs.com yazabilirsiniz (bu yöntemde kullanılmaz).
3. Oluşan uygulamada Generate access token düğmesine basın ve anahtarı kopyalayın.

B) OrqLabs'ta bağlama#

1. Entegrasyonlar → Gumroad → Bağla → Proje seçin.
2. Access token alanına anahtarı yapıştırın → Bağla.

Bağlantı kurulunca OrqLabs Gumroad API'siyle sale kaynağına abone olur (resource subscription). Gumroad satış bildirimlerini imzalamadığı için OrqLabs bildirim adresine tahmin edilemeyen bir gizli parametre (?t=…) ekler ve gelen her isteği bununla doğrular. Bu adresi başka bir yere kopyalamayın.

Örnek iş akışları#

1) Satıştan sonra kişisel teşekkür ve ek içerik#

Entegrasyon olayı (GUMROAD · New sale) → Eğer ({{ $json.test }} eşittir false) → Metin üret ({{ $json.productName }} alan {{ $json.customerName }} için içten bir teşekkür ve ürünü en iyi nasıl kullanacağına dair 3 ipucu yaz.) → E-posta gönder ({{ $node["Entegrasyon olayı"].json.customerEmail }}).

2) İlk satın almayı aday listesine ekleme#

Entegrasyon olayı → Eğer ({{ $json.isRecurringCharge }} eşittir false) → Aday oluştur (e-posta {{ $json.customerEmail }}, ad {{ $json.customerName }}, kaynak gumroad) → Ekibe bildir (Yeni satış: {{ $json.productName }} – {{ $json.total }}).

3) Haftalık satış özeti#

Zamanlama (pazartesi 09:00) → Gumroad → List sales (After: geçen haftanın tarihi, Max sales 100) → Rapor oluştur (satış sayısı ve en çok satan ürünler).

Tetikleyici nasıl çalışır?#

• Gumroad her satışta abonelik adresine form biçiminde (application/x-www-form-urlencoded) bir bildirim gönderir. OrqLabs adresteki gizli parametreyi sabit zamanlı karşılaştırmayla doğrular; parametre yoksa veya yanlışsa istek reddedilir.
• Aynı satış için tekrar gelen bildirimler ikinci kez akış başlatmaz (saleId).
• Üyelik yenilemeleri yeni bir saleId ile gelir ve isRecurringCharge alanı true olur.
• Gumroad'ın Settings → Advanced → Ping alanı ayrı bir özelliktir; OrqLabs onu kullanmaz, doldurmanız gerekmez.

Limitler#

Bağlantıyı test etme#

Bağlantıyı test et Gumroad hesabınızın adını ve e-postasını gösterir. Tetikleyiciyi denemek için bir ürününüzü %100 indirim koduyla kendiniz satın alın ve iş akışının Çalıştırmalar sekmesine bakın.

Kimlik bilgilerini yenileme#

Gumroad'da Settings → Advanced → Applications altında yeni anahtar üretin → OrqLabs'ta ayrıntı panelinden Kimlik bilgileri → Güncelle. Uygulamayı silerseniz satış aboneliği de durur; bu durumda entegrasyonu silip yeniden bağlayın.

Sık karşılaşılan hatalar#

Sık sorulan sorular#

Gumroad bildirimlerini neden imzalamıyor? Gumroad'ın satış bildirimleri imza içermez. Güvenlik, yalnızca OrqLabs'ın ve Gumroad'ın bildiği gizli parametreyle sağlanır.

Ücretsiz (0 TL / $0) ürünler de olay üretir mi? Evet; Gumroad ücretsiz indirmeleri de satış olarak bildirir, total 0 olur.

Alıcının e-postasına pazarlama mesajı gönderebilir miyim? Yalnızca alıcı izin verdiyse; canContact alanı alıcının iletişime izin verip vermediğini gösterir.

Sonraki adım#

• Patreon
• Lemon Squeezy
• Entegrasyonlara genel bakış