Connect eBay

Official API & Authorised Integration Guide

eBay Connection Guide

eBay OAuth Sell Fulfillment order sync. Additional fulfilment/inventory/offer/feed actions need dedicated adapter methods.

What this connector can sync

✓ Orders & status
✓ Products & variants
✓ Seller SKU mapping
✓ Warehouse inventory
✓ Labels / AWB when API permits
✓ Returns & refunds
✓ Fees & settlements when available
✓ GST and fulfilment records

Capabilities depend on the scopes and endpoints approved for your seller account. The plugin does not mark the account Connected until its Test Connection succeeds.

Required account and credentials

Connection type: Official Api

Use a seller/developer account owned by your business. Request only the scopes required for orders, products, inventory, fulfilment, returns or settlements.

OAuth callback URL:https://gstkhata.com/wp-json/agbp/v1/marketplace/oauth/callback/ebay

Webhook URL: Open Marketplace Connections, save the account, then copy its unique Webhook URL.

Step-by-step setup

  1. Create an eBay developer application.
  2. Complete OAuth authorization and collect a refresh/access token.
  3. Enter Client ID, Secret, token, environment and marketplace ID.
  4. Run Test Connection against Sell Fulfillment API.
  5. Map listings/SKUs and enable order/inventory sync.

SKU and warehouse mapping

Match priority is seller SKU → variant SKU → barcode/EAN/UPC → platform listing ID → product SKU. Unmapped items remain quarantined and never deduct stock automatically.

  • Map each marketplace facility/store to a plugin warehouse or rack.
  • Set safety stock buffer and stock deduction stage.
  • Confirm service/digital items as non-shippable.
  • Run the first sync and inspect Stock Reservations before dispatch.
Open SKU Mapping Guide

Orders, labels, returns and settlements

Official label/AWB is used when supplied by the authorised marketplace API. The built-in packing label is a fallback and is not presented as a marketplace-approved carrier label.

  • Order import creates an idempotent shipment record.
  • Mapped physical items reserve stock.
  • Cancellation releases reservation.
  • Accepted sellable return may restore stock; damaged return remains quarantined.
  • Fee and payout data is sent to existing reconciliation reports when the API exposes it.

Common errors

401 / Invalid Token

Refresh/re-authorize the token and verify scopes.

403 / Access Denied

Seller account or API role is not approved for the endpoint.

Unmapped SKU

Map the seller SKU before enabling automatic stock deduction.

Webhook rejected

Check HTTPS, signature secret and duplicate/replay protection.

Open Troubleshooting

Official documentation

Open official documentation ↗

Open official documentation ↗

Open official documentation ↗

Last updated: 09 Oct 2026 · Live connection depends on seller credentials, API scopes and platform approval.
Scroll to Top