Lemon Squeezy'yi Shopify Flow'a nasıl bağlayabilirim?

Lemon Squeezy, dijital ürünler ve abonelikler satar ve her sipariş, abonelik ve lisans değişikliği hakkında sizi bilgilendirir. Workflow Webhooks, bu bildirimi bir Shopify Flow tetikleyicisine dönüştürür; böylece mağazanız buna tepki verebilir: bir müşteriye etiket ekleyebilir, sipariş notu ekleyebilir, dahili bir e-posta gönderebilir, bir meta alanı güncelleyebilir - kısacası Shopify Flow’un yapabileceği her şeyi gerçekleştirebilir.

Bu kılavuz, tüm süreci ortaya koymaktadır: Lemon Squeezy gönderir, Workflow Webhooks alır ve doğrular, Shopify Flow harekete geçer. Her istekte Lemon Squeezy’nin HMAC imzası kontrol edildiğinden, iş akışınızı yalnızca Lemon Squeezy başlatabilir.

Neler yapabileceğiniz

• Aynı zamanda bir dijital ürün satın almış olan Shopify müşterisini etiketleyin, böylece paketler ve segmentler birbiriyle uyumlu hale gelsin.
• Etkin lisans kademesini bir meta alan olarak müşteri kaydına girin.
• Son zamanlarda Shopify siparişleri olan bir müşteri aboneliğini iptal ettiğinde ekibinize e-posta gönderin.

Gönderilebilecek tipik olaylar: order_created, subscription_created, subscription_cancelled, license_key_created.

Başlamadan önce

• Shopify mağazanıza yüklenmiş Workflow Webhooks.
• Shopify Flow, Shopify Uygulama Mağazasından ücretsiz olarak indirilip kuruldu.
• Lemon Squeezy'de webhook oluşturma iznine sahip bir hesap.

1. Adım - Workflow Webhooks'ta webhook'u oluşturun

1. Workflow Webhooks'u açın -> Webhooks -> Webhook oluştur seçeneğine tıklayın ve Shopify Flow'da kolayca tanıyabileceğiniz bir ad verin; örneğin Lemon Squeezy events gibi.
2. Kimlik Doğrulama bölümünden HMAC'yi seçin.
3. Signature provider (İmza sağlayıcısı) bölümünden Lemon Squeezy’yi seçin. Uygulama, başlık, algoritma, imzalı yük ve tekrar oynatma aralığını sizin için otomatik olarak doldurur; ayarlanacak başka bir şey yoktur.
4. Şimdilik gizli alanı boş bırakın ve Kaydet'e tıklayın. Sayfada gösterilen webhook URL'sini kopyalayın.

Diğer kimlik doğrulama modları için Kimlik Doğrulama’a, hangi alanların Shopify Flow’a aktarılacağını seçmek için ise Yük haritalama ve Shopify Flow değişkenleri’a bakın.

2. Adım - Lemon Squeezy'ye uç noktayı ekleyin

Lemon Squeezy'de Ayarlar -> Webhook'lar'ı açın, kopyaladığınız URL ile bir webhook ekleyin, olayları seçin ve bir imzalama gizli anahtarı girin.

Lemon Squeezy imza sırrını nasıl bulursun?

Webhook'u oluştururken girdiğiniz imza gizli anahtarı.

Lemon Squeezy'nin webhook imzalarıyla ilgili kendi belgeleri, hesabınız için tam metni ve ekran görüntülerini içeriyor.

Bu gizli anahtarı, Workflow Webhooks bölümündeki webhook’un “Secret” alanına yapıştırın ve kaydedin. O andan itibaren her Lemon Squeezy teslimatı, Shopify Flow’a ulaşmadan önce doğrulanacaktır.

Bu kontrolün amacı

Ne	Değer
İmza başlığı	X-Signature
İmzanın bulunduğu yer	Başlığın tamamı
Neyin imzalandığı	{body}
İmza	HMAC-SHA256, onaltılık kodlanmış
Zaman damgası	Bu gönderen tarafından kullanılmamaktadır
Tekrar oynatma koruması	Yok - bu gönderen zaman damgasını imzalamadığından, tüm geçerli imzalar geçerliliğini korur
Sır	Düz metin olarak kullanılır. Göndericinin gösterdiği şekilde aynen yapıştırın.

İmzalı yükte, {body}, bayt bayt ham istek gövdesidir.

Bu şartlardan herhangi birini karşılamayan bir istek, 401 hatasıyla reddedilir, Geçmiş ve sorun giderme bölümüne kaydedilir ve hiçbir zaman bir iş akışını başlatmaz.

3. Adım - Shopify Flow iş akışını oluşturun

1. Shopify Flow'da bir iş akışı oluşturun ve Workflow Webhooks tetikleyicisini seçin.
2. Olayları Kaydet seçeneğine basın, ardından Lemon Squeezy’den bir test olayı gönderin (ya da Workflow Webhooks içindeki Test Gönder seçeneğini kullanın), böylece Shopify Flow verilerinizin yapısını öğrenebilir.
3. Sahip olduğunuz her webhook aynı Shopify Flow tetikleyicisini çalıştırır; bu nedenle, bu iş akışını yalnızca Lemon Squeezy ile sınırlı tutmak için **webhook **kimliğine ilişkin bir ilk koşul ekleyin. Kimlik, webhook sayfasında gösterilir.
4. İşlemlerinizi ekleyin - bir müşteriyi etiketleyin, bir not ekleyin, şirket içi bir e-posta gönderin, bir meta alanı güncelleyin.

4. Adım - Baştan sona test edin

Lemon Squeezy'de gerçek bir olayı tetikleyin. Workflow Webhooks → History bölümünde, Success durumuna sahip bir çağrı görmelisiniz. İmza yanlışsa, bunun yerine nedeni belirtilen bir hata kaydı alırsınız ve İmzalı webhook'ların doğrulanması, hangi adımın başarısız olduğunu tam olarak gösteren imza denetleyicisini açıklar.

İlgili

• İmzalı webhook'ların doğrulanması - doğruladığımız her sağlayıcı ve doğrulamadığımız bir sağlayıcıyı nasıl tanımlayacağımız.
• Yük haritalama ve Shopify Flow değişkenleri - yükten doğru alanları alıp Shopify Flow'a aktarma.
• Yinelenen teslimat koruması - Lemon Squeezy bir teslimatı yeniden denediğinde ne olur?
• Geçmiş ve sorun giderme - her isteğin günlüğü; tekrar oynatma özelliği ile.