Shopify Integration

Deeply integrated with Shopify from install to fulfillment.

Transfer Kingdom POD is a Shopify embedded app that lives inside your Shopify Admin. The integration handles product publishing, order ingestion, fulfillment sync, and storefront design experiences automatically.

What happens when you install:

Our system automatically configures your store with:

  •  A "Transfer Kingdom POD" fulfillment service so orders route correctly.
  • A dedicated shipping location (ships-only, no inventory tracking).
  • A delivery profile with US zone rates and flat-rate shipping methods.
  • A tk_pod.managed metafield to track which stores Transfer Kingdom POD manages.
  • Online Store publication access for automatic product publishing.

All of this is idempotent: reinstalling or reconnecting won't create duplicates.

Theme extension (storefront blocks):

Two blocks are included for your Shopify theme:


  • Designer Button (product pages): A "Create Gang Sheet" button that opens the designer with the right product template, presets, and configuration pre-loaded. It reads tk_pod.product_ref and tk_pod.config metafields and only appears on Transfer Kingdom POD-managed products. 
  • Cart Design Preview (cart page): Shows design thumbnail previews and an "Edit" link for each POD item in the cart. Uses secure, first-party URLs.

How the cart bridge works:

When a customer finishes designing and clicks "Add to Cart":

  1.  The design and preview/export files are saved to secure storage
  2.  A one-time-use bridge URL is generated via Redis.
  3.  The customer is redirected through Shopify's App Proxy to a first-party /cart/add form, which ensures cookies and sessions work correctly (no cross-domain issues).
  4.  Line items include _tk_* properties linking back to the design, which are used for order processing.

Order flow (Shopify to Transfer Kingdom POD):

  1.  Customer checks out on your Shopify store.
  2.  Shopify fires an orders/create webhook, the Transfer Kingdom POD app verifies the HMAC signature and forwards it to our API with an internal secret.
  3.  Our API processes the order with idempotency (duplicate webhooks are safely ignored), maps _tk_* line item properties to design references, and creates a Transfer Kingdom order with the correct status.
  4.  Design export files are generated server-side (or skipped for gang sheets where the upload is production-ready).
  5.  After production and shipping, fulfillment and tracking information are pushed back to Shopify automatically via the Fulfillment Order API, and your customer is notified.

Supported webhook events:

  •  orders/create, orders/updated, orders/paid, orders/cancelled
  •  products/update, products/delete (syncs changes to linked Transfer Kingdom products)
  •  shop/update, domains/* (keeps store metadata current)
  •  app/uninstalled (marks connection as disconnected; data retained for 48h grace period and GDPR compliance)
  •  GDPR compliance webhooks (customer data request, customer redact, shop redact)

Product publishing

From the "My Products" page in the Shopify app, select a catalog template, publish it, and the system creates the Shopify product with media, variants, and correct delivery profile associations. Post-publish, the product is automatically published to your Online Store sales channel.

Still Need Help?

Our technical experts are available to assist you with any questions or specific production needs.

Average response time: under 24 hours