İçeriğe atla
 Shopify · 15-20 dk · orta

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

  1. 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.

  1. 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.

  2. 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.

  1. 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"
    JavaScript Akışı „Kod Ç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
        }
      };
    }
  2. Seçenek A — HTTP İsteği Eylemini Ekle

    Sonra bir „"HTTP isteği gönder""-Eylem: Yöntem POSTALAMAK, URL https://plattform.deinperfectday.de/wp-json/perfectday/shop/webhook/order, Vücut {{ steps.code.payload | json }}. Başlık:

    HTTP başlıkları
    İçerik Türü: application/json Yetkilendirme: Temel
  3. Base64 kimlik doğrulaması oluşturun

    Mac/Linux'ta yetkilendirme değerini terminalde oluşturursunuz; sonuç daha sonra görünür. temel Başlıkta. Sonra iş akışı. etkinleştir.

    Bash
    echo -n "KULLANICI ADINIZ:UYGULAMA ŞİFRENİZ" | base64
  4. 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.

  5. 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ı

  1. 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ı?
Bir şey sıkışmışsa

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.

Kurulum hizmeti

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.

Sıkça Sorulan Sorular

Hâlâ sorularınız var mı?

Köprüye neden ihtiyacım olsun ki?
Shopify'ın yerleşik sipariş webhook'u ürün meta alanlarını otomatik olarak sağlamaz. Köprü (Flow, Make.com veya Cloud Function), kupon kimliğini içeren meta alanını alır ve doğru webhook gövdesini oluşturmak için kullanır.
En basit seçenek hangisi?
Seçenek A (Shopify Flow): Eğer Plus veya Advanced paketiniz varsa, her şey Shopify'ın içinde yer alır. Aksi takdirde, Seçenek B (Make.com): Ücretsiz plan çoğu mağaza için yeterlidir, kod yazmaya gerek yoktur.
Bridge'de uygulama şifresi güvende mi?
Bunu asla herkese açık olarak paylaşmayın (GitHub'da veya ekran görüntülerinde paylaşmayın). Her mağaza için ayrı bir uygulama şifresi kullanın, böylece bireysel bağlantıları seçici olarak engelleyebilirsiniz. Webhook URL'si herkese açık olsa da, geçerli kimlik doğrulaması olmayan tüm istekleri 401 hatasıyla reddeder.

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