Build the exact mandate to sign
Returns the mandate the shopper's device must sign and the exact signingMessage
(undo-intent-mandate-v1:<sha256 of the canonical mandate JSON>). Stateless; nothing is stored.
Request Body
application/json
The draft, the shopper's words and the device key that will sign.
What's needed to build the exact mandate a device will sign.
The shopper's request in their own words, kept verbatim inside the mandate.
3 <= length <= 1000The shopper's limits in structured form.
Base64 Ed25519 public key.
40 <= length <= 60How the agent may pay.
Value in
- "saved_wallet"
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/api/mandates/prepare" \ -H "Content-Type: application/json" \ -d '{ "request": "A black hoodie in size M under $80", "draft": { "item": "black hoodie", "category": "hoodie", "quantity": 1, "maxPrice": 80, "currency": "USD", "attributes": { "color": "black", "size": "M" }, "mustAsk": [] }, "shopperKey": "aHBQ5B27O2BiDV0oWgOigpsXZKjOfhcYYMch5pZ5H0c=" }'{ "mandate": { "version": 1, "id": "2f4069f0-2367-4f08-acc6-d9cf1cf6669a", "createdAt": "2026-10-20T04:18:17.928Z", "expiresAt": "2026-11-03T04:18:17.928Z", "shopperKey": "aHBQ5B27O2BiDV0oWgOigpsXZKjOfhcYYMch5pZ5H0c=", "request": "Buy me black men's running shoes, size 10, under $120", "intent": { "item": "running shoes", "category": "running shoes", "quantity": 1, "maxPrice": 120, "currency": "USD", "attributes": { "size": "10", "color": "black" }, "gender": "male", "mustAsk": [] } }, "signingMessage": "undo-intent-mandate-v1:7bf66d54681f2b73e2f05ee0d49b5a68776908620751daaf0102b9f0b17fcac6"}Draft a mandate from the shopper's words POST
Turns a plain request into structured limits for the shopper to review. Nothing is stored. Rate limited per visitor.
Store a signed mandate POST
Re-verifies the signature, freshness, expiry and readiness, then writes the first event of the mandate's hash chain.