Integration Guides

Sync Product Catalogue

Send your catalogue to Croissant to generate pricing and eligibility. The Croissant on-site messaging is only visible to customers when the product is eligible. This is accomplished by integrating implicitly with the Croissant Pricing API to determine eligibility and resale price at run time.

Product Feed

If your store has a product feed endpoint, simply provide us with that URL and we will automatically sync and subscribe to updates. You can provide the product feed URL in the "Product Catalogue and Pricing" of the Merchant Onboarding Questionnaire, or email us. We'll check every hour for changes and new data.

Manual API Sync

You can also manually update Croissant with updates and new product data using /products.

When to to call the /products endpoints:

  • syncing your product catalogue for the first time
  • any time updates are made to your catalogue. i.e. when new items are added or pricing changes

Sync Products PUT /products/{id}

Use your Retailer Access Token and the Croissant Products API to synchronize your online store's product catalog with Croissant. You will receive a response within 72 hours containing guaranteed resale values.

πŸ‘

You do not need to store Croissant resale values yourself. In the next step, you will use Croissant On-Site Messaging to GET Croissant resale prices onto your store pages.

All product network calls, including your first, will be a PUT to <https://api.retailer.croissant.com/v0/products/{id}>

After adding the products to Croissant, our eligibility and pricing models will update the product Croissant-eligibility and resale pricing information. This updated pricing information will trigger the Croissant on-site messaging to display an opt-in toggle when necessary.

Update products PUT /products/{id}

You will call the PUT /products/{id} endpoint again when you make updates to your store's catalogue. i.e. when new products are added or when prices change.


πŸ§ͺ Recipes

Example Product Sync: