Set up a connection to Miva

Miva is a digital media company that offers e-commerce software and services for small- and medium-sized businesses.

Miva documentation: API guide, Authentication
Additional reference: Supported Miva APIs

A. Set up a Miva connection

Start establishing a connection to Miva in either of the following ways:

• From the Resources menu, select Connections. Then, click + Create connection at the top right.
      – or –
• While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.

In the resulting Application list, select Miva.

The Create connection pane opens with required and advanced settings.

B. Supply required Miva account information

At this point, you’re presented with settings for providing Miva authentication:

Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.

Application (required, non-editable): A reminder of the app you’re editing.

API endpoint (required): Paste your unique account URL, provided in the Miva admin. For example, if your endpoint is set up at https://avim.mivamerchantdev.com/mm5/, enter avim.mivamerchantdev.com/mm5/.

Store code (required): Enter the code, as listed in your Miva store’s settings.

HMAC signature (required): Select the HMAC signature type. Select MIVA (no HMAC present), if “Accept requests without signature” is enabled inside the admin’s Signature section.

Private key (required): Enter the private key of your account. This key generated in the Miva admin as described below. Multiple layers of protection, including AES 256 encryption, are in place to keep your private key safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

API token (required): Enter the API token of your account. The token is generated in the Miva admin as described below. Multiple layers of protection, including AES 256 encryption, are in place to keep your API token safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

How to retrieve endpoint & token from Miva and set permissions

To copy your API endpoint, log in to your Miva admin and select Domain settings from the main menu. In the Site configuration section, copy the value of Base URL for graphics (without the protocol https://).

To retrieve your API token and set the connection’s permissions,

1. While still logged into Miva, select Users from the main menu.
2. On the Users page, open the API tokens tab.
3. Click the + button; the Add API token form opens to prompt you to edit the settings.

4. Name your new token.
5. Copy the generated Access token for your API access token, above.
6. Set the Allowed IP address to 0.0.0.0/0.
7. Select Accept requests without signature.
8. Select Accept requests without timestamp.
9. Click Save. 

Important: When generating tokens, make certain to follow these guidelines:

• Select Accept requests without timestamp
• Provide the IP address 0.0.0.0/0
• Provide required permissions for groups and functions

C. Edit advanced Miva settings

Before continuing, you have the opportunity to provide additional configuration information, if needed, for the Miva connection.

Borrow concurrency from (optional): Select another connection from the list....

Concurrency level (optional): Up to 25 allowed....

D. Test the connection

Once you have configured the Miva connection, you have a few options for continuing:

• Save – click this button to test the connection, commit the new connection so that it will be available to all integrations for your account
• Save & close – click to test and save the connection and exit the Create connection pane
• Cancel – click to exit without saving any new changes
• Test connection – click this button to verify that your new connection is free of errors

When you test or save the connection, it is verified before continuing. 

The new connection is now successfully added to your account. It will be applied to the current source or destination app, if you created it within a flow. Otherwise, you may proceed to register the connection with an integration.