← Back to EcomCentral
JUMPSELLER REST API v1

Jumpseller Setup Guide

Connect your Jumpseller store to EcomCentral using API login key and auth token — no OAuth flow required.

Prerequisites

ℹ️ Jumpseller uses query-parameter authentication: your login key and authtoken are appended as query params on every API request. No OAuth flow or session management is needed — credentials are sent directly as ?login=…&authtoken=….

Getting Your API Credentials

  1. Log in to your Jumpseller admin panel
  2. Click your store name or avatar in the top-right corner and open Account
  3. In the left sidebar, click API
  4. Your Login key and Auth Token are displayed on this page
  5. Copy both values — the auth token is a 32-character alphanumeric string
  6. In EcomCentral, add a new Jumpseller connection and paste both values
  7. Click ⚡ Test — a successful test returns your store name, URL, currency, and country
⚠️ Regenerating your auth token invalidates the old one immediately. If you regenerate, update the token in EcomCentral as well.

Credentials Reference

KeyRequiredDescriptionExample
login Required API login key from Admin Panel → Account → API section abc123xyz
authtoken Required 32-character API auth token from the same API section a1b2c3d4e5f6789… (32 chars)
✅ Alternative key names accepted: api_login for the login key; auth_token or token for the auth token.

API Endpoints Used

OperationMethodEndpoint
Test connectionGET/store/info.json
List ordersGET/orders.json?page=P&limit=N
Orders countGET/orders/count.json
Order detailGET/orders/{id}.json
Update order trackingPUT/orders/{id}.json body: {"order":{"tracking_number","tracking_company","shipment_status"}}
List productsGET/products.json?page=P&limit=N
Products countGET/products/count.json
Product detailGET/products/{id}.json
Update product stockPUT/products/{id}.json body: {"product":{"stock":N,"stock_unlimited":false}}
ℹ️ List response format: all list endpoints return a bare JSON array where each element is wrapped under a singular key — [{"order":{...}},{"order":{...}}] for orders, [{"product":{...}}] for products.

Count: total item counts are not embedded in list responses. Each resource has a separate /count.json endpoint that returns {"count":N}.

Auth: every request includes ?login={login}&authtoken={authtoken} as query params. All paths end in .json.

Order Status Values

StatusColorMeaning
Pending Payment Blue Order placed but payment not yet received
Payment Received Blue Payment confirmed; awaiting fulfillment
Processing Blue Order is being prepared for shipment
Paid Green Payment received and order confirmed
Shipped Green Order has been shipped to the customer
In Transit Blue Shipment is on the way
Delivered Green Shipment delivered to the customer
Awaiting Pickup Amber Order ready for customer to collect
On Hold Amber Order paused; requires manual action
Completed Green Order fully complete
Fulfilled Green All items have been fulfilled
Cancelled Red Order was cancelled
Refunded Red Payment was refunded to the customer
Failed Red Payment or processing failed

Supported Features

FeatureSupportedNotes
View orders (paginated)Order ID, date, status, total with currency
View order detailCustomer info, billing address, shipping address, line items, tracking info
Add / update trackingTracking number + carrier; sets shipment_status to Shipped automatically
View products (paginated)Product ID, SKU, name, price, stock (∞ for unlimited)
View product detailFull product data including images, categories, description, store link
Update stock quantityBy product_id; sets stock_unlimited to false and stock to requested quantity
Stock unlimited flagProducts with stock_unlimited: true display stock as ∞
Test connectionReturns store name, URL, currency, and country from /store/info.json

Troubleshooting

✕ 401 Unauthorized

The login key or authtoken is incorrect, or the token was regenerated after saving the connection. Go to Account → API in your Jumpseller admin panel, copy the current credentials, and update the connection in EcomCentral.

✕ 404 Not Found

All Jumpseller API paths must end in .json — e.g. /orders/123.json. If you see 404 errors, verify the base URL is exactly https://api.jumpseller.com/v1 with no trailing slash. Custom base URLs are only needed for self-hosted or sandbox environments.

✕ Rate limit / 429 Too Many Requests

Jumpseller enforces per-minute rate limits on their API. EcomCentral pages results (default 50 per request, max 100) to reduce call frequency. If you hit rate limits during large syncs, wait a minute and retry. Contact Jumpseller support to request a higher limit for your plan.

✕ Connection error / SSL error

Verify that https://api.jumpseller.com is reachable from your EcomCentral server. EcomCentral connects over HTTPS with peer verification enabled.