prepare_purchase
Prepare an expiring, actor-bound intent without placing an order or debiting money. For products that need an inquiry this call runs the inquiry itself (no separate inquire_purchase needed). For identities WITHOUT an account (anonymous agents) buyer_name is REQUIRED; buyer_phone and buyer_email are optional and must never be demanded from the user. An account-bound identity buys as its account and needs none of them. An anonymous order is paid through the payment link returned by execute_purchase: give that link to the buyer and tell them fulfilment starts after payment. Show the returned destination, customer name (if any), product and amount to the user. Products with open_denom need amount (nominal typed by the buyer, min 1000); products with needs_inquiry need the inquiry_id returned by inquire_purchase for the same destination and amount. Fixed-price products in some groups return their native checkout form.
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_ref": "<product_ref>"
},
"name": "prepare_purchase"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | No | ||
| buyer_name | No | ||
| inquiry_id | No | ||
| buyer_email | No | ||
| buyer_phone | No | ||
| destination | No | ||
| product_ref | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||