eB

Settings

Theme, eBay connection, and default business policies.

Appearance

Light, dark, or match your system preference. Saved in this browser.

Sandbox setup checklist

Do these in order. Steps 1–2 are on your side; step 3 is one click in this app.

  1. 1. App keys in .env

    EBAY_CLIENT_ID, EBAY_CLIENT_SECRET, EBAY_REDIRECT_URI = your RuName, EBAY_ENV=sandbox. Restart the server after edits.

  2. 2. Connect sandbox seller (you)

    OAuth token is stored. You can re-connect anytime if it expires.

  3. 3. Auto-create location + policies (app)

    Creates warehouse location + shipping/payment/return policies via eBay APIs and saves the IDs here.

  4. 4. Mock publish off

    Live publish is enabled (mock flag not set).

Re-connect eBay account

Why Auth Accepted URL rejects localhost

eBay only allows https:// URLs (not http://localhost). That’s why the field “disappears” after you type it — the portal rejects and clears it. Use Option A (easiest) or Option B (HTTPS tunnel) below.

Option A — Paste portal OAuth token (what you have)

Get a User Token → OAuth → Copy to clipboard only gives you the User Access Token (~2 hours). That is not a refresh token — using it as a refresh token causes invalid_grant. This app now accepts that single token and uses it directly.

  1. Application Keys → Sandbox keyset matching EBAY_CLIENT_ID
  2. User Tokens → Get a User Token Now → OAuth
  3. Sign in as sandbox seller → accept → Copy token
  4. Paste below immediately → Save portal token
  5. Then run Auto-setup (before the ~2 hour expiry)

Optional .env (must be double-quoted because of #):
EBAY_USER_ACCESS_TOKEN="v^1.1#…"

Option B — Use Connect button with free HTTPS tunnel

Only needed if you want the in-app “Connect eBay account” redirect flow.

  1. Install ngrok (free account) and run, with the app already on port 3000:
    ngrok http 3000
  2. Copy the https://….ngrok-free.app URL ngrok prints
  3. In eBay RuName settings set:
    • Auth Accepted URL: https://YOUR-SUBDOMAIN.ngrok-free.app/api/ebay/oauth/callback
    • Auth Declined URL: https://YOUR-SUBDOMAIN.ngrok-free.app/settings?error=declined
  4. Leave EBAY_REDIRECT_URI as your RuName (not the ngrok URL)
  5. Open the app via the ngrok https URL (not only localhost), then click Connect eBay account

Option C — paste authorization code

Only if a redirect URL in the browser contains code= (after Option B). Codes expire in a few minutes.

Connection status

  • xAI: configured
  • eBay app keys: configured
  • Environment: sandbox
  • User OAuth: token present
  • Mock publish: off

RuName (env EBAY_REDIRECT_URI): must match developer portal — currently Ben_Franklin-BenFrank-Roll2L…

Auth Accepted URL (portal only — not the RuName):

https://roll2list.com/api/ebay/oauth/callback

Auth Declined URL:

https://roll2list.com/settings?error=declined

Listing defaults

Filled automatically by Auto-setup. You can edit and Save if needed.