Be ready to build your own Instant Sell feature for your application!

Develop a seamless Instant Sell system for your application using Reusely's API. This guide outlines how to integrate key functionalities, including linking accounts, item identification, and handling orders for both Mail-In and In-Store sales.

The Instant Sell flow incorporates model identification, specification and condition selection, and order submission. You can implement Mail-In, In-Store, or both methods depending on your platform's requirements. Follow the steps below to implement this feature.

Instant Sell Flow

Pre-Sell Setup (Customizable Entry Point)

Define how users interact with your inventory and initiate the selling process. A typical flow might look like this:

1. User logs into your platform.
2. Searches for an inventory item.
3. Clicks a Sell button to start the selling process.
4. A modal or confirmation UI prompts users to indicate if the item is linked to a Reusely model.

Identify the Model

Use Reusely's API to guide users through selecting the correct model for their item. You can implement a search input or a category-based drilldown UI. The selection process typically follows this sequence: Category > Device > Model or Brand > Device > Model.

APIs to Use:

1. Search Input
   Search Models API: Use this endpoint to search for and identify available models.
2. Display Categories
   List Categories API: Retrieve a list of available categories.
3. Display Brands
   List Brands API: Retrieve a list of available brands.
4. List Devices by Category or Brand
   List Devices API: Get a list of devices filtered by specific brands to a selected category.
5. List Models by Device
   List Models API: Display the models available for a specific device.

Once a model is identified, save the model_id in your catalog for future use.

Identify Item Specifications

As a developer, you may allow users to refine their item by selecting specifications like storage size, color, or carrier.

Example Use Case:

• If a device has multiple storage options based on the carrier:
  AT&T supports 64GB and 128GB.
  Verizon supports 128GB and 256GB.
• Use Reusely’s API to dynamically update the specification options based on the user’s selection.

APIs to Use:

1. Retrieve Model Specifications API: Fetch the specification details for the selected model.
2. Retrieve Catalog Specifications API: Dynamically update available specifications based on the model and user selections.

Identify Item Condition

Item condition is critical for determining its value. Depending on your UI, you can combine this step with specification selection or keep it separate.

APIs to Use:

1. Retrieve Model Conditions API: List condition options based on the selected model and specifications.

Proceed to Mail-In or In-Store Order Form

Once the user defines the item details (model, specifications, and condition), guide them to an order form. This step will vary depending on the selling method: Mail-In or In-Store.

APIs to Use:

1. Retrieve Mail-in Payout Methods API: Display payout methods for Mail-In options.
2. Retrieve In-store Payout Methods API: Display payout methods for In-Store options.

Pre-fill the order form with the following details:

1. User information: Email, address (for Mail-In orders), and payment method.
2. Item details: Model, specifications, condition, and offer price.

Submit the Order

Submit the completed order form to create the transaction.

1. Submit the order using the appropriate API:
   • Mail-In Checkout API for Mail-In orders.
     For mail-in order, it has parameter “source” which can be set into “Sell Instantly”.
   • In-store Checkout API for In-Store orders.
2. Save the order_id, box_id, and token for the next step, “Show Offer Information”.
3. Upon successful submission, display a confirmation message with an option to print the shipping label (for Mail-In).

Show Offer Information

After the order is submitted, retrieve and display the offer details to the user.

APIs to Use:

1. Retrieve a Mail-in Order API: Fetch details like order status and payout information for Mail-In orders.
2. Retrieve an In-store Order API: Fetch details for In-Store orders.

Provide a confirmation message with:

• Offer details.
• Order status.
• A Print Label button (for Mail-In orders).