search_products
Search products
Search public sellable variants by words, brand/category/purpose, skin type, ingredient, availability and price in SGD cents. Use variant_id when adding items; follow next_page for more results.
输入参数qpagebrandlimitpurposecategoryin_stockmax_pricemin_priceskin_typeingredient
get_product
Get product details
Get product descriptions, ingredients, usage, images and variants. product accepts a product ID, product slug, variant slug or SKU.
输入参数product必填
Create an empty persistent cart without account login. Save cart_id, version and the private guest_token if returned. Pass guest_token on subsequent shopping calls. Account authentication is optional.
输入参数guest_token
Read cart items, coupon, version and checkout lock.
输入参数cart_id必填guest_token
set_cart_item
Set cart item quantity
Add or update a variant using an absolute quantity; zero removes it. Supply the current cart version. Maximum 20 variants and 99 units each; availability is checked.
输入参数cart_id必填version必填quantity必填variant_id必填guest_token
set_cart_coupon
Set cart coupon
Apply a coupon code or null to remove it. Supply current cart version. Auto discounts also apply.
输入参数cart_id必填version必填coupon_code必填guest_token
Reprice the cart with current stock, scheduled prices and discounts. All amounts are SGD cents; shipping is free within Singapore. Stock is not reserved. Save version and total for checkout.
输入参数cart_id必填guest_token
create_checkout
Prepare checkout
Prepare a Tanatasa checkout review link for a quoted cart. Provide quoted version and expected_total in SGD cents. Keep the same idempotency_key and input on retries. Locks cart. Buyer reviews items and enters contact/delivery details on Tanatasa before paying. No payment occurs in this tool; get_order reports progress and webhook-confirmed status.
输入参数cart_id必填version必填guest_tokenexpected_total必填idempotency_key必填
get_order
Get purchase status
Get payment and fulfilment status and tracking for a purchase created by this guest session or account connection. Supply guest_token for guest purchases. Payment confirmation comes from Stripe webhooks. Does not update prior purchases.
输入参数order_id必填guest_token
checkout_session
Prepare checkout from product items
Prepare checkout from product feed item IDs and quantities without account login. For guests, call create_cart first and supply its guest_token. Optional item metadata is not authoritative. Returns a Tanatasa review link; the buyer enters delivery details and approves payment. Supply a new idempotency_key per purchase and retain it and guest_token on retries.
输入参数guest_tokenidempotency_keycheckout_session必填