/ /

eBay Read-Only Integration Guide

Connect your eBay Business to Kintsugi
Updated 16 days ago

If you sell on eBay, connecting your eBay seller account to Kintsugi lets you track your eBay sales alongside your other channels, so your nexus monitoring and reporting reflect everything you sell.

What is a read-only integration? A read-only integration lets Kintsugi pull data from eBay without writing anything back. Nothing changes in your eBay listings, orders, or checkout, and eBay continues to collect and remit marketplace tax as it does today.

eBay collects the tax on your eBay sales. As a marketplace facilitator, eBay collects and remits sales tax on your eBay orders. Kintsugi imports the amount eBay collected and marks every eBay order as a marketplace sale. Kintsugi does not calculate a second tax on these orders.


Before You Begin

Make sure you have the following ready:

  • a live eBay seller account (eBay sandbox or test accounts cannot connect)

  • the eBay username and password for that seller account

  • an active Kintsugi account

Each eBay seller account is its own connection in Kintsugi. If you sell through more than one eBay account, you will connect each one separately.


Step-by-Step Guide for eBay Read-Only Integration

Step 1: Start the Connection in Kintsugi

  1. Log in to Kintsugi.

  2. Click Data Sources.

    image.png

  3. Under the Integrations section, click Browse Integrations.

    image.png

  4. Find eBay by using the search bar or scrolling down.
    Click Connect on the eBay integration card.

    image.png

  5. (Optional) Set an Import start date. This is the earliest order date you want Kintsugi to import. You can import up to 729 days (about two years) of eBay order history. If you leave this blank, Kintsugi imports the full 729 days.

    Click Continue with eBay to proceed.

    image.png

Step 2: Approve Access in eBay

Kintsugi redirects you to eBay to approve the connection.

  1. Sign in with your live eBay seller account.

  2. Review the access request and click to accept access for the Kintsugi app.

eBay then returns you to Kintsugi, and the connection is saved.

Heads up: eBay connects the account you are signed in to. If you manage more than one eBay store, make sure you are signed in to the correct seller account before you approve access.

Step 3: Wait for the Initial Sync to Finish

Kintsugi begins importing your eBay data as soon as the connection is saved. While that runs, the integration status shows Syncing.

image.png

Kintsugi imports the following:

  • orders, including each item line and paid shipping

  • customers, created from the buyer on each order

  • products, from your eBay inventory or from the items on your orders

  • refunds, imported as credit notes

How long this takes depends on how many orders are in your import window. To check your data, go to the Customers, Transactions, or Products tab, use the Source filter, and select eBay.

Once the sync is complete, the eBay status updates to Read-Only, confirming that your eBay data is live in Kintsugi. After that, Kintsugi keeps importing new orders, along with updates to existing orders such as cancellations and refunds, automatically.

Step 4: Complete Your Setup Tasks

A. Review Product Categories

Your eBay products arrive uncategorized. Review them so your sales are classified correctly. Kintsugi Intelligence suggests a category and subcategory for each one.

To review products:

  1. Click Review on the pending task notification.

  2. Approve the AI-generated suggestions in bulk or individually.

For detailed instructions, see Updating Product Category and Subcategory.

B. Review Flagged Addresses

Kintsugi uses the ship-to address on each eBay order to determine where the sale took place. Any order with a missing or invalid address is flagged for you to review.

To correct Invalid Addresses, click Bulk Cleanup to update multiple addresses at once, or correct them individually. For more information, see How to Update Invalid Addresses in the Kintsugi App.

To edit Blank Addresses, click Add Addresses on the pending task list. To learn more, see How to Update Blank Addresses in the Kintsugi App.

Note: eBay removes some buyer details from older orders. The buyer's email disappears about 14 days after the sale, and the buyer's name, phone, and street address disappear after about 90 days. On those orders, Kintsugi still receives the buyer's city, state, ZIP code, and country. This is expected, and Kintsugi still has what it needs to place the sale in the correct state.


How to Confirm the Integration Works

You will know the connection is healthy when all of the following are true:

  • the eBay card on your Data Sources page shows Read-Only instead of Syncing

  • your eBay orders appear in Kintsugi as transactions

  • order numbers in Kintsugi match the order numbers in eBay Seller Hub


What Kintsugi Syncs from eBay

eBay record

Appears in Kintsugi as

Notes

Orders

Transactions

Each item on the order imports as a line item. Every eBay order is marked as a marketplace sale.

Paid shipping

A separate shipping line on the transaction

Imported at the net shipping charge, with no tax and no taxable amount, because eBay does not report shipping tax separately. Orders with free shipping have no shipping line.

Buyers

Customers

The buyer's eBay username is the customer ID. The customer name comes from the ship-to name and stays blank on older orders.

Inventory items and order items

