Shopify Integration

Installing the Croissant app takes a few minutes and sets up your discounts, pixel, and order webhooks automatically. It does not add anything to your storefront on its own — adding the checkout block and/or theme blocks is the real work, and it is yours to do.

Tip

You never implement a webhook endpoint or call a REST API for the Shopify integration. Budget your time for installation and theme fit instead — that is the only work that is genuinely per-store.

Before You Start

Three of these are set on Croissant's side and will silently produce a store where nothing renders if they are missed. Confirm them with your Croissant contact before you begin, not after.

Requirement	Why it matters
Shopify store with admin access	You need to install an app, edit the theme, and — on Plus — edit checkout
USD as a presentment currency	Croissant Pay is USD-only. Every surface hides itself in any other currency
Every store domain registered with Croissant	Croissant enables the integration per store domain. A dev, staging, or clone store is a separate domain and has to be registered on its own — otherwise nothing renders there
Your custom domain registered with Croissant	So shoppers return to it after authorizing. If Croissant does not have it, they come back on your `.myshopify.com` domain
The integration switched live on Croissant's side	Separate from installing the app. Until Croissant enables it, the app installs cleanly and the storefront shows nothing — see Going Live
Product Vendor field populated	Croissant reads the Shopify Vendor value as the brand for each cart line. Blank or inconsistent vendors degrade brand attribution

Supported Plans

Croissant Pay works on every paid Shopify plan. Shopify Plus is not required — it is only required for the checkout block, one of two ways to surface Croissant Pay. Your plan decides which surfaces are available; Croissant detects it automatically, so there is nothing to configure and nothing to tell us.

Plan	Available surfaces	Required for discounts to apply
Shopify Plus	Checkout block, plus cart and cart-drawer theme blocks	The checkout block — cart blocks alone will start a session that never discounts
Basic, Grow, Advanced	Cart and cart-drawer theme blocks. Shopify does not let apps add UI to checkout on these plans	At least one cart block — it carries the authorization into native checkout for you

Warning

The most common Plus misconfiguration: enabling only the theme blocks. The button works, the shopper authorizes, and no discount appears at checkout. On Plus, treat the checkout block as required and the cart blocks as optional extra reach.

If your storefront is headless — Hydrogen, or any custom front end — the theme blocks do not apply, since they rely on Liquid and Shopify's AJAX cart. Contact support@croissant.com and we will scope the integration with you.

What's Automatic vs. What You Set Up

Installing the app provisions your backend. It does not touch your storefront or checkout — those are separate, manual steps covered in Installation.

Automatic on install	You set up
Five automatic discounts	The checkout block (Plus)
Web pixel	The theme blocks — cart, cart drawer, info modal (all plans)
Order webhooks	Styling and placement to match your theme

Warning

The five discounts appear in Discounts in your admin. Do not rename or delete them — Croissant matches them by title, so a rename reads as missing and gets recreated, leaving you with duplicates. To change what a shopper sees on their order summary, talk to Croissant.

How It Works

1The shopper sees the Croissant button in the cart, cart drawer, or checkout, with any offer they qualify for shown beneath it.

2Clicking it sends the shopper to Croissant's hosted session with their cart, where they sign in, choose how much credit to redeem, and authorize a card for the remainder.

3Croissant returns them to your store — into checkout on Plus, or back to the cart on other plans. This is not configurable.

4The Croissant block switches to its authorized state, showing what the shopper redeemed and what they are earning back.

5Shopify applies the Croissant discounts — one line per component that applies: incentive, credit drop, credit, card authorization, and free shipping.

6The shopper completes checkout at the reduced amount. A normal Shopify order is created, and Croissant settles with you separately.

The session states behind steps 2 to 5 are documented under Session Lifecycle.

Info

Croissant Pay cannot be combined with a Shopify gift card. Gift cards are applied in checkout, so this surfaces in the checkout block on Plus: it replaces the button with an explanatory notice. The cart blocks have no visibility into applied gift cards and are unaffected.

Going Live

Croissant switches your integration live on its side, separately from installing the app. Until it does, every Croissant surface stays hidden: the app installs, the discounts are created — and the storefront renders nothing at all, even after you have added the blocks.

This is deliberate. It lets you install and place the blocks ahead of launch, then go live without another deploy. It also means “I set everything up and nothing appears” is usually this, not your selectors. The browser console tells you which of the two you are looking at — see Testing & Troubleshooting.

Non-USD Checkout

Croissant Pay supports USD only. Both the checkout block and the theme blocks hide themselves when the active presentment currency is anything else, so multi-currency and Markets stores are safe to install on — the button simply does not appear outside USD. This also covers third-party international checkout flows.