Connect Modes

Connect Modes

A provider works in one mode. The mode decides which webhooks Selldone calls and which data it reads from or writes to your service. The definitions below come from the panel's enums in resources/js/enums. The sample project itself is set to Migration and implements all webhooks except Fetch customers.

Modes

Mode	Description
Migration	Get products, categories, and customers. After the user deletes this service, the received products, categories, and customers will not be deleted.
Dropshipping	Get products, categories, and orders. The system removes products after the user removes the service.
Marketplace	Just sync inventory and receive orders (products are linked by SKU).
Accounting	Send orders and financial information.
Other	Other services.

Webhooks per mode

Webhook	Migration	Dropshipping	Marketplace	Accounting	Other
Notify shop	✓	✓	✓	✓	✓
Fetch categories	✓	✓			✓
Fetch products	✓	✓			✓
Fetch customers	✓				✓
Create order		✓	✓	✓	✓
Confirm order manually		✓	✓		✓
Get order status		✓	✓		✓
Cancel order		✓	✓	✓	✓

Access scopes per mode

Mode	Scopes
Migration	Read categories, Read products, Read customers
Dropshipping	Read categories, Read products, Read orders, Write orders
Marketplace	Read orders, Write orders
Accounting	Write products, Write categories, Write orders, Write customers
Other	All read and write scopes

Scope meanings

Scope	Meaning
Read categories	Selldone reads categories from the external provider and adds them to Selldone stores.
Write categories	The external provider can read information about connected categories.
Read products	Selldone reads products from the external provider and adds them to Selldone stores.
Write products	The external provider can read information about connected products.
Read orders	Selldone reads existing orders from the external provider, mostly to update order status, and in some cases adds external orders to the merchant's order processing center.
Write orders	When a related order is created, Selldone informs the external provider.
Read customers	Selldone reads customers from the external provider and adds them to Selldone stores.
Write customers	The external provider can read information about customers.

Authentication modes

Mode	Description
OAuth 2.0 (Recommended)	The user grants Selldone access on your website; Selldone receives an access token and sends it as Authorization: Bearer <token>. Implemented by this sample — see Authentication Flow.
Username / Password	HTTP basic authentication: Authorization: Basic <credentials>, where credentials is the Base64 encoding of ID and password joined by a colon.

Related

• Webhooks
• Authentication Flow
• Provider Setup