Checkout Block
The checkout block is the Croissant surface inside Shopify checkout. It requires Shopify Plus — Plus is the only plan Shopify allows apps to add UI to checkout on. On Plus, it is also the surface that applies the discounts, so treat adding it as required, not optional.
Info
Not on Plus, or want reach beyond checkout? The cart and cart-drawer theme blocks work on every plan — see Theme Blocks.Adding It
Go to Settings → Checkout → Customize and add the app block named Pay with Croissant Card. It defaults to the first wallet position; drag it anywhere in the checkout layout.
States
It renders four states, with no work on your part:
- Default — the Croissant button, with offer copy beneath it when the shopper qualifies.
- Authorized — a confirmation banner with the rewards earned, and an option to update the payment if the cart total changed after authorization.
- Gift card applied — an explanatory notice instead of the button.
- Hidden — while loading, outside USD, or when the integration is not live.
Settings
The checkout editor shows these fields empty, not pre-filled. Empty means the default in the last column.
| Setting | Options | Default |
|---|---|---|
| Display Variant | default (full block), simple_button (button only) | default |
| Button Type | primary, secondary, plain — Shopify's native checkout button styles | primary |
| Button Text | Free text | Redeem Croissant Credit |
| Button Logo | filled_dark, filled_light, transparent_light, transparent_dark | filled_dark |
| Show Button Logo | Boolean — off gives a text-only button | On |
| Info Modal Variant | steps (3-step explainer), covers (compact paragraph) | steps |
| Hide Offer | Boolean — suppresses the incentive line | Off |
| Show Border | Boolean — border, background, and padding around the block | On |
Warning
Placing the block does not, by itself, put a Croissant button in front of shoppers. It also stays hidden until Croissant switches your integration live — see Going Live.Next: Theme Blocks → cart and cart-drawer placement on any plan