> For the complete documentation index, see [llms.txt](https://docs.violet.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.violet.io/ecom-platforms/miva.md).

# Miva Merchant

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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.violet.io/ecom-platforms/miva.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.