← Back to ShowMargin

Owner setup guide

Connect with permission.

TikTok authorization is built, but production authorization has not been verified and order syncing is not built. Whatnot auto-sync is not available; it requires platform access and testing. Neither marketplace currently syncs sales automatically into ShowMargin.

eBay: first automatic order import

ShowMargin can work through order pages in one run, resume an interrupted import and match saved SKU costs. Optional refresh runs every 15 minutes while the Connections screen is open and visible. This is not a background service, and fees, refunds requiring review, payouts and live-show assignment are not fully automated.

  1. The app owner needs an eBay Developers Program account and production application keys for ShowMargin. Complete the account and production-access requirements shown by eBay.
  2. Under the production application’s user-token settings, create a redirect URL name (RuName). Use this accepted callback:https://showmargin.bradlyhorvath51.chatgpt.site/api/integrations/ebay/callbackUse https://showmargin.bradlyhorvath51.chatgpt.site/privacy as the privacy-policy URL. Use https://showmargin.bradlyhorvath51.chatgpt.site/ for the declined URL.
  3. Configure EBAY_CLIENT_ID, EBAY_CLIENT_SECRET and EBAY_RUNAME in protected server settings, retaining the existing encryption key. Never send the secret in a message or screenshot. Apply those settings to the hosted app.
  4. Connect your seller account through eBay’s own consent page. Run the first import and compare orders and quantities with your seller records. Correct missing inventory costs before using profit totals.

The application currently requests commerce.identity.readonly, sell.fulfillment.readonly and sell.finances permissions. Financial transaction ingestion and a scheduler that runs when the app is closed are still separate engineering work. Seller authorization cannot supply inventory purchase costs that eBay does not hold.

TikTok Shop → TikTok LIVE

  1. Register in TikTok Shop Partner Center as a developer serving sellers. ShowMargin needs a seller-facing app for multiple merchants—not TikTok consumer Login Kit or creator-only access. Complete TikTok’s identity, business and regional eligibility checks honestly.
  2. Create the app, obtain its App Key and App Secret, and register this redirect URL:https://showmargin.bradlyhorvath51.chatgpt.site/api/integrations/tiktok/callback

    The new callback must be deployed before TikTok can test it. A private site may also need an approved reviewer-access plan; this update does not change site access.

  3. Request the read permissions needed for authorized shops, orders, products/inventory, returns/refunds, and financial settlements/fees. Use the exact permission names shown for your region and app in Partner Center. Confirm whether your approval includes a reliable way to identify LIVE sales and their show; ordinary Shop orders are not automatically LIVE orders.
  4. Copy the seller authorization link supplied by Partner Center. It must use services.us.tiktokshop.com/open/authorize or services.tiktokshop.com/open/authorize with its real service_id. Do not invent an ID.
  5. Configure the values below as private server environment variables. Only mark approval true after the app has the necessary access. Never paste the App Secret or access tokens into a chat, screenshot, frontend form or source code.
TIKTOK_APP_KEY
TIKTOK_APP_SECRET
TIKTOK_AUTHORIZATION_URL
TIKTOK_APP_APPROVED=true
OAUTH_ENCRYPTION_KEY (existing server key)

After deployment and configuration, authorize a test seller. ShowMargin should show “Authorized · sync not built.” Next engineering work: authorized-shop discovery, validated order/finance APIs, LIVE attribution, refresh/revocation handling, scheduled sync and webhook verification. Reuse the existing encryption key; changing it without a migration would break existing encrypted tokens.

Official TikTok authorization documentation

Moving to your own domain

Connect the domain in Site settings and wait until HTTPS is active. Then update APP_URL, the eBay accepted and declined URLs, and the privacy-policy URL to that address. Keep your production keys and existing encryption key.

Update EBAY_DELETION_ENDPOINT and the matching URL in eBay to the same exact address ending in /api/integrations/ebay/account-deletion. Apply the settings and repeat eBay’s notification test. Finally, start a fresh seller connection from the new domain and check an order import. Update any other marketplace callbacks before using them on the new domain.

Whatnot auto-sync: not available

Automatic syncing is planned, but it is not available yet. Launch depends on approved platform access and verified data support. No launch date is confirmed.

Existing Whatnot records remain available. CSV importing is optional and does not connect your account or sync inventory back to Whatnot.

Check Whatnot’s official access status