Integrate Perfect Day into Shopify.

Step 1 — Create product in the Shopify admin

1. One Shopify product per coupon

   Shopify admin → Products → Add product. Enter the title, description, price, and images — just like with any other product. „"Save"" click.

Step 2 — Attach coupon ID to the product as a metafield

To ensure Shopify knows which platform coupon belongs to this product, you store the coupon ID as a meta field.

1. Create metafield definition once

   Shopify admin → Settings → Custom data → Products → „Add definition". Fields:

   • Name: Perfect Day Coupon ID
   • Namespace and key: perfectday.coupon_id
   • Type: Integer (one value)

   Saving — this definition now applies to all products.

2. Enter coupon ID for each product

   In the product editor, scroll down to the block. „"Metafields"" → „"Perfect Day Coupon ID"" → Enter value (e.g. 15114) → „Save". The product is now linked to the platform coupon.

Step 3 — Set up Bridge (one of three options)

This is where Shopify alone isn't enough. Choose the option that fits your Shopify plan.

1. Option A — Shopify Flow (Plus/Advanced Plan)

   If you have Shopify Plus or Advanced, Shopify Flow Already on board. Shopify admin → Apps → Shopify Flow → „Create workflow" → Template „"Order paid"". Add a „"Run code""-Action added with the following script:

   View full code — JavaScript · Flow „Run code"

   JavaScript Flow „Run code"

   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. Option A — Append HTTP Request Action

   Then a „"Send HTTP request""-Action: Method POST, URL https://plattform.deinperfectday.de/wp-json/perfectday/shop/webhook/order, Body {{ steps.code.payload | json }}. Header:

   HTTP headers

   Content Type: application/json Authorization: Basic

3. Create Base64 authentication

   You generate the authorization value on Mac/Linux in the terminal — the result appears after basic in the header. Then the workflow activate.

   Bash

   echo -n "YOUR_USERNAME:YOUR APP PASSWORD" | base64

4. Option B — Bridge via Make.com / Zapier (any plan)

   Are you using Shopify Basic/Starter without Flow? Create at make.com or Zapier a workflow — trigger „"Watch Orders (Paid)"", Action 1 „"Get a Product"" (retrieves the metafield), Action 2 „"HTTP → Make a request"" Using Basic Auth to the webhook URL. You can get a detailed screen recording upon support request.

5. Option C — Custom Cloud Function

   For tech-savvy providers: a custom Cloud Function (Vercel / Cloudflare Workers / AWS Lambda) that receives the Shopify webhook, retrieves the meta field, and passes it to the Perfect-Day webhook. We will send a complete code template upon support request.

Step 4 — Test order

1. Place and check order

   Place a test order in your Shopify store (use the bogus gateway if you don't want to trigger a real payment) and mark it as "paid". Then check:

   • Platform back office → Perfect Day → Shop orders: new order with shop_type=shopify?
   • Test customer mailbox: Did you receive the branded email with coupon codes and a print button?