Quick buy
quick_buyPrice an instant checkout for one listing. This does not charge the card. When the signed-in buyer has a saved card and the total is under US$1,000, the result is a summary (items, shipping, total, seller) plus a confirmation_token. Call confirm_purchase with that token and payment.saved_card true to charge the saved card. If there is no saved card, or the card needs authentication (including charges of US$1,000 or more), the result includes the existing checkout link instead. The listing's seller sells the goods. ForthClear runs the marketplace and Stripe processes the payment. buyer_email is required. quantity must be a positive integer below the listing's quote threshold (quote_quantity_threshold from get_product_details). A threshold of 1 means no quantity can be bought instantly. Use request_quote. The listing must have instant checkout and a shipping price. Requires sign-in with buyer access. OAuth discovery: /.well-known/oauth-authorization-server (scope buyer:purchase). Sensitive: requires user approval each time.
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>",
"buyer_email": "<buyer_email>",
"idempotency_key": "<idempotency_key>"
},
"name": "quick_buy"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Alias for product_id. | |
| slug | No | Alias for product_id. Public listing slug. | |
| quantity | Yes | Number of units to purchase | |
| productId | No | Alias for product_id. | |
| buyer_name | No | Buyer's full name | |
| product_id | Yes | Exact id from search, for example product_2731. productId, id, and slug are aliases. | |
| buyer_email | Yes | Buyer's email address | |
| buyer_company | No | Buyer's company name | |
| idempotency_key | Yes | Required. 8–200 characters (letters, digits, . _ : -). The same key returns the original result for 24 hours and is sent to Stripe as Idempotency-Key. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | No | ||
| is_test | No | ||
| message | No | ||
| payment | Yes | ||
| success | Yes | ||
| checkout | Yes | ||
| next_steps | Yes | ||
| total_cents | No | ||
| add_card_url | No | ||
| shipping_cents | No | ||
| fallback_reason | No | ||
| seller_of_record | No | ||
| confirmation_token | No |