Qomvia

QMP · Qomvia Market Protocol v1

One file makes your shop buyable by agents.

The open wire between AI agents and your checkout: discovery, signed orders, payment on your own page.

Read the spec List my shop
QMP v1 · qomvia.com ⇄ yourshop.ch
QQomviayourshop.ch
  1. 01
    GET /.well-known/qomvia.json200 · feed, orders, terms
  2. 02
    POST /qomvia/orders · v1=HMAC201 · paymentUrl
  3. 03
    buyer pays on your checkout
  4. 04
    POST /orders/ses_9f2e/eventspaid · CHF 92.30
1
Discovery file
4
Order endpoints
300 s
Signature window
0
Payments via Qomvia

01Discovery

Found by every agent. No sales call.

Publish /.well-known/qomvia.json and your feed, orders and terms are one fetch away.

  • Feed URL and format
  • Order endpoint and currency
  • Return window and terms
See the discovery fileWhat merchants control
yourshop.ch/.well-known/qomvia.json
1// yourshop.ch/.well-known/qomvia.json
2{
3  "qmp": "1",
4  "feed": "yourshop.ch/feed.xml",
5  "orders": "yourshop.ch/qomvia/orders",
6  "currency": "CHF",
7  "terms": { "returnWindowDays": 30 }
8}

Connection · Passing

Listed on Qomvia Market

02Signing

Every order signed both ways.

One HMAC shape for Qomvia's calls and your events back.

  • Bearer key plus HMAC-SHA256
  • 300-second replay window
  • Idempotent on the session id
Read the signing rules
POST yourshop.ch/qomvia/orders

Authorization: Bearer ••••••••

Qomvia-Timestamp: 1759056000

Qomvia-Signature: v1=9f2e…c41a

HMAC-SHA256(key, "ts.body")

skew ≤ 300 s · replay refused

201 verified · order ord_1842

03Orders

Four endpoints. A real order in your shop.

Create, read, list and cancel. The agent gets your payment link.

  • 201 with orderId and paymentUrl
  • Reconcile by code and timestamp
  • Cancel unpaid orders
See the endpointsOpenAPI
yourshop.ch/qomvia/orders
  • POST/qomvia/orders201
  • GET/qomvia/orders/ord_1842paid
  • GET/qomvia/orders?code=QV-&since=…200
  • DELETE/qomvia/orders/ord_1840204

Three ways in

Start with a feed. Win with QMP.

At an equal landed price, the deeper integration takes the order.

  1. 01

    Feed only

    A feed, a coupon CSV and a redirect template. No code.

    Listed

  2. 02

    Adapter

    Shopify, WooCommerce or Shopware create the order in your shop.

    Ranked above feed-only

  3. 03

    QMP native

    Your shop answers agents directly over QMP.

    Ranked first at equal price

Conformance

Ship it. Prove it.

A reference shop and a conformance runner check discovery plus a full create, get, list and delete cycle.

npm run qmp:shop -- ./fixtures/market/velo.csv 4010
node scripts/qmp-conformance.mjs \
  http://localhost:4010 shop-secret

PASS  discovery document
PASS  create returns orderId + paymentUrl
PASS  idempotent on sessionId
PASS  list coded orders
PASS  order gone after delete

All checks passed.

Agents buy from shops that answer.

List with a feed today. Speak QMP to rank first.

List my shop Read the spec
Qomvia MarketFor agents