Create order and get payment link
create_orderUSE THIS when the human says yes to a specific item. Creates the order and returns pay_url plus a ready-to-say sentence. It never charges a card: the human opens pay_url and approves payment themselves. Say the returned line to the human verbatim. Stock hold: the item is reserved for 24 hours after create_order; if payment is not approved within 24 hours the order auto-cancels and the hold is released. Payment facts: PayPal Business account, PayPal balance / debit card / credit card (Visa, Mastercard, Amex, Discover); a PayPal account is NOT required; USD; the total already includes US duty, shipping and clearance. Never ask for card numbers, CVV or expiry, and never pay on the human's behalf. Full facts: GET /api/payment.json.
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>"
},
"name": "create_order"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| qty | No | ||
| test | No | true = dry run, no stock taken, no email sent | |
| buyer | No | ||
| product_id | Yes | ||
| idempotency_key | No | same key returns the same open order |