Supplier documentation

Feed your app and retrieve orders through the API.

Connect your ERP, e-commerce platform, POS or business software to SellViaApp. Send categories, products and prices, then retrieve confirmed shop orders as JSON.

Base URLhttps://api.sellviaapp.com/
Required headersX-API-Key + Bearer
Developer supportapi@sellviaapp.com

Quick start

Authenticate, choose a route, test.

Get the X-API-Key and generate the Bearer in Dashboard → API. Enter them below, then use “Test · Generate” on an endpoint to obtain the response and cURL, PHP 8 or JavaScript code.

Credentials incompleteEnter the X-API-Key and Bearer token to prepare a test.

Credentials remain in memory for this page only. For a customer-related operation, add customer_id.

Keep in mindHTTPS + JSON · keep both credentials server-side · never send tokens to support.

Real time

Connect SellViaApp to any HTTPS-capable system.

A webhook alerts your ERP, CRM, automation or software whenever a product, customer, cart, order, document or important setting changes. Use the API to retrieve the full authoritative object when needed.

Create the destination

In Dashboard → Webhooks, enter an HTTPS URL and select events. The secret is shown once.

Verify the signature

Compute HMAC-SHA256 over timestamp.delivery_id.raw_body and compare it with X-SellViaApp-Signature.

Acknowledge quickly

Return HTTP 2xx, deduplicate with X-SellViaApp-Event-Id, then process in the background.

Reliable deliveryUp to eight attempts with progressive delays. A repeatedly failing destination is paused automatically, and every delivery remains visible and retryable in the Dashboard.
payload = timestamp + "." + delivery_id + "." + raw_body
expected = "v1=" + HMAC_SHA256(payload, signing_secret)

Endpoints

Customers

Create and manage customer accounts for each shop.

5 routes
POST /customer/add API key

Create a customer and generate the supplier login.

GET /customer/list Key + Bearer

List or filter authorised customer information.

GET /customer/me Key + Bearer

Retrieve the signed-in customer profile.

PATCH /customer/update Key + Bearer

Update profile, language, type, email or password.

DELETE /customer/deleteaccount Key + Bearer

Deactivate the customer account in the active shop.

Endpoints

Catalogue

Categories, products, images, prices, stock, promotions and favourites.

18 routes
GET /fam1/list Key + Bearer

List primary categories.

POST /fam1/add Key + Bearer

Create a primary category.

PATCH /fam1/update Key + Bearer

Update a primary category.

DELETE /fam1/delete Key + Bearer

Hide a primary category.

GET /fam2/list Key + Bearer

List subcategories.

POST /fam2/add Key + Bearer

Create a subcategory.

PATCH /fam2/update Key + Bearer

Update a subcategory.

DELETE /fam2/delete Key + Bearer

Hide a subcategory.

GET /product/list Key + Bearer

List and search products with pagination.

GET /product/image Signed URL

Serve a signed, cacheable product image.

POST /product/add Key + Bearer

Create a product.

PATCH /product/update Key + Bearer

Update a product.

DELETE /product/delete Key + Bearer

Hide a product.

POST /product/favoris Key + Bearer

Add or remove a product from favourites.

GET /price/list Key + Bearer

List prices applicable to the customer group, falling back to the product sales price.

GET /mark/list Key + Bearer

List available brands.

GET /size/list Key + Bearer

List available sizes.

GET /libweb/list Key + Bearer

List web reference labels, falling back to catalogue labels.

Endpoints

Cart and orders

Manage the cart and confirm an order atomically.

10 routes
GET /order/list Key + Bearer

List every confirmed shop order with pagination.

DELETE /order/delete Key + Bearer

Clear and delete the current cart.

GET /order/total Key + Bearer

Calculate cart subtotal, VAT and total.

POST /order/shipping/quote Key + Bearer

Calculate shipping fees from the cart, fulfilment mode and country.

GET /order/count/line Key + Bearer

Count lines in the cart.

POST /order/sendtomegawin Key + Bearer

