API Reference

Croissant is an add-on that enables recommerce optionality on select items at the point of sale. Customers who opt in will be provided an option to move on from their items at a later date at a clear price, with no cost and no obligation on the part of the customer.

Croissant integrations are powered by two main components:

  • Croissant web components
  • Croissant Retailer API

After the merchant onboarding process has been completed, products may be synced with Croissant via the PUT /products resource. Once these products are added to Croissant, our eligibility and pricing models will update the products with eligibility and pricing information. This pricing information will drive the Croissant web components to display the Croissant badge and opt-in toggle when appropriate.

When a user completes a payment for an order, the POST /carts endpoint should be called to pass consumer cart/order information to Croissant. If the isOptedIn property in the POST /carts payload is true, the items in the cart will be added to their Croissant closet.

Once a cart has been created, it can be either cancelled or fulfilled. These actions may be performed via the POST /carts/{id}/cancel and POST /carts/{id}/fulfill endpoints.