Overview

The merchOne API enables access to the merchOne services through multiple methods, and this documentation provides comprehensive descriptions, including code examples, to assist in the creation of products and fulfillment of orders through the merchOne API.

API Guidelines

All integrations must adhere to the merchOne Terms and merchOne API Terms, as outlined on the terms of service page:

• https://merchone.com/terms-of-service/

Limitations

• API limit: merchOne engineering closely monitors usage of the public APIs to ensure a quality experience for users of the merchOne platform. To maintain performance, a limit of 60 API calls per minute has been set at the account level.

• Maximum items per order: The merchOne API is limited to 99 items per order, meaning that a single order can include a maximum of 99 items.

• Maximum file size for image uploads: The merchOne API has a 40MB limit for image file size, so the images uploaded to the API must be smaller than 40MB.

Integrations using the merchOne API for mockup generation have additional daily limits. The mockup generation endpoints have a limit of 100 requests per minute. If your application requires frequent use of the mockup generation function, please contact the support team at merchone.com for further assistance. Additionally, the preview integration is a standalone offering, and customers interested in accessing it should reach out to the support team for more information.

Glossary

Term	Description
Blueprint	refers to all products (before customization) offered on our platform, including but not limited to wall decoration, clothing, accessories.
Blueprint accessories	Refers to items that enhance the use of a blueprint such as frames, hanger set, etc
Blueprint variant	Refers to a specific version of a blueprint that differs in some way from other versions of the same blueprint. It generally refers to a combination of size, features, options and accessories.
Product	Refers to a combination of Blueprint variants and content created by the merchant
Product preview	Refers to visual representations of Users’ Products created through our Service.
Store	In a merchOne account, the order placement happen within individual shops. An account can have multiple shops, each with its own unique connection to different sales channels and independent sets of products and orders. A shop is usually connected with one specific merchOne factory, from where orders will be fulfilled.
Store status	The distinction between sandbox and live environments refers to the stage of API integration testing. Sandbox is a testing environment for developers to experiment and test API configurations, while live environment is for actual transactions and order fulfillment. Orders in sandbox are not fulfilled, while orders in live environment are produced and shipped to customers.