M2M Commerce Store
A shop builder for one storefront that both people and AI agents can buy from. Prices in each currency you choose, five languages, and shipping by country. People send order requests; agents order under a spending mandate and the buyer’s passkey.
No payments are taken on the platform: buyers pay you directly, through your own payment link.
What it does
For sellers
- Build the shop in the portal: categories nested up to five levels, products, photos.
- A price per currency, set by you: no exchange rates applied behind your back.
- Product names and descriptions in English, French, German, Spanish and Italian.
- Shipping zones by country, with a free-shipping threshold and an optional import-duty estimate.
For people
- Your storefront at portal.shadow-warden-ai.com/s/your-store, in the buyer’s language.
- Buyers pick currency and metric or imperial units; shipping is quoted for their country.
- They send an order request with their address. You accept, decline, ship and complete it.
- A private link lets the buyer follow the request and cancel it until you answer.
For AI agents
- A UCP-format catalog feed per store, readable without an account.
- Offers reserve stock for 45 seconds, so two agents cannot buy the last item twice.
- An agent order needs the buying tenant’s passkey on that exact offer.
- Spend is checked against the buyer’s mandate and written to the STIX audit chain.
What it does not do yet
- The platform takes no payments.
- The buyer pays you directly, through your own payment link or bank details. We never see or hold the money, so a refund or chargeback is yours to handle. Card payments on the storefront and platform payouts are not built.
- “Paid” is your word.
- You mark an order paid. Nothing here checks that the money arrived.
- “AP2” is spend accounting.
- For agent orders it debits the remaining balance of the buyer’s mandate in our own ledger. No money moves between accounts.
- Import duty is your estimate.
- Buyers see it as an estimate, outside the order total. Customs sets the real amount.
- No stores are open yet.
- The builder and storefront are deployed. No seller has opened a store yet.
How an order moves
Cart → shipping quote for the country
→ order request (contact details sealed)
→ PENDING_MERCHANT
├─ seller declines → REJECTED
├─ buyer cancels → CANCELLED
└─ seller accepts → ACCEPTED (stock taken)
→ PAID (the seller's word) → SHIPPED → COMPLETED
Payment: the buyer pays the seller directly, through the seller's
own link. The seller marks the order paid. UCP feed → offer (stock reserved 45 s) → passkey challenge for that offer → order: assertion verified, challenge consumed → spend authorization + mandate balance → stock committed → STIX audit entry No funds move: the mandate balance is accounting, not a payment.
API reference
A selection. The full list is in the OpenAPI document.
Builder: your session or API key
/m2m-store/stores Create a store: slug, currencies, languages. /m2m-store/stores/{id}/categories Add a category; parent_id nests it. /m2m-store/products Create or update a product. /m2m-store/products/{id}/prices Set one price per currency, in minor units. /m2m-store/products/{id}/translations/{locale} Name and description in one language. /m2m-store/products/{id}/images Upload a photo (JPEG, PNG or WebP). /m2m-store/stores/{id}/shipping-zones Countries, rate, free-over threshold, duty estimate. /m2m-store/stores/{id}/order-requests Order requests with the buyer’s contact details. /m2m-store/order-requests/{id} Accept, decline, mark paid, ship or complete, with a note. /m2m-store/order-requests/{id}/payment-link Attach your own payment page to an accepted request. Storefront: anonymous, rate-limited
/m2m-store/storefront/{slug} Store name, currencies, languages, categories. /m2m-store/storefront/{slug}/catalog/ucp Products with prices, stock, translations, photos. /m2m-store/storefront/{slug}/shipping/quote Shipping and duty estimate for a country and currency. /m2m-store/storefront/{slug}/order-requests Send an order request (5 per minute per address). /m2m-store/storefront/{slug}/order-requests/{id} Follow a request; needs its X-Order-Token. Agents: API key
/m2m-store/offers Request a priced offer; reserves the stock. /m2m-store/offers/{id}/challenge WebAuthn options bound to this offer. /m2m-store/orders Order with the passkey assertion and a mandate id. /m2m-store/orders/{id} Order status. Security
Tenant isolation
Every store, product and order row carries its owner’s tenant. A request for another tenant’s data answers 404.
Contact details sealed
Buyer addresses are encrypted at rest and never logged. Webhooks to the seller carry only ids and amounts.
Passkey per offer
A challenge is good for one offer and is consumed before the signature is checked, so an approval cannot be replayed.
Server-side prices
Totals are recomputed from your prices and zones; whatever the browser sends is ignored.
Rate limits
Storefront reads, order requests and agent calls each have a per-caller limit and answer 429 beyond it.
Input screening
Agent request strings are checked against injection patterns; free text is length-capped.
Open your store
Every plan can open a store, including the free Starter plan.