Confirm the order, fulfilment mode and address.

POST /orderline/add Key + Bearer

Add a product and quantity to the cart.

GET /orderline/list Key + Bearer

Retrieve current cart lines.

PATCH /orderline/update Key + Bearer

Update a line quantity.

DELETE /orderline/delete Key + Bearer

Remove a line from the cart.

Endpoints

Customer payments

Choose pay on delivery or open a secure Stripe payment, then retrieve its server-verified status.

4 routes
GET /payment/config Key + Bearer

Retrieve the enabled Stripe payment methods and the Stripe account provider selected for the app.

POST /payment/checkout/create Key + Bearer

Create or resume a Stripe Checkout page for an unpaid order or booking owned by the signed-in customer. A still-changeable pay-on-delivery choice is safely replaced.

POST /payment/pay-later Key + Bearer

Record pay on delivery or replace a still-open Stripe payment after its session is securely checked and expired.

GET /payment/status Key + Bearer

Retrieve a payment status; only the signed Stripe webhook can confirm it as paid.

Endpoints

Documents

Invoices, estimates, orders and their lines.

8 routes
POST /document/add Key + Bearer

Create a document linked to the customer.

GET /document/list Key + Bearer

List or filter documents.

PATCH /document/update Key + Bearer

Update a document identified by GUID.

DELETE /document/delete Key + Bearer

Delete a document and its lines.

POST /documentline/add Key + Bearer

Add a line and recalculate the document.

GET /documentline/list Key + Bearer

Retrieve a document with all its lines.

PATCH /documentline/update Key + Bearer

Update a line identified by GUID.

DELETE /documentline/delete Key + Bearer

Delete a line and recalculate totals.

Endpoints

Real-time webhooks

Automatically receive SellViaApp changes in your ERP, CRM, automation or business service.

10 routes
GET /webhooks/events Key + Bearer

List all available events and the contract version.

GET /webhooks/endpoints/list Key + Bearer

List destinations, status and counters.

POST /webhooks/endpoints/create Key + Bearer

Create an HTTPS destination and receive its signing secret once.

PATCH /webhooks/endpoints/update Key + Bearer

Update the destination, events or pause delivery.

DELETE /webhooks/endpoints/delete Key + Bearer

Soft-delete a destination.

POST /webhooks/endpoints/rotate-secret Key + Bearer

Replace the HMAC secret and reveal it once.

GET /webhooks/deliveries/list Key + Bearer

Inspect deliveries, responses, errors and attempts.

POST /webhooks/deliveries/retry Key + Bearer

Retry one delivery without replaying the others.

POST /webhooks/test Key + Bearer

Emit and deliver a signed test event.

GET /webhooks/stats Key + Bearer

Retrieve the last thirty days of delivery metrics.

Endpoints

Notifications and integrations

Mobile notifications and external synchronisation.

47 routes
GET /admin/notification/sendtomobile Key + Bearer

Retrieve mobile notifications.

POST /admin/notification/setdelivery Key + Bearer

Mark a notification as delivered.

POST /woocommerce/categories/sync Key + Bearer

Batch-sync WooCommerce categories and subcategories.

POST /woocommerce/products/sync Key + Bearer

Sync products, variations, images, prices, VAT, stock and visibility.

POST /woocommerce/customers/sync Key + Bearer

Create or update WooCommerce customer accounts without sending email.

PATCH /woocommerce/products/inventory Key + Bearer

Quickly update prices, promotions, stock or visibility only.

POST /woocommerce/products/archive Key + Bearer

Batch-archive deleted WooCommerce products without changing orders.

GET /woocommerce/orders/feed Key + Bearer

Retrieve confirmed orders with cursor-based reconciliation.

POST /woocommerce/orders/acknowledge Key + Bearer

Confirm that an order was imported into WooCommerce.

POST /woocommerce/webhooks/subscribe Key + Bearer

Register a signed HTTPS WooCommerce webhook.

GET /woocommerce/webhooks/list Key + Bearer

