Webshop integration

Server-side tracking for Miva

ROASaurus reads paid Miva orders through the JSON API and sends them to your ad platforms from the server.

Miva at a glance
Orders arrive byJSON API polling every 5 minutes; optional order workflow webhook
CredentialsAPI token with OrderList_Load_Query, signed with HMAC-SHA256
Paid ordersCaptured in full, or with an authorization or capture payment
Thank-you snippetInvoice page (INVC), using the order id

How Miva connects

  1. Add the ROASaurus script to your global head tag and the thank-you snippet to the invoice page.
  2. Under Users › API Tokens, create a token with the order list function and a signing key. Enter the JSON API URL, store code, token and key in ROASaurus.
  3. Optionally add an order workflow webhook to your ROASaurus webhook URL. ROASaurus then fetches each new order right away.

What ROASaurus reads from each order

The order id, total, the billing email, name, phone and address, the customer id, and each item's code, SKU, name, quantity and price.

Limits

  • Miva orders carry no currency; ROASaurus uses the store currency you set in ROASaurus.
  • The JSON API needs Miva 9.12 or later.
  • The connector is built from the platform's official API documentation. Press Test connection after saving your credentials, then place a test order and check the Event log.

Related

FAQ

Questions, answered

Is the signing key required?

No, but it is recommended: every request is then signed with HMAC-SHA256.

Are orders sent before payment?

No. An order counts once it is captured in full or has an authorization or capture payment.

Every sale, traced to the ad that earned it

Server-side tracking, profit and lifetime value in one app. Free plan, no credit card.

Start free →