Search products for a buyer intent. Returns ranked candidates with price, availability and product_id.
Call get_product(product_id) before quoting a specific variant. Prices in major units (USD).
输入参数agentlimitquery必填countrymax_price_usd
Live details for one product: variants, price, stock status, checkout links.
输入参数agentcountryproduct_id必填
Start a purchase. v0 returns the merchant's checkout link for the chosen variant plus a Kaupia
checkout_id. Keep the checkout_id and call report_outcome later so the order is covered and ranked.
输入参数agentquantityproduct_id必填variant_id必填
Report what happened to a checkout: placed | delivered | wrong_item | late | refunded | failed.
输入参数noteoutcome必填checkout_id必填
Delivered price for one variant to a US zip code: item + the store's own shipping rate for that address +
estimated sales tax, plus the delivery estimate. Nothing is bought. Use it to compare real totals across stores.
输入参数zip必填statequantityproduct_id必填variant_id必填
Order through Kaupia. customer = {name, email, address1, address2?, city, state, zip, phone?} (US only).
The user pays Kaupia the delivered price at pay_url (Stripe); Kaupia buys from the store and it ships to the
user; late, wrong or missing = refund. Confirm item, address and total with the user before calling.
输入参数agentcustomer必填quantityproduct_id必填variant_id必填
Status of an order placed through Kaupia (received → paid → placed → shipped → delivered) with tracking.
输入参数order_id必填
Per-shop outcome stats collected through Kaupia (delivered vs problems).
无需输入参数。