Checkout for Miva

Integrate the Checkout module for Miva.

Follow the steps in this guide to integrate Zonos Checkout with your Miva store.


Seamlessly integrate Checkout with your Miva store by following the steps in this section.


Get started

Start by completing our sign-up form. Onboarding will commence once your account agreement is in place.



Within 24 hours of signing up, a dedicated onboarding representative will contact you to kick off a tailored integration process.

Important: The steps listed below are for your reference and you will be guided through them by your onboarding representative.


Install the Checkout module

Zonos recommends

Install the module on a staging site for testing before pushing live.

  1. Download the module.
  2. Log in to your Miva Merchant account, then click Settings -> Modules.
  3. Search for Zonos, then click Install next to the Zonos Integration Module.

Configure Miva

Our Miva Checkout module does not have a test mode. Once the Store ID, API Key, and Site Key have been added, Zonos will be live on your site. These credentials connect the settings in your Dashboard to your Miva website. We recommend that you install the module on a staging site first. If you do not have a staging site, add the three keys to your live site while testing, then remove the three keys until you are ready for Zonos to be live.

  1. Navigate to the Checkout module in Miva by going to Miva -> Settings -> System Extensions -> Zonos.
  2. Enter your integration credentials to link your Dashboard settings to your Miva site.
    1. Copy your Zonos account number from Dashboard and input it as your Store ID.
    2. Copy your REST API key from Dashboard and input it as your API Key.
    3. Copy your Zonos Hello Site Key from Dashboard and input it as your Site Key.
  3. Add your Subdomain. For, you would enter the following in the subdomain field: teststore
  4. Select your Image Type. If you are unsure, keep Main to start.
  5. Adjust Countries to reflect which country is domestic for you.
  6. Add your email address to Notify on order status error to inform you if there are order status errors.
  7. Map any additional fields that you would like. We recommend mapping HS code if you have set product-specific HS codes in your Miva product listings. This is not required to produce a duty and tax quote since we can use product-specific HS codes you have entered into Catalog or use your default HS code. However, it is recommended; the accuracy of landed cost calculations will greatly increase with correctly classified products. 1. To map a field in Miva, create a custom field for the HS code and then map it under System Extensions > Zonos.
  8. Click Update in the top right.

Test your integration

Now that you have set up your account and your module, you are ready to test by doing the following:

  • Test shipping quotes
  • Place a test order on your site
  • Test order flow through your systems
  • Test your website

Learn how to run these tests. You will need to enable the Miva module while testing. To do so, add your store credentials to the module in Miva.

After completing testing, you are now ready to go live! To do so, add your Zonos credentials to your Miva Checkout module in your live store.

Need help?

If you have questions, please contact our support team. If you are currently working with a Professional Services Project Manager to onboard your account, please reach out to them for assistance.

Frequently asked questions 

What product information should I provide for the most accurate quote on duties, taxes, and shipping costs?

Product information can impact the amount of duties and taxes due and the shipping cost. The more product information you provide to Zonos, the more precise the quote returned will be. Zonos can generate a quote even when this information is unavailable, but recommends providing the following key product details to improve accuracy:

  • Weight: Weight impacts your shipping cost, which can affect duties or taxes. Weights in your Miva product listings are automatically used by Zonos when present.
  • Dimensions: Dimensions may impact your shipping cost, which can affect duties or taxes. Zonos can utilize product dimensions (length, width, and height) set on each product in Miva, but you must map it in the Zonos app for proper integration.
  • HS codes: HS codes impact duty rates and can sometimes affect taxes. Zonos can use the HS codes set in your product listings in Miva, but you must map the HS code field in the Zonos app.
  • Country of origin: A product's country of origin impacts duty rates and may affect taxes. Miva cannot send the country of origin for your products to Zonos so they must be added using Zonos Catalog.

Product details passed to Zonos by Miva

Product detailsWeightsDimensionsHS codeCountry of origin
Automatically passed
Must be mapped
Add with Catalog

Note: Alternatively, you can enter any of the above info into Catalog, overriding the information stored and passed from Miva.

Learn more about product info by platform.

Was this page helpful?