Shopify Integration
Install the Croissant app from the Shopify App Store and start accepting Croissant Pay at checkout in about 15 minutes. No custom code required.
Tip
The Shopify integration is fully managed. Discount functions, webhooks, and order processing are handled automatically. You do not need to implement webhooks or call any REST APIs.Prerequisites
- A Shopify store with admin access
- Checkout extensibility enabled (Shopify Plus required)
- A Croissant merchant account — contact partnerships@croissant.com to get started
Installation
- Install the Croissant app from the Shopify App Store.
- Authorize the required permissions when prompted. The app requests access to read orders, products, customers, and write discounts.
- On first load, the app automatically creates the required discount functions and installs the checkout UI extension.
What Gets Installed
The Croissant Shopify app sets up several components automatically:
| Component | Purpose |
|---|---|
| Checkout UI Extension | Renders the “Pay with Croissant” button block in your checkout |
| Incentive Discount Function | Applies first-order incentive (e.g., $100 off $500+) |
| Credit Discount Function | Applies the customer's available Croissant credit |
| Authorized Discount Function | Applies the authorized card payment amount |
| Shipping Discount Function | Provides free shipping for Croissant Pay orders |
| Web Pixel | Analytics tracking for Croissant Pay interactions |
How It Works at Checkout
1Customer reaches Shopify checkout and sees the “Redeem Croissant Credit” block alongside other payment options.
2Customer clicks the button and is redirected to the Croissant hosted checkout.
3After authorization, the customer is returned to Shopify checkout. The extension reads the AUTHORIZED session and writes discount amounts to a cart metafield.
4Four server-side discount functions read the metafield and apply the correct discounts.
5Customer completes checkout at $0 (or reduced amount). The order is created in Shopify as normal.
Order Processing
Shopify webhooks are routed to Croissant via AWS EventBridge automatically. The following events are handled:
| Shopify Event | What Croissant Does |
|---|---|
orders/paid | Captures the authorized payment and settles the session |
orders/cancelled | Voids the session and releases any card hold |
refunds/create | Processes refund back to customer's payment method and adjusts credit |
returns/process | Handles return flow and credit adjustments |
Info
You manage returns, cancellations, and refunds through your normal Shopify admin workflow. Croissant is notified automatically.Non-USD Checkout
Croissant Pay currently supports USD only. The checkout extension automatically hides itself for non-USD checkout sessions.
For non-Shopify platforms, see the Custom Integration Guide →