List active WooCommerce webhooks.

DELETE /woocommerce/webhooks/delete Key + Bearer

Disable a WooCommerce webhook.

POST /woocommerce/webhooks/process Key + Bearer

Process pending webhook deliveries with automatic retries.

GET /woocommerce/sync/logs Key + Bearer

View the technical synchronisation log.

POST /shopify/categories/sync Key + Bearer

Sync Shopify collections and product types.

POST /shopify/categories/archive Key + Bearer

Archive a deleted Shopify collection.

POST /shopify/products/sync Key + Bearer

Sync Shopify products, variants, images, prices, inventory and visibility.

PATCH /shopify/products/inventory Key + Bearer

Quickly update Shopify prices, inventory or visibility.

POST /shopify/products/archive Key + Bearer

Archive Shopify variants by identifier.

POST /shopify/products/archive-parent Key + Bearer

Archive every variant of a deleted Shopify product.

POST /shopify/customers/sync Key + Bearer

Sync Shopify customers without sending email.

POST /shopify/customers/redact Key + Bearer

Redact customer data requested by Shopify.

GET /shopify/orders/feed Key + Bearer

Retrieve SellViaApp orders not yet imported into Shopify.

POST /shopify/orders/acknowledge Key + Bearer

Acknowledge a Shopify order import.

POST /shopify/webhooks/subscribe Key + Bearer

Register the signed SellViaApp webhook for Shopify.

GET /shopify/webhooks/list Key + Bearer

List Shopify connector webhooks.

DELETE /shopify/webhooks/delete Key + Bearer

Disable a Shopify webhook.

POST /shopify/webhooks/process Key + Bearer

Retry pending Shopify notifications.

GET /shopify/account Key + Bearer

Identify the store and retrieve its mobile test account.

GET /shopify/sync/logs Key + Bearer

View Shopify logs isolated from WooCommerce.

POST /wix/connect Public

Connect a Wix instance to an existing SellViaApp Dashboard account.

GET /wix/account Key + Bearer

Identify the SellViaApp account connected to Wix and its mobile test account.

POST /wix/disconnect Key + Bearer

Revoke the connector token and disconnect Wix.

POST /wix/categories/sync Key + Bearer

Synchronise Wix Stores V1/V3 categories or collections.

POST /wix/products/sync Key + Bearer

Synchronise Wix products with images, prices, inventory and visibility.

PATCH /wix/products/inventory Key + Bearer

Quickly update Wix prices, inventory or visibility.

POST /wix/products/archive Key + Bearer

Archive deleted Wix products.

POST /wix/customers/sync Key + Bearer

Synchronise Wix contacts without sending email.

POST /wix/customers/redact Key + Bearer

Redact one or more synchronised Wix contacts.

POST /wix/privacy/shop-redact Key + Bearer

Remove Wix-origin data after uninstall.

GET /wix/orders/feed Key + Bearer

Read SellViaApp orders to reconcile with Wix.

POST /wix/orders/acknowledge Key + Bearer

Record the result of a Wix order reconciliation.

POST /wix/webhooks/subscribe Key + Bearer

Create a signed SellViaApp destination for the Wix connector.

GET /wix/webhooks/list Key + Bearer

List SellViaApp webhooks for the Wix connector.

DELETE /wix/webhooks/delete Key + Bearer

Disable a Wix connector webhook.

POST /wix/webhooks/process Key + Bearer

Process pending SellViaApp deliveries for Wix.

GET /wix/sync/logs Key + Bearer

View the isolated Wix synchronisation log.

Reference

Responses and errors

Each row has a “Parameters and responses” button showing required or optional fields, possible statuses and JSON examples. An empty list means the resource is not populated yet, not that the endpoint is down.

400Invalid request
401Authentication required
403Access denied
404Resource or route not found
409Business conflict
422Validation failed
429Too many requests
5xxTechnical incident

API workbench

Endpoint

GET

Generated code contains the credentials you entered. Keep them server-side and never share an unredacted screenshot.

Ready to test