← Back to Home

🌐 Using CardLister Pro online? Each subscriber uses their own eBay account. Just complete Steps 1–4 below to get your eBay keys and token, then paste your token in the form at Step 4. No .env file needed — your token is saved to your account.

Complete Setup Guide

Follow these steps to set up your eBay API credentials. This is a one-time setup that takes about 20-30 minutes. Your token is stored securely with your account - we never share them.

Go to eBay Developer Portal Get OAuth Token

Create an eBay Developer Account

Go to the eBay Developer Program and create a free account:

https://developer.ebay.com/

Click "Join" or "Sign In" and use your existing eBay account or create a new one.

💡 Tip: Use the same eBay account you use for selling. This ensures your listings appear on your seller account.

Create an Application (Keyset)

Once logged in to the Developer Portal:

Click on "My Account" in the top right
Click "Application Keys" from the dropdown
Click "Create a keyset" button
Select Production (NOT Sandbox)
Give your app a name (e.g., "Card Listing Tool" or "My eBay Bot")
Click "Create"

⚠️ CRITICAL: Make sure to create PRODUCTION keys, not Sandbox keys. Sandbox is for testing only and won't work for real listings.

After creating, you'll see three important values. Copy these immediately:

App ID (Client ID) - This is your OAuth Client ID
Cert ID (Client Secret) - This is your OAuth Client Secret
Dev ID - Your Developer ID

App ID (Client ID): Your-App-ID-Here
Cert ID (Client Secret): Your-Cert-ID-Here
Dev ID: Your-Dev-ID-Here
            

⚠️ Security: These credentials give full access to your eBay account. Never share them or commit them to public repositories.

Configure OAuth Redirect URI

In your application settings, you need to set up the OAuth Redirect URI:

Go back to "My Account" → "Application Keys"
Click on your application name (the one you just created)
Scroll down to "OAuth Redirect URIs" section
Click "Add URI" or "Edit"
Add this exact Redirect URI (for online use):

https://ebaybot-2w33.onrender.com/callback

Add this URL in eBay Developer Portal and ensure the app owner has set OAUTH_REDIRECT_URI=https://ebaybot-2w33.onrender.com/callback in Render.

💡 Important: The redirect URI must match EXACTLY what you put in your .env file. For most users, use http://localhost:8080/callback

⚠️ Common Error: If you get "redirect_uri_mismatch" error, make sure the URI in eBay Developer Portal matches EXACTLY (including http vs https, trailing slashes, etc.)

Get Your OAuth Refresh Token

You need to authorize the app to access your eBay account. There are two methods:

Method A: Using eBay Developer Portal (Easiest)

Go to: eBay OAuth Token Page
Make sure "Production" is selected (not Sandbox)
Select all the scopes/permissions (or at least these):
- sell.inventory
- sell.account
- sell.fulfillment
- sell.marketing
Click "Get Token" or "Authorize"
Sign in with your eBay seller account
Click "I Agree" to authorize
Copy the Refresh Token that appears (it's a long string starting with something like "v^1.1#i^1#r^0...")

Method B: Using the Tool's Login Script

Open terminal/command prompt in the tool's folder
Run: python simple_login.py
A browser window will open
Sign in and authorize the application
The token will be saved automatically

💡 Important: The refresh token is valid for 18 months. Save it securely - you'll need it for the .env file. If it expires, you'll need to get a new one.

🔗 Connect eBay (Recommended)

Click below to sign in with your eBay account. Your token will be saved automatically.

Connect My eBay Account →

⚡ Or paste your token manually:

Paste your token here to update it instantly:

🔧 Fixing "unauthorized_client" Error: If you get this error, it means your APP_ID or CERT_ID is incorrect. Double-check:

You copied the correct App ID (Client ID) from Production keyset
You copied the correct Cert ID (Client Secret) from Production keyset
You're using Production keys, not Sandbox keys
The keys are in your .env file without extra spaces or quotes

You're Done!

You've saved your token above. Go to the App to start listing. No .env file needed for the hosted version.

Set Up Business Policies in eBay

Before listing, make sure you have these policies set up in eBay Seller Hub:

Go to: eBay Seller Hub
Click "Account" → "Business Policies"
Create or verify you have:
- Payment Policy: Usually "Managed Payments" (eBay handles this automatically)
- Shipping Policy: Create a policy (e.g., "PWE" for Plain White Envelope, or flat rate shipping)
- Return Policy: Create a policy (e.g., "No Returns Accepted" or your preferred return terms)

💡 Tip: The tool will automatically fetch your policies when you load the app. If policies are blank, check that your OAuth token is valid and has the sell.account scope.

Test Your Setup

Now let's verify everything works:

Start the application: python app.py
Open your browser to: http://localhost:5001
Log in with your subscription email
Go to the app page
Click "🔄 Refresh Policies" - you should see your policies load
Try fetching a checklist from a Beckett URL
Create a small test listing (1-3 cards) to verify everything works

💡 Tip: Start with a small test listing (1-3 cards) to make sure everything works before listing a full set. You can delete test listings from eBay Seller Hub.

Troubleshooting Common Errors

Error: "unauthorized_client" - "The OAuth client was not found"

This means your APP_ID or CERT_ID is incorrect.

Double-check you copied the correct App ID (Client ID) from Production keyset
Double-check you copied the correct Cert ID (Client Secret) from Production keyset
Make sure you're using Production keys, not Sandbox keys
Check your .env file - no extra spaces, quotes, or line breaks in the values
Restart the application after updating .env

Error: "Invalid access token" or "Token expired"

Your OAuth token has expired.

Click the "🔑 Get OAuth Token" button in the app
Or go to: eBay OAuth Token Page
Get a new refresh token and update your .env file
Or run: python simple_login.py to get a new token automatically

Error: "redirect_uri_mismatch"

The redirect URI doesn't match.

Check that the redirect URI in eBay Developer Portal matches EXACTLY what's in your .env file
Make sure it's the same (http vs https, trailing slashes, etc.)
For most users, use: http://localhost:8080/callback

Policies Dropdown is Blank

Policies aren't loading from eBay.

Check that your OAuth token is valid (not expired)
Make sure your token has the sell.account scope
Verify you have policies set up in eBay Seller Hub
Click "🔄 Refresh Policies" button
Check the browser console (F12) for error messages

Still Need Help?

If you're stuck or having issues with setup, we're here to help!

Contact Support