Guides

1-Click Resale (URL-Based Integration)

Enable a seamless resale experience directly from your brand’s order history page by embedding a "Resell" button next to each eligible item. This lightweight URL-based integration connects your customers with resale partners in one click

🎯 Use Case

Allow customers to quickly list past purchases for resale with product data prefilled. The process is simple: a customer clicks “Resell” in their order history, and we pass the product ID via URL to a partner resale platform like Poshmark.

🔗 URL Format

To implement the resale button, create a link in the following format:

Using GTIN: https://cnnct.id/g/{insert_GTIN}/?r=resale
Using Internal ID: https://cnnct.id/o/27/i/{insert_Internal_ID}/?r=resale
Using Reference ID: https://cnnct.id/r/{insert_RefID}/?r=resale

Optional URL Query Parameters:

r_name: Specifies the preferred resale partner for the product/item. If the ?r_name query parameter is included, the configurations are filtered to match the specified name, except for any configuration labeled as "default" (e.g., ?r_name=poshmark).

r_location: Specifies the geographical location for resale consideration. If the ?r_location query parameter is included, configurations are filtered by matching locations, except for configurations with an empty location array, which are treated as defaults (e.g., ?r_location=us).

‍

🛠 How It Works

  1. Customer clicks “Resell”
    On your site (e.g., in their account or order history page), show a “Resell” button next to eligible products. When clicked, it redirects to the resale partner with the eon_id in the URL query string.
  2. Resale partner fetches metadata
    The partner platform calls the EON API’s GET /item/{id} endpoint using the EON ID to pre-fill the listing with product details (title, images, category, etc.).
  3. Lifecycle events are recorded
    Once listed, sold, or canceled, the resale platform sends an interaction event via POST /interactions to the EON Platform to keep the product's lifecycle updated.

📦 API Endpoints Used

  • GET /item/{id}
    Fetches product metadata for the listing
  • POST /interactions
    Records resale events (listed, resold, cancelled)

✅ Benefits

  • Seamless resale flow with minimal effort
  • No app embedding or scan required
  • Consistent brand + customer experience
  • EON records all resale lifecycle events for traceability

Need help configuring your resale URLs or configuring the business rules? Contact our team or check out the full API reference for details.

‍