Code
The
stripe-card-element and express-checkout-element slots are required for the checkout component to work.Props
Props should be passed as attributes to the component element.The message to display to prompt the user to sign in.Defaults to
Checkout faster by signing in and using saved detailsThe message shown to guests explaining they can create an account later.Defaults to
You can create an account once you have orderedFeatures
Background Colours
The checkout uses a split-panel layout. You can set separate background colours for the order summary (left) and checkout form (right) from your web component settings.Logo
Control how your store logo appears at the top of the checkout, including its position (left, centre, right) and height. Configured in web component settings.Phone Number Requirement
You can require customers to enter a phone number during checkout. This is useful for delivery notifications and fulfilment providers that need a contact number. Toggle this in web component settings.Referral Sources
Ask customers “How did you hear about us?” during checkout. You can configure the list of options, add follow-up questions, and auto-tag customers based on their response. This data feeds into your Attribution insights. Set up in web component settings.Custom Questions
If you’ve set up custom checkout fields, they’re asked on the details step and stored against the order and the customer. A returning customer’s previous answers are filled in for them.A required custom question hides the Apple Pay and Google Pay shortcut at the top of checkout in any market where it applies, since the question can only be answered on the checkout page itself. Both are still offered at the payment step.
Order Confirmation
Once an order is placed, the checkout renders the confirmation in the same split layout as the checkout itself: the receipt on one side and an order summary on the other. It can also carry:- Rewards - a band showing what the order earned, when rewards are switched on. Its colours and corners are set in web component settings.
- Create an account - guests are offered a single password field that turns the order they just placed into an account. See below.
- How did you hear about us? - asked here when the order has no answer yet, if you’ve turned it on. See Referral Sources.
Create an Account
Guest checkout already attaches the order to a customer record, but without a password the shopper can’t sign in to see it. The confirmation page offers a password field to finish the job. Everything else is already on the order, so nothing is retyped. A verification code is emailed straight away, and the account area stays closed until it’s entered. The wording is editable in web component settings.The block doesn’t appear for a shopper who checked out signed in, or whose email address already has an account.
Gifting
With gifting turned on, the delivery step opens by asking who the order is for. Choosing someone else collects their delivery address and then asks whether the order is a gift, which adds a step for the message, the recipient’s details, the date to deliver after and the date to tell them. Where the order includes a subscription, the date to deliver after can’t be later than its first shipment, so the email explaining the parcel arrives before it does. The date picker stops there, and a line under it names the date, for example “Choose a date on or before 18 November, when their first shipment goes.” Where the order includes a subscription, the billing step then asks how the gift is paid for: They take it over, Gift a set number (with How many, from the numbers you offer) or Keep gifting it. The giver pays for the first shipment at checkout and each of the rest as it’s sent. See Gift subscriptions. Every heading, option and note on those steps is editable under Checkout Section Labels. See Gift orders for how the dates behave.Delivery Choices
The delivery step’s two-way choices, Myself or Someone else and Ship or Pickup, are each a box of their own. The chosen side takes the Selected Option Background and Selected Option Border colours from the Collection tab, the same as the product page’s option rows, and falls back to your muted background with a primary border. Choosing a collection point, or an address in another country, can move the order onto stock held somewhere else. If that location can’t supply everything in the basket, the basket is cut down to match, and checkout says what was taken out in a notification that stays until the shopper closes it. If nothing is left, the shopper is sent back to the cart, where the note explains why.Subscriptions at Checkout
Where the order includes a subscription, a line under the card form says the card will be kept to pay for the renewals. Word it yourself with Saved card message under Checkout Section Labels. A package whose shipments go out on their own dates sends nothing with the order that joins it, so no delivery is charged for it at checkout. The address is still asked for, and the summary shows what each shipment will be charged for delivery when it ships, or that delivery is included. When nothing else in the order ships today, a note under the summary says nothing is sent today. Set the wording with the Subscription Delivery labels on the Labels tab. A Fixed package is listed by name, without a quantity, on the order summary and the order confirmation.Gift Vouchers
A gift voucher code is entered in the same box as a discount code. Marzipan recognises a voucher by its checksum, applies it as stored value, and charges the card the difference.Where a voucher covers a repeating order in full, checkout still asks for a card for the deliveries after the first one, since nothing is being charged today and the renewals would otherwise have nothing to bill. The wording of that explanation is yours to set under Card for Future Deliveries.

