1. ShipStation Help U.S.
  2. Integrations Help Guide
  3. Stores T-Z

Tophatter

Avatar

ShipStation Content Team

Updated

How to add a Tophatter store to ShipStation, what features are available, other need-to-know details, and troubleshooting tips.

If you love auctions, Tophatter Marketplace is a seller-focused, mobile-optimized marketplace designed to sell goods fast. Connect your Tophatter account to ShipStation to manage all of your single-item orders and streamline your shipping process. ShipStation will automatically notify your Tophatter account with each order's shipment details.

Learn more about selling on Tophatter.

Tophatter Requirements

Connection Requirements:

  • An active account with Tophatter.

  • Your Tophatter access token.

Order Import Requirements:

  • Include a Ship To address.

Connect a Tophatter store to ShipStation

To connect your Tophatter account to ShipStation:

  1. Log in to your Tophatter seller account.

  2. Go to the following URL: https://tophatter.com/seller/api_keys

  3. Copy the Access Token generated by Tophatter.

  4. Open a new tab or browser window and log in to your ShipStation account.

  5. Go to Account Settings.

    Closeup of ShipStation toolbar with outline marking the Settings icon.

  6. Select Selling Channels from the left-hand sidebar, then choose Store Setup.

    Settings page selections, with outline marking the Selling Channels Store Setup option.

  7. Click Connect a Store or Marketplace.

    Store Setup Settings, box highlights Connect a Store or Marketplace button.

  8. Select the Tophatter tile.

    TopHatter logo. Button that reads, Connect

  9. Enter the Tophatter Access Token in the corresponding field.

  10. Click Connect.

After you've completed the connection steps, your store will be connected to ShipStation. You'll be taken to the store's Settings page to adjust the store-specific settings like branding, notification preferences, and product handling.

Available Features for Tophatter Integration

The ShipStation integration to Tophatter supports for the following standard features:

Key: Green checkmark. Supported feature. Yes. = Supported; Red X mark. Unsupported feature. No. = Not Supported; Grey dash icon. Not applicable. = Does Not Apply

Common Integration Features

Feature

Supported?

Custom Statuses

Red X mark. Unsupported feature. No.

Customer Emails

Red X mark. Unsupported feature. No.

Customer Phone Numbers

Red X mark. Unsupported feature. No.

Requested Service*

Red X mark. Unsupported feature. No.

Payment Method

Red X mark. Unsupported feature. No.

Discounts

Red X mark. Unsupported feature. No.

Identifies Gift Orders

Red X mark. Unsupported feature. No.

Internal Notes

Red X mark. Unsupported feature. No.

Notes from Buyer

Red X mark. Unsupported feature. No.

Order Weight

Green checkmark. Supported feature. Yes.

Item Weight

Green checkmark. Supported feature. Yes.

Item Images

Green checkmark. Supported feature. Yes.

Item Options

Green checkmark. Supported feature. Yes.

Item Warehouse Location

Red X mark. Unsupported feature. No.

Order Status Mapping

ShipStation Status

Tophatter Status

Awaiting Payment

Pending Verification

Unpaid

Awaiting Shipment

Paid

Shipped

Shipped

Cancelled

Cancelled

Refunded

On Hold

Not Supported

Sent with Shipment Update

Field

Sent to Marketplace?

Status Update

Green checkmark. Supported feature. Yes.

Tracking Number

Green checkmark. Supported feature. Yes.

Carrier

Green checkmark. Supported feature. Yes.

Service

Red X mark. Unsupported feature. No.

Carrier Fee

Red X mark. Unsupported feature. No.

Note to Buyer

Red X mark. Unsupported feature. No.

Item Information

Red X mark. Unsupported feature. No.

Tophatter Additional Features

The ShipStation integration to Tophatter allows for the following additional features:

Feature

Description

Configurable Time Zone

By default, ShipStation assumes that the Tophatter store's server uses UTC as the timezone. If your Tophatter account uses a different server timezone, you can define it in the store's settings.

Import Variation ID as Item Option

This setting allows variations to import as Item Options. Must be enabled within the Store's settings page.

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.

ShipStation will import the customer's email address with the order data and can send shipment confirmation and delivery emails to that email address (configured in your Store settings).

ShipStation will import the customer phone number with the order data.

ShipStation will import the shipping method chosen by the customer during their store checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation can determine if an order is a gift from the order data sent by the store.

ShipStation will import internal notes or order activity from the store into the ShipStation Internal Notes field.

ShipStation will import notes provided by the customer when they made their purchase.

ShipStation will import the total order weight from the store.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order. These images will appear as thumbnails in your Order Details and can be included in email notifications and packing slips.

ShipStation will import item options (such as color or size) for each line item in the order. This data will appear in your Order Details and can be included in customer emails and packing slips.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information

Additional Details about the Tophatter Integration

  • When you update a Tophatter store, ShipStation will request information for orders created within the last 3 days. If an order which is older than 3 days is updated on Tophatter, ShipStation will not receive the new information.

Tophatter Troubleshooting Tips

Here are some common issues experienced by users, potential causes, and available troubleshooting tips.

The Order Date in ShipStation is different than the Order Date in Tophatter

What it means: This usually occurs because the Tophatter server is using a different timezone than the timezone set in the store's settings in ShipStation, which causes the Order Date to be thrown off when converting the timestamp based on time zone.

What to do: Update the store's settings so the store is using the same timezone as the server your Tophatter store is hosted on.

Certain orders placed late in the day are not importing into ShipStation

What it means: Similar to the issue above, this typically occurs because the Tophatter server is using a different timezone than the timezone set in the store's settings in ShipStation, which causes our import process to inadvertently skip ahead.

What to do: Update the store's settings so the store is using the same timezone as the server your Tophatter store is hosted on.

If a store allows custom statuses, this means you define that statuses your orders use in your selling channel. In most cases, if you have custom statuses you'll need to define which ShipStation statuses each custom order status corresponds to.

ShipStation will import the customer's email address with the order data and can send shipment confirmation and delivery emails to that email address (configured in your Store settings).

ShipStation will import the customer phone number with the order data.

ShipStation will import the shipping method chosen by the customer during their store checkout.

ShipStation will import the payment method used to pay for the order.

ShipStation will import discount and coupon information for the order.

ShipStation can determine if an order is a gift from the order data sent by the store.

ShipStation will import internal notes or order activity from the store into the ShipStation Internal Notes field.

ShipStation will import notes provided by the customer when they made their purchase.

ShipStation will import the total order weight from the store.

ShipStation will import the weight for each line item in the order.

ShipStation will import an image URL for each line item in the order. These images will appear as thumbnails in your Order Details and can be included in email notifications and packing slips.

ShipStation will import item options (such as color or size) for each line item in the order. This data will appear in your Order Details and can be included in customer emails and packing slips.

ShipStation will import a product stock location for each line item in the order.

Status UpdateTracking NumberCarrierServiceCarrier Fee

The shipment update ShipStation sends to the selling channel will include any Notes to Buyer set on the order in ShipStation.

Item Information

Didn't find what you were looking for?