Products

Products use your eBay SKU when you have one. Items without a SKU use the eBay item number, plus the variation ID when the listing has variations.

Refunds, lost disputes, and order adjustments

Credit notes

Each refund imports as one credit note linked to the original order, including the tax eBay refunded to the buyer when eBay reports it. A dispute you lost, and an adjustment charge tied to an order, also import and link to that order.

Tax eBay collected

Imported tax

The tax eBay collected and remitted on each order.

Discounts and promotions

Reduced line, order, or shipping amounts

A promotion on an item reduces that line. An order discount reduces the order's taxable amount. A shipping discount reduces only the shipping line.

What is not synced

  • credits and adjustments that only affect your eBay account balance and are not tied to an order, disputes you won, and store credit

  • billing addresses (eBay shares only the ship-to address with sellers)

  • buyer email after about 14 days, and buyer name, phone, and street address after about 90 days, because eBay removes them from older orders

  • customer exemptions (eBay handles buyer exemptions at checkout as the marketplace facilitator)

  • refunds for orders dated before your import start date

  • separate credit notes for shipping-only or tax-only refunds (each refund imports as a single credit note)

eBay orders cannot be edited in Kintsugi. Line items on paid eBay orders are locked in Kintsugi. If an order needs to change, make the change in eBay, and Kintsugi picks it up on the next sync.


Keeping Your eBay Connection Active

Kintsugi refreshes your eBay access automatically in the background. However, eBay requires you to approve Kintsugi again about every 18 months. If that approval expires, Kintsugi stops importing new eBay orders until you re-authorize.

To re-authorize, go to Data Sources, click the menu (⋮) on the eBay card, and choose Re-authorize. Then follow the same eBay approval steps from Step 2 using the same seller account. Your existing data stays in place and syncing resumes.

image.png

Connecting More Than One eBay Store

To add another eBay store, repeat Steps 1 and 2, and sign in to eBay as the other seller account when you approve access. Each store appears as its own connection on your Data Sources page.

You cannot connect the same eBay seller account twice.


Troubleshooting

The eBay sign-in page does not accept your account

Kintsugi connects only to live eBay seller accounts. eBay sandbox or developer test accounts cannot connect. Sign in with the seller account you use on eBay.com.

You do not see the eBay card under Browse Integrations

Refresh the page and check again. If the eBay card still does not appear, reach out to our support team using the chat bubble.

New eBay orders stopped importing

Your eBay approval may have expired. eBay requires you to re-approve Kintsugi about every 18 months. Re-authorize the connection as described in Keeping Your eBay Connection Active section above.

Some orders or refunds are missing

Check the import start date on your connection. Orders before that date, or older than 729 days, are not imported. A refund is also not imported if its original order is outside your import window.

Customer names are blank

eBay removes the buyer's name from older orders. The customer is still created using the buyer's eBay username, and the order still carries the location Kintsugi needs. This is expected.

A refund shows no tax

Kintsugi imports refunded tax only when eBay reports it on the refund. If eBay does not include a tax amount, the credit note imports with tax set to 0.


FAQs

Q: Is my eBay data safe?

A: Yes. Kintsugi reads only what it needs to track your sales and tax exposure, and it writes nothing back to eBay.

Q: Will connecting eBay change my listings or checkout?

A: No. A read-only connection never writes to eBay. eBay continues to collect and remit tax at checkout as it does today.

Q: If eBay already collects the tax, why connect eBay to Kintsugi?

A: In many states, marketplace sales still count toward your economic nexus thresholds. Connecting eBay gives Kintsugi a complete view of your sales, so it can monitor nexus accurately across all your channels.

Q: Does Kintsugi calculate tax on my eBay orders?

A: No. Kintsugi imports the tax eBay collected and marks each order as a marketplace sale. It does not calculate a second tax on eBay orders.

Q: How far back does Kintsugi import my eBay orders?

A: Up to 729 days (about two years). You can set a later import start date when you connect.

Q: Why is shipping imported with no tax?

A: eBay includes shipping tax in the order's total tax but does not report it separately, so Kintsugi imports the shipping line with no tax and no taxable amount.

Q: Can I connect more than one eBay store?

A: Yes. Each eBay seller account is its own connection. See Connecting More Than One eBay Store.

Q: Do I need to do anything to keep the connection running?

A: Only once about every 18 months, when eBay asks you to approve Kintsugi again. See Keeping Your eBay Connection Active.

Q: How do I stop syncing eBay?

A: Go to Data Sources, click the menu (⋮) on the eBay card (1), and choose Archive (2). Archiving stops the sync right away.

image.png


Need Help?

We are always here to help. If you cannot find the answer you are looking for, reach out using the chat bubble in the bottom right corner of your screen.

Was this article helpful?