Miva Merchant

Overview of Violet's Miva Merchant integration for channel developers

Miva Merchant is a mid-market to enterprise ecommerce platform with a single-endpoint JSON API. All API calls are authenticated using HMAC-SHA256 request signing.

Connection

Merchants provide the following credentials:

Field	Description
API Token	The API access token from the Miva admin
Signing Key	Base64-encoded HMAC-SHA256 signing key
Store Code	The Miva store code (not the URL)
Store URL	The API endpoint URL (e.g. https://store.example.com/mm5)

All credentials are available in the Miva admin under User Management (for the API token and signing key).

Webhooks / Notifications

Miva does not expose an API for programmatic webhook registration. Merchants must configure notifications manually in the Miva admin under Utilities → Notifications, pointing each topic to the Violet webhook gateway URL.

Violet receives the following notification types:

• product.* — triggers a product sync

• order.* — triggers an order sync

Inbound notifications are verified using HMAC-SHA256 with the merchant's signing key.

Notable Behavior

• Single endpoint: All Miva API calls are POSTed to a single endpoint (/json.mvc), differentiated by a Function parameter. Violet handles this internally.

• Product enrichment: Miva requires separate API calls to fetch product images, attributes, and variants. Violet makes these calls in parallel to minimize latency during catalog sync.

• Currency: The Miva API returns a numeric currency ID rather than an ISO currency code. Currency must be configured on the merchant record separately — it cannot be auto-detected from the platform.

• Order cancellation: Miva does not provide an API for canceling orders. Cancellations must be handled through the Miva admin panel.

• Price format: Miva uses decimal dollar values (e.g. 19.99), not integer cents.