Purchase create intent
purchase_create_intentCreates a purchase intent to reserve a product, lock price, VAT, and shipping, and obtain an intent ID valid for 15 minutes for confirmation.
Instructions
Create a purchase intent for a product. Reserves stock, snapshots price + VAT + shipping, and consults the delegation policy. Returns an intent id; intents expire after 15 minutes if not confirmed. Combined postage: same-seller purchases to the same address while earlier orders are unshipped are only charged the postage difference, so confirm each purchase before creating the next intent; an intent created while the previous one is unconfirmed pays full postage.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"product_id": "<product_id>",
"quantity": "<quantity>"
},
"name": "purchase_create_intent"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quantity | Yes | Units to buy, 1-100. Defaults to 1. | |
| address_id | No | UUID of a saved shipping address; defaults to the buyer's default address. | |
| product_id | Yes | UUID of the product to purchase. | |
| payment_method_id | No | UUID of a saved payment method owned by the buyer; defaults to the buyer's default card. |