MXR
Documentation

Build with MXR.

Everything you need to launch experiences, put them in front of customers and measure what they do.

Quick start

  1. Create your free account and finish the short onboarding.
  2. Open Experiences → New experience, choose a type and add your product.
  3. Copy the store button, download the QR code, or share the link.

Experiences

Virtual Try-On shows a product on the shopper's face through their camera. Use a built-in style or upload a front-facing transparent PNG of your product. Fine-tune fit size and position in the editor.

Spatial Try-On and AR Experiences use a 3D model (.glb or .gltf). On iPhone, AR is created automatically, or you can upload a .usdz file. Models up to 50 MB are supported; under 10 MB loads fastest.

Store button

Paste one line on any product page. The button opens your experience in an elegant overlay without leaving the page.

<script src="https://mxr.ventureship.xyz/embed.js"
  data-mxr="YOUR-EXPERIENCE-SLUG"
  data-label="Try it on"
  data-color="#d9b97a"
  async></script>

Optional: data-target="#selector" places the button inside a specific element. Call MXR.open('slug') from your own button.

QR codes & links

Every experience lives at https://mxr.ventureship.xyz/x/SLUG. QR codes are available as SVG for print and PNG for everything else:

https://mxr.ventureship.xyz/api/qr/SLUG          # SVG
https://mxr.ventureship.xyz/api/qr/SLUG?format=png  # PNG, 1024px

Sales tracking

On your order confirmation page, report the sale. MXR attributes it to the last experience the shopper opened.

<script src="https://mxr.ventureship.xyz/embed.js" async></script>
<script>
  window.addEventListener('load', function () {
    MXR.track('conversion', { value: 129.00, orderId: '1001' });
  });
</script>

Prefer server-side? Use the events API. Connected Stripe accounts are tracked automatically.

Telepresence

Create a session in Telepresence, press Start session and share the code or link. Your field team opens https://mxr.ventureship.xyz/join on any phone, no account needed. Draw on the live view to guide them; marks appear on their screen instantly.

Billing

Every member gets a monthly free tier. Beyond it, usage statements arrive every 30 days with a secure link to pay. Subscriptions renew automatically every 30 days, and one-time purchases such as credit packs are paid upfront; credit is applied to your usage invoices automatically. You can pay any amount toward an invoice at any time. If an invoice becomes past due, experiences pause until it's paid in full. See pricing.

API reference

Create an API key in Integrations. Send it as a Bearer token. All responses are JSON.

List experiences

curl https://mxr.ventureship.xyz/api/v1/experiences \
  -H "Authorization: Bearer mxr_live_..."

Report a sale

curl -X POST https://mxr.ventureship.xyz/api/v1/events \
  -H "Authorization: Bearer mxr_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type":"conversion","slug":"YOUR-SLUG","amount":129.00,"currency":"usd","order_id":"1001"}'

Order IDs are de-duplicated, so retries are safe. Amounts are in major units (dollars) up to 999,999.99.