Perfect Day'i Shopify'a entegre edin.
Shopify mağazanız üzerinden Perfect Day kuponlarınızı satabilirsiniz. Tek zor kısım: Shopify'ın yerleşik webhook'u meta alanları içermiyor; bunun için küçük bir köprüye ihtiyacınız olacak. Size en basitten en esnek olana doğru üç yol göstereceğiz.
Önceden gerekli olanlar: Bir kere git genel hazırlık Bu işlem, bir kupon oluşturmayı, uygulama şifresini almayı ve webhook URL'sini sağlamayı içerir. Yaklaşık beş dakika sürer ve tüm mağaza sistemleri için geçerlidir.
Adım 1 — Shopify yönetim panelinde ürün oluşturun
-
Kupon başına bir Shopify ürünü.
Shopify yönetici paneli → Ürünler → Ürün ekle. Başlığı, açıklamayı, fiyatı ve görselleri girin; tıpkı diğer ürünlerde olduğu gibi. „"Kaydetmek"" tıklamak.
Adım 2 — Kupon kimliğini ürüne meta alan olarak ekleyin.
Shopify'ın bu ürüne hangi platform kuponunun ait olduğunu bilmesini sağlamak için, kupon kimliğini bir meta alan olarak saklarsınız.
-
Metaalan tanımını bir kez oluşturun.
Shopify yönetici paneli → Ayarlar → Özel veriler → Ürünler → „Tanım ekle". Alanlar:
- İsim:
Mükemmel Gün Kupon Kimliği - Ad alanı ve anahtar:
mükemmel gün.kupon_kimliği - Tip: Tam sayı (tek değer)
Tasarruf — bu tanım artık tüm ürünler için geçerlidir.
- İsim:
-
Her ürün için kupon numarasını girin.
Ürün düzenleyicisinde, aşağı kaydırarak ilgili bloğa ulaşın. „"Metaalanlar"" → „"Mükemmel Gün Kuponu"" → Değer girin (örneğin.
15114) → „Kaydet". Ürün artık platform kuponuna bağlı.
3. Adım — Briç oyununu kurun (üç seçenekten biri)
İşte bu noktada Shopify tek başına yeterli olmuyor. Shopify planınıza uygun seçeneği belirleyin.
-
Seçenek A — Shopify Flow (Plus/Gelişmiş Plan)
Shopify Plus veya Advanced sürümüne sahipseniz, Shopify Akışı Zaten katıldım. Shopify yönetici paneli → Uygulamalar → Shopify Akışı → „İş akışı oluştur" → Şablon „"Sipariş ödendi"". Ekle „"Kodu çalıştır""-Aşağıdaki komut dosyasıyla işlem eklendi:
Kodun tamamını görüntüle — JavaScript · Flow „Kodu çalıştır"
export default function transform(input) { const order = input.order; const items = order.lineItems.nodes .filter(li => li.product?.metafield?.value) .map(li => ({ coupon_id: parseInt(li.product.metafield.value, 10), count: li.quantity })); if (items.length === 0) return { skip: true }; return { payload: { shop_order_id: String(order.name), shop_type: "shopify", shop_domain: order.shop?.myshopifyDomain || "shop", customer: { email: order.customer?.email || order.email, name: `${order.customer?.firstName || ''} ${order.customer?.lastName || ''}`.trim(), locale: order.customerLocale || "de" }, items, order_total_cents: Math.round(parseFloat(order.totalPriceSet.shopMoney.amount) * 100), currency: order.totalPriceSet.shopMoney.currencyCode, placed_at: order.processedAt } }; } -
Seçenek A — HTTP İsteği Eylemini Ekle
Sonra bir „"HTTP isteği gönder""-Eylem: Yöntem
POSTALAMAK, URLhttps://plattform.deinperfectday.de/wp-json/perfectday/shop/webhook/order, Vücut{{ steps.code.payload | json }}. Başlık:İçerik Türü: application/json Yetkilendirme: Temel -
Base64 kimlik doğrulaması oluşturun
Mac/Linux'ta yetkilendirme değerini terminalde oluşturursunuz; sonuç daha sonra görünür.
temelBaşlıkta. Sonra iş akışı. etkinleştir.echo -n "KULLANICI ADINIZ:UYGULAMA ŞİFRENİZ" | base64 -
Seçenek B — Make.com / Zapier üzerinden köprü (herhangi bir plan)
Shopify Basic/Starter sürümünü Flow olmadan mı kullanıyorsunuz? Şuradan oluşturun: make.com veya Zapier iş akışı tetikleyicisi „"İzleme Siparişleri (Ücretli)"", Eylem 1 „"Bir Ürün Edinin"" (meta alanı alır), Eylem 2 „"HTTP → İstek gönder"" Webhook URL'sine Temel Kimlik Doğrulama (Basic Auth) kullanılarak erişim sağlanıyor. Destek talebi üzerine detaylı ekran kaydı alabilirsiniz.
-
Seçenek C — Özel Bulut Fonksiyonu
Teknolojiye yatkın sağlayıcılar için: Shopify webhook'unu alan, meta alanını alan ve bunu Perfect-Day webhook'una ileten özel bir Bulut Fonksiyonu (Vercel / Cloudflare Workers / AWS Lambda). Destek talebi üzerine eksiksiz bir kod şablonu göndereceğiz.
Adım 4 — Test sırası
-
Sipariş verin ve kontrol edin.
Shopify mağazanızda bir test siparişi verin (gerçek bir ödeme tetiklemek istemiyorsanız sahte ödeme ağ geçidini kullanın) ve "ödendi" olarak işaretleyin. Ardından kontrol edin:
- Platform arka ofisi → Mükemmel Gün → Mağaza siparişleri: yeni sipariş ile
shop_type=shopify? - Müşteri e-posta kutusu testi: Kupon kodları ve yazdırma düğmesi içeren markalı e-postayı aldınız mı?
- Platform arka ofisi → Mükemmel Gün → Mağaza siparişleri: yeni sipariş ile
Sorun giderme.
Webhook 401 hatası veriyor — kimlik doğrulama gerekli
Yanlış kullanıcı adı — bu WordPress kullanıcı adı (kullanıcı_girişiSorun e-postada değil, şifrenizde olabilir. Ya da uygulama şifresi iptal edilmiş veya yanlış kopyalanmış olabilir. Şüpheniz varsa, yeni bir şifre oluşturun.
Webhook 403 hatası döndürüyor — forbidden_coupon
O kupon_kimliği Metaalan, platformunuzun arka ofisinde mevcut değil veya başka bir sağlayıcıya ait. Lütfen aşağıdaki bölüme bakın. Kuponlar, Kimlik bilgisinin orada görünüp görünmediği.
Webhook 400 hatası döndürüyor — doğrulama
JSON gövdesinde eksik veya geçersiz alanlar. Sık karşılaşılan durumlar: müşteri.e-posta Bu bilgi eksik çünkü müşteri misafir olarak sipariş verdi. Bu durum iş akışında/süreçte tespit edilmelidir.
Sipariş işlemi tamamlanıyor ancak müşteriye e-posta gelmiyor.
Platformun arka ofisinde sipariş detaylarını açın ve e-posta durumunu kontrol edin. Kırmızı renk, bizim tarafımızda bir SMTP sorunu olduğunu gösterir; lütfen destek ekibiyle iletişime geçin. Aksi takdirde, müşterinin spam klasörünü kontrol edin.
Sipariş iki kez işleme alınacaktır.
Sorun yok, webhook'un tekrarlanabilirlik koruması var. İkinci denemede göreceksiniz. kopya: doğru Yanıtta, yinelenen kodlar oluşturulmaz ve yinelenen e-postalar gönderilmez.
Bunu sizin için biz mi kurmamızı tercih edersiniz?
Shopify'da köprü yapılandırması en zor kısımdır. Shopify Flow veya Make.com iş akışınızı sizin için tamamen kuracağız; bize sadece geçici erişim izni vermeniz yeterli, gerisini biz halledeceğiz.
Hâlâ sorularınız var mı?
Köprüye neden ihtiyacım olsun ki?
En basit seçenek hangisi?
Bridge'de uygulama şifresi güvende mi?
Mağaza bağlantısı kuruldu — peki şimdi ne olacak?
Webhook çalışmaya başladıktan sonra, tüm siparişler otomatik olarak arka ofisinizde görünecektir. Başka bir bağlantıya ihtiyacınız varsa, her ek mağaza birkaç dakika içinde kurulabilir.
Mağaza genel görünümüne git