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":
- The design and preview/export files are saved to secure storage
- A one-time-use bridge URL is generated via Redis.
- 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).
- Line items include _tk_* properties linking back to the design, which are used for order processing.
Order flow (Shopify to Transfer Kingdom POD):
- Customer checks out on your Shopify store.
- 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.
- 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.
- Design export files are generated server-side (or skipped for gang sheets where the upload is production-ready).
- 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
Still Need Help?
Our technical experts are available to assist you with any questions or specific production needs.