Siparişleri Zapier, Make ve diğer uygulamalara webhook’larla gönderin

Bir webhook, mağazanızdaki olayları gerçekleştikleri anda başka bir uygulamaya gönderir. Bir tane ekleyin; ödenen her sipariş Zapier’e veya Make’e, oradan da Google Sheets’e, Slack’e, e-posta listenize, muhasebe uygulamanıza ve binlerce uygulamaya daha ulaşabilir. Kod yazmanız gerekmez.

Webhook ekleme

1. Site panelinizde Entegrasyonlar’a tıklayın.
2. Otomasyon altında Webhook’lar seçeneğini açın. Bir pencere açılır.

   

3. Olay alanından bir olay seçin, uygulamanızın verdiği adresi Webhook adresi alanına yapıştırın ve Webhook ekle düğmesine tıklayın.
4. Örnek bir sipariş göndermek için Test gönder düğmesine, ardından Bitti düğmesine tıklayın.

   

Webhook’lar eklediğiniz anda çalışmaya başlar. Yayınlamanız gerekmez.

Zapier’e bağlanma

1. Zapier’de bir Zap oluşturun. Tetikleyici olarak Webhooks by Zapier seçeneğini, ardından Catch Hook seçeneğini seçin.
2. Zapier’in gösterdiği webhook URL’sini kopyalayın.
3. Payly’de Sipariş ödendi olayı için bir webhook ekleyin ve bu URL’yi yapıştırın.
4. Test gönder düğmesine tıklayın. Zapier’e dönüp Test trigger düğmesine tıklayın. John Smith için #9999 numaralı örnek siparişi göreceksiniz.
5. İstediğiniz eylemi ekleyin, örneğin Google Sheets’te yeni bir satır, ve alanları eşleştirin: Order Number, Order Total, Order Customer Email ve diğerleri.
6. Zap’i yayınlayın. Artık ödenen her sipariş onu çalıştırır.

Webhooks by Zapier, Zapier’in premium uygulamalarından biridir; bu yüzden ücretli bir Zapier planı gerekir.

Make’e bağlanma

1. Make’de bir senaryo oluşturun. Webhooks modülünü, ardından Custom webhook modülünü ekleyin ve yeni bir webhook oluşturmak için Add düğmesine tıklayın.
2. Make’in gösterdiği adresi kopyalayın.
3. Payly’de bu adresle bir webhook ekleyin ve Test gönder düğmesine tıklayın. Make örneği okur ve alanları öğrenir.
4. İstediğiniz modülleri ekleyin, alanları eşleştirin ve senaryoyu açın.

Olaylar

• Sipariş ödendi: bir sipariş ödenir. Buna bir aboneliğin ilk ödemesi, her yenilenme ve elle ödenmiş olarak eklediğiniz sipariş de dahildir.
• Sipariş kargolandı: bir siparişi kargolandı olarak işaretlersiniz. Bir siparişi parça parça gönderdiğinizde her sevkiyat için ayrı bir olay gönderilir.
• Sipariş iade edildi: para geri gider; iadeyi Payly’de ya da Stripe veya PayPal üzerinden yapmanız fark etmez. Her kısmi iade de gönderilir.
• Abonelik başladı: bir aboneliğin ilk siparişi.
• Abonelik yenilendi: ilkinden sonraki her ödeme.
• Abonelik sona erdi: bir abonelik iptal edilir veya süresi dolar, bittiği gün.

Payly neler gönderir

Her olay JSON olarak gönderilir. Her sipariş olayı şunları içerir:

• Sipariş numarası (örneğin #1000), durumu ve ne zaman ödendiği
• Ara toplam, indirim ve indirim kodu, kargo, vergi, toplam ve iade edilen tutar, para birimiyle birlikte
• Her ürünün adı, SKU’su, adedi, fiyatı ve satır toplamı
• Müşterinin adı, e-postası ve telefonu ile teslimat adresi
• Ödemenin nasıl yapıldığı, örneğin Stripe veya PayPal
• test_mode, test modunda verilen bir sipariş için true olur

Kargolar, kargo şirketini ve takip numarasını ekler. İadeler, o ana kadar iade edilen toplamı ekler. Abonelik olayları planı, fiyatını, ne sıklıkla faturalandığını ve bir sonraki yenilenme tarihini ekler. Test gönder düğmesiyle gönderilen bir örnekte "test": true bulunur. Kart numaraları Stripe ve PayPal’da kalır, bu yüzden hiçbir webhook’ta yer almaz.

Bir webhook başarısız olursa

Bir uygulamanın yanıt vermek için 5 saniyesi vardır. Yanıt vermezse veya hata verirse Payly yaklaşık dört buçuk saat boyunca en fazla 7 kez daha dener. Webhook’lar penceresi her webhook’un son iletimlerini listeler; böylece ne olduğunu görebilirsiniz.

Arka arkaya üç olay her denemede başarısız olursa webhook duraklatılır ve Entegrasyonlar ekranı bunu belirtir. Adresi kontrol edin, ardından Yeniden aç düğmesine tıklayın.

Bir webhook’un mağazanızdan geldiğini doğrulama

Zapier ve Make için buna gerek yoktur. Kendi uygulamanızı geliştiriyorsanız her istekte bir X-Payly-Hmac-Sha256 başlığı bulunur: istek gövdesi, mağazanızın imzalama anahtarıyla HMAC-SHA256 kullanılarak imzalanır ve base64 olarak yazılır. Anahtar Webhook’lar penceresindedir. Aynı imzayı ham gövdeden hesaplayın ve ikisini karşılaştırın.

X-Payly-Webhook-Id başlığı, bir iletim yeniden denendiğinde aynı kalır; böylece uygulamanız daha önce işlediği bir iletimi atlayabilir.