The eBay plugin is a popular tool for e-commerce businesses. It integrates WooCommerce stores with eBay, one of the largest online marketplaces worldwide. Here’s a brief overview of its functionality:
Key Features
Product Synchronization: Automatically syncs products from your WooCommerce store to eBay, including details like price, stock levels, and product descriptions.
Order management: Imports orders placed on eBay directly into WooCommerce, allowing you to manage everything from one place.
Inventory Updates: Keeps track of stock changes in real-time across both platforms, preventing overselling.
Shipping & Tracking: Automatically send shipping information and tracking details from WooCommerce to eBay when an order is completed.
Automatic Updates: Regular updates to the plugin ensure compatibility with the latest versions of WooCommerce and eBay's API.
Benefits
Time Saver: Eliminates the need to manage two platforms manually, helping you focus on growing your business.
Efficiency: Helps streamline sales and order fulfillment across multiple channels.
About eBay
What is eBay?
eBay is one of the largest and most trusted online marketplaces in the world, connecting millions of buyers and sellers globally. Founded in 1995, eBay provides a platform for individuals and businesses to list, buy, and sell a wide variety of products, from collectibles and electronics to fashion and home goods. Its auction-style and fixed-price listings make it versatile for different selling strategies, appealing to both casual sellers and professional merchants.
For online businesses, eBay is an excellent channel to expand reach, increase visibility, and attract customers who are actively searching for products. With its global audience and intuitive interface, eBay empowers sellers to grow their businesses efficiently.
Before you start: create an eBay seller account
To use the eBay plugin for WooCommerce, you need an active eBay Seller Account. If you don’t already have one:
Sign Up: Go to eBay and create an account.
Upgrade to Seller Account: Follow eBay’s steps to upgrade your account for selling.
Verify Payment Details: Set up a valid payment method (e.g., eBay-managed payments or Payoneer) to receive payouts.
Familiarize Yourself with Policies: Review eBay’s seller policies to ensure compliance.
Once your account is active, you’re ready to connect it to the plugin and start selling!
Download, install & activate the plugin
Get a subscription
Before you can begin working with the plugin, you need a subscription. You can purchase one at woosa.com.
Download the plugin
After the subscription is purchased, you can now download the plugin. Please follow these steps:
Log in to your woosa.com account
Go to the Licenses tab
Look for the eBay plugin and click on Download Plugin
It'll download a .zip file, do not extract this on your desktop
Install & activate the plugin
Now that the plugin is downloaded, we can upload and install it on WordPress. Please follow these steps:
Log in to your WordPress backend
Go to the Plugins page
On top of the page, click on Add new plugin
Then click on Upload plugin
Click on Choose file
Locate the plugin in your files and click on Open
Then, click on Install now
Lastly, click on Activate plugin
Activate the plugin with your Woosa license key
Get your license key
After plugin installation, we must activate it with your Woosa license key, or else it won't work. Please follow these steps:
Log in to your woosa.com account
Go to the Licenses tab
Look for the eBay plugin, and copy the license key
Activate the plugin with your license key
Now that you have copied your license key, we can activate the plugin in your WordPress backend. Please follow these steps:
Log in to your WordPress backend
Click on eBay on your left navigation bar
On that page, paste the license key in the license field
Lastly, click on Activate
Authorize the plugin with your eBay account
Next up, is authorizing the eBay plugin in WooCommerce, with your eBay seller account. To do this, please follow these steps:
Log in to your WordPress backend
Go to the eBay plugin settings
Click on the Authorization tab
If you haven't already, please register the plugin first by clicking on Click to register
After you registered, your page will refresh. Now click on Click to Authorize
You'll be redirected to the eBay login screen
After you logged in, you'll be prompted to Review and grant permissions.
On that page, click on Agree and Continue.
After the above steps the plugin is now authorized!
Important: before you authorize the plugin, make sure the WooCommerce Address line 2 is filled in. Or else you'll receive an error: The authorization failed due to: The store address in Woocommerce settings is empty. Please provide the store address then try again.
General settings
The eBay plugin offers a variety of options you can configure to your liking, let's go through them all. Each section represents a different tab in the plugin settings.
Dashboard
The eBay plugin offers a variety of options you can configure to your liking, let's go through them all. Each section represents a different tab in the plugin settings.
Option name | Type | Explanation |
License key | Input field | Fill in your Woosa license key, to activate the plugin |
Debug mode | Enable/disable | Enable if you like to see advanced logs |
Remove configuration | Enable/disable | Enable if you like to remove the plugin configuration after uninstalling |
Shop secret key | Input field | This key is used to sign the requests to our servers |
Resource usage | Dropdown | Define the usage of the server resources to get the best performance from the plugin |
Important: any shop or server changes will change the shop's secret key. To fix this, contact our support team.
Authorization
Important: these settings can only be adjusted if the plugin is unauthorized.
Option name | Type | Explanation |
Test mode | Dropdown | Whether or not to use the test environment |
Click to authorize | Button | Click this button to authorize the plugin with your eBay account |
Category mapping
When you connect your shop categories to eBay categories, the products within those shop categories will be published to the corresponding eBay categories.
To do this, please follow these steps:
Go to the eBay plugin settings
Click on the tab Category Mapping
On the left side, please select an eBay category
On the right side, please select your WooCommerce category
Lastly, click on Connect
Your shop category is now connected to the correct eBay category, now you can start publishing products!
Configure category
Certain eBay categories require additional configuration. In these cases, you’ll need to define Mandatory and Optional fields, typically for specific categories like Electronics, Cameras, TVs, and similar items.
Once you’ve connected your WooCommerce category to an eBay category, click on Configure. A pop-up screen will appear, allowing you to set up the Mandatory and Optional fields for that category.
Synchronization
Products
Option name | Type | Explanation |
Synchronize products | Enable/disable | Enable this if you want to automatically synchronize your shop's products with eBay whenever a product is created, updated, trashed or deleted |
Do not synchronize new products | Enable/disable | Enable this if you want to prevent newly created products in your shop from being automatically synchronized |
Do not synchronize prices | Enable/disable | Enable this if you want to prevent product prices from being automatically synchronized when updated in your shop |
Preserve stock offset | Input field | Define a value that will be subtracted from the product stock. This will help to avoid selling out of stock products |
Condition | Dropdown | Choose which product condition to be used as default |
Marketplace | Dropdown | This is used to indicate the different eBay marketplace sites |
Package type | Dropdown | Select the default package type for your products |
Orders
Option name | Type | Explanation |
Import orders | Enable/disable | Enable this if you to automatically import orders from eBay into your shop |
Disable processing order email | Enable/disable | Enable this if you want to disable the email that is received by customer when the imported order has status processing |
Disable completed order email | Enable/disable | Enable this if you want to disable the email that is received by customer when the imported order has status completed |
Policies
The following policies can be selected in the plugin settings:
Option name | Type | Explanation |
Payment Policy Id | Dropdown | This unique identifier indicates the payment business policy that will be used once an offer is published and converted to an eBay listing |
Fulfilment Policy Id | Dropdown | This unique identifier indicates the fulfilment business policy that will be used once an offer is published and converted to an eBay listing |
Return Policy Id | Dropdown | This unique identifier indicates the return business policy that will be used once an offer is published and converted to an eBay listing |
If the policies aren't visible in the dropdowns, then you probably haven't created them yet in your eBay Seller Hub. To do that, please follow these steps:
Log in to your eBay Seller Hub
Click on Listings
On the left navigation bar under the header Settings, click on Business policies
On that page on the right side, click on the blue button Create policy
Choose which policy to create
After you created the policies:
Log in to your WordPress backend
Go to the eBay plugin settings
Click on the Tools tab
Lastly, click on Clear Cache
The policies should now be visible!
Product bulk actions
Publish a product
To start the synchronization of a product between WooCommerce & eBay, you need to publish it first. Please follow these steps:
Go to your WordPress backend
Click on the Products tab on the left navigation bar
Select the product you like to publish to eBay
Go to Bulk actions and click on eBay: Publish/update
Lastly, click on Apply
The first status the product will have in WooCommerce is Processing and after a few minutes Published.
Important: do you get an Error? Go to the product editing page, scroll down to Product data, and click on the eBay tab. The error will be displayed right there and you can consult our eBay error list on how to solve this.
Update a product
In case you changed some settings in the plugin, for example, the product price margin, you need to update this to eBay. To do this, please follow these steps:
Go to your WordPress backend
Click on the Products tab on the left navigation bar
Select the product you like to publish to eBay
Go to Bulk actions and click on eBay: Publish/update
Lastly, click on Apply
Pause/unpause a product
If you like to pause or unpause a product in eBay, you can do that in WooCommerce using the Bulk actions. To do this, please follow these steps:
Go to your WordPress backend
Click on the Products tab on the left navigation bar
Select the product you like to publish to eBay
Go to Bulk actions and click on eBay: Pause/unpause
Lastly, click on Apply
Delete a product
If you like to remove a product from your eBay account and their platform, you can do that in WooCommerce using the Bulk actions. To do this, please follow these steps:
Go to your WordPress backend
Click on the Products tab on the left navigation bar
Select the product you like to publish to eBay
Go to Bulk actions and click on eBay: Delete
Lastly, click on Apply
Other product actions
There are other product actions that can be done via the product editing page. These settings are displayed on the Product edit page -> Product data -> eBay tab. You'll only use these settings when you like to overwrite the general plugin settings for a particular product. For example, category mapping or condition.
Option name | Type | Explanation |
Manage category? | Checkbox | Use a different category than the general settings |
Manage condition? | Checkbox | Use a different condition than the general settings |
Manage package type? | Checkbox | Use a different package type than the general settings |
Manage price? | Checkbox | Use a different price than the general settings |
Order processing
The plugin imports eBay orders into your WooCommerce store, where you can process and send them to the customer. First, let's go through some of the order settings in the plugin. To reach these settings, go to eBay> Synchronization > Orders.
You can refer back to the order settings and explanation here.
Tools
The bol.com plugin offers a few tools that can solve an issue, or smoothen things up. Let's go through all of them.
Heartbeat
We implemented this option in all of our plugins because we noticed a problem in a lot of shops. By default, our plugins (in this case bol.com) will create a scheduled action called eby_perform, which runs every minute to trigger the processing of plugin tasks. This action relies on WordPress's default cron system, meaning it only runs when someone visits your website.
If your website experiences a period of inactivity, the scheduled action won't run until the next visit. As a result, the plugin may not execute tasks at the intended intervals, potentially causing delays.
A solution to this problem is to create a cron job. By enabling the Heartbeat option, it'll create a cron job on our server to ping your shop every minute. Basically simulating a visitor, so that the plugin tasks will keep running.
Tools
This page has a few options in case things go wrong.
Woosa IP list
In case you have some heavy security measures on your server, please whitelist our IP addresses listed here.
Clear cache
In case you think the synchronization is stuck, for example, importing orders, you can clear the plugin cache to reset some background processes.
Action List
This page will tell you exactly what the plugin is doing. You can see the number of actions that are being active or rescheduled.
Logs
All (error) logs related to our plugins. In this way, a support agent or developer can debug when an error occurs.
Can't figure it out? You can always send a message to the support team via the chat bubble at the bottom right 🎈 Support to the rescue 👨💻 👩💻