Overview
The Join Markt Embed SDK drops modal checkout onto an external merchant site. Buyers stay on the merchant page; payment and delivery still run on Join Markt hosted checkout inside an iframe.window.Markt and alias window.MarktEmbed.
Local demo:
Quick start
Data attributes
JavaScript API
Markt.init
[data-markt-product-id], observes late nodes, listens for close messages.
Markt.open
items[0] is sent. Multi-item carts are not supported in embed — use storefront checkout start instead.
Markt.close
Hides the overlay and blanks the iframe.Server round-trip
open POSTs to Create Embed Checkout and loads the returned URL (?embed=1&theme=...) in the iframe.
Rate limit: 30 requests / 60 seconds per client.
Close protocol
Checkout posts to the parent:returnUrl is present, parent navigates there.
Affiliates
- Explicit
affiliateCode ?ref=on the merchant pagemarkt_affiliatecookie
referralCode.
CSP
frame-ancestors * on /embed/* and /checkout/*.
Constraints
- Private / on-hold products rejected
- Variants required when the product defines them
- Quantity clamped 1-99
- Debounce clicks to stay under the rate limit