mcp-gateway

 ⟨35 unchanged words⟩ ,"payment_mandate":{"anyOf":[{"additionalProperties":true,"properties":{"aud":{"description":"This store's slug (the one in the URL you are calling) — not a domain.","maxLength":256,"minLength":1},"type":"stringobject"},"currency":{"description":"Three-letter currency code; must match the cart's currency.","maxLength":3,"minLength":3,"type":"string"}],"exp":{"description":"Expiry as an INTEGER ofPayment Unixmandate seconds,issued inby the future — not an ISO 8601 date string.","exclusiveMinimum":0,"type":"integer"},"mandate_id":{"description":"Your identifierplatform for this mandate.","maxLength":128,"minLength":1,"type":"string"},"max_amount_cents":{"description"cart:"Spending limit the buyer gave you, as an integer in minor units (cents).","exclusiveMinimum":0,"type":"integer"},"sub":{"description":"Thecompact identityJWS you authenticate as — it is compared against it.receive Whenafter the credential tool returns a `mandate_subject`, use that value.","maxLength":256,"minLength":1,"type":"string"}},"required":["mandate_id","max_amount_cents","currency","exp","sub","aud"],"type":"object"},{"type":"string"}],"description":"Payment mandate with `mandate_id`,approval `max_amount_cents`opened (integer,by minor`preview_checkout` units),is `currency`granted (3 letters, must match the cart's),its `exp` (expiry as an INTEGER ofis Unix seconds — not an ISO 8601 date string), `sub` (the identity you authenticate as — it is compared against it) and `aud` (the store slugis this mandate isstore's for,slug). e.g.Forward theit slugas inreceived; thea URLmandate you arewrite callingyourself —is not a domain). It isaccepted ahere. spendingThe capapproval youis declarebound to limit yourself: ityour authorisesagent nothingcredential and does not proveverify thethat buyer'sa consent.person was present. Use this when your client cannot set an ⟨6 unchanged words⟩ 

 ⟨50 unchanged words⟩  complete_checkout. PAYMENT MANDATE: this tool also requires one. Send it as the `payment_mandate` argument if your client cannot set headers, or as an `X-Payment-Mandate` header. It must carry `mandate_id`one, `max_amount_cents`,issued `currency`,by `exp`,the `sub`platform, `aud`. Two of these are rejected outright if guessed: `exp` is an INTEGER of Unix seconds (not an ISOwritten 8601by date),you. andCall `aud``preview_checkout` isfor this store's slug (the onecart, inopen the URL you`approval_url` areit callingreturns, not a domain). Its `currency` must match thepoll cart's`approval_status_url` currency.with Demoyour Storeagent enforcescredential, `max_amount_cents`and againstsend the cart total; a real merchant may only observe thatmandate boundary,you soreceive enforceas the buyer's`payment_mandate` limitargument inor thean agent`X-Payment-Mandate` too.header. The mandateapproval is a spending cap you declarebound to limit yourself — it authorises nothing and does not prove the buyer'syour consentagent —credential and its `sub` must be the identity you authenticate as.cart; `max_amount_cents`it isdoes thenot spendingverify limitthat thea person you are buying for gave you: ask them if they gavewas none.present. Checkout guide: read the MCP resource trusteed://guides/checkout.

 ⟨256 unchanged words⟩ ,"payment_mandate":{"anyOf":[{"additionalProperties":true,"properties":{"aud":{"description":"This store's slug (the one in the URL you are calling) — not a domain.","maxLength":256,"minLength":1},"type":"stringobject"},"currency":{"description":"Three-letter currency code; must match the cart's currency.","maxLength":3,"minLength":3,"type":"string"}],"exp":{"description":"Expiry as an INTEGER ofPayment Unixmandate seconds,issued inby the future — not an ISO 8601 date string.","exclusiveMinimum":0,"type":"integer"},"mandate_id":{"description":"Your identifierplatform for this mandate.","maxLength":128,"minLength":1,"type":"string"},"max_amount_cents":{"description"cart:"Spending limit 

 ⟨62 unchanged words⟩ ,"payment_mandate":{"anyOf":[{"additionalProperties":true,"properties":{"aud":{"description":"This store's slug (the one in the URL you are calling) — not a domain.","maxLength":256,"minLength":1},"type":"stringobject"},"currency":{"description":"Three-letter currency code; must match the cart's currency.","maxLength":3,"minLength":3,"type":"string"}],"exp":{"description":"Expiry as an INTEGER ofPayment Unixmandate seconds,issued inby the future — not an ISO 8601 date string.","exclusiveMinimum":0,"type":"integer"},"mandate_id":{"description":"Your identifierplatform for this mandate.","maxLength":128,"minLength":1,"type":"string"},"max_amount_cents":{"description"cart:"Spending limit the buyer gave you, as an integer in minor units (cents).","exclusiveMinimum":0,"type":"integer"},"sub":{"description":"Thecompact identityJWS you authenticate as — it is compared against it.receive Whenafter the credential tool returns a `mandate_subject`, use that value.","maxLength":256,"minLength":1,"type":"string"}},"required":["mandate_id","max_amount_cents","currency","exp","sub","aud"],"type":"object"},{"type":"string"}],"description":"Payment mandate with `mandate_id`,approval `max_amount_cents`opened (integer,by minor`preview_checkout` units),is `currency`granted (3 letters, must match the cart's),its `exp` (expiry as an INTEGER ofis Unix seconds — not an ISO 8601 date string), `sub` (the identity you authenticate as — it is compared against it) and `aud` (the store slugis this mandate isstore's for,slug). e.g.Forward theit slugas inreceived; thea URLmandate you arewrite callingyourself —is not a domain). It isaccepted ahere. spendingThe capapproval youis declarebound to limit yourself: ityour authorisesagent nothingcredential and does not proveverify thethat buyer'sa consent.person was present. Use this when your client cannot set an ⟨6 unchanged words⟩ 

 ⟨83 unchanged words⟩ ":"object"},"cel_context":{"additionalProperties":true,"description":"Optional enforcement context for Trusteed native MCP flows (no Shopify/WooCommerce/PrestaShop/Magento plugin). Providing these fields enables full evaluation of rules R004, R006, R008, R012-R013, R015-R017, R026-R028. See each field's own description for what it means and whether the server verifies it. These values are not signed into the receipt — do not include values you cannot substantiate.","properties":{"agent_provider_id":{"description":"Your provider identifier (e.g. \"openai\", \"anthropic\"), lowercase — send only if it applies to you.","maxLength":64,"minLength":1,"pattern":"^[a-z0-9_\\-]+$","type":"string"},"autorenew_consent":{"description":"True if the buyer explicitly consented to auto-renewal for a subscription — send only if it applies to you.","type":"boolean"},"completed_orders_24h":{"description":"Orders this agent has completed with this merchant in the last 24 hours. Merchant/platform fact — send only with evidence; itOptional. canSend only make a check stricter, never looser.","maximum":1000000,"minimum":0,"type":"integer"},"cross_merchant_abuse":{"description":"True ifevidence you have flagged this same buyer/agent for abuse at another merchant. Merchant/platform fact — send only withcan evidence;substantiate; it can only make a check stricter, never looser.","type":"boolean"},"digital_good_types":{"description":"Digital-good categories present in this cart — send only if it applies to you.","items":{"enum":["gift_card","license_key","downloadable","stored_value"],"type":"string"},"maxItems":10,"type":"array"},"discount_bps":{"description":"Discount applied to this cart, in basis points — send only if it applies to you.","maximum":10000,"minimum":0,"type":"integer"},"discount_codes_tried":{"description":"Number of discount codes you attempted before this checkout — send only if it applies to you.","maximum":100,"minimum":0,"type":"integer"},"dispute_count":{"description":"Number of payment disputes this agent has had with thisUnknown merchant.keys Merchant/platformor factout-of-range —values sendare onlyrejected with evidence; it can only make a check stricter, neverINVALID_ARGUMENT. looser.","maximum":1000000,"minimum":0,"type":"integer"},"is_b2b":{"description"Keys:"True if you are buying on behalf of a business — send only if it applies to you.","type":"boolean"}key_age_hours,"is_subscription":{"description":"True if this checkout creates a recurring subscription. The server checks this itself; a value you send cannot hide what it detects.","type":"boolean"}requested_scopes,"key_age_hours":{"description":"Age in hours of the API key/credential you are using with this store. Merchant/platform fact — send only with evidence; it can only make a check stricterproduct_categories, never looser.","maximum":720,"minimum":0,"type":"integer"}price_delta_bps,"lowest_stock":{"description":"Lowest remaining stock you observed across this cart's line items. Merchant/platform fact — send only with evidence; it can only make a check stricterdiscount_codes_tried, never looser.","minimum":0,"type":"integer"}discount_bps,"merchant_orders_1h":{"description":"Orders this merchant has received from any agent in the last hour. Merchant/platform fact — send only with evidence; it can only make a check stricterlowest_stock, never looser.","maximum":1000000,"minimum":0,"type":"integer"},"price_delta_bps":{"description":"Differencereturn_policy_mismatch, in basis pointsis_subscription, between the price you discovered earlier and the cart's current price. The server may recompute this from the catalogue and replace your value.","maximum":10000,"minimum":-10000,"type":"integer"}autorenew_consent,"product_categories":{"description":"Product categories present in this cartis_b2b, as you understand them — send only if it applies to you.","items":{"maxLength":64,"type":"string"},"maxItems":50,"type":"array"}purchase_order_hash,"provider_confidence":{"description":"Your confidence (0-1) in your own agent-provider identification — send only if it applies to you.","maximum":1,"minimum":0,"type":"number"}shipping_po_box,"purchase_order_hash":{"description":"Hash of a purchase order backing a B2B purchase — send only if it applies to you.","maxLength":128,"type":"string"}shipping_freight_forwarder,"refund_ratio":{"description":"This agent's refund ratio with this merchant (0-1). Merchant/platform fact — send only with evidence; it can only make a check stricterprovider_confidence, never looser.","maximum":1,"minimum":0,"type":"number"}stored_value_cents,"requested_scopes":{"description":"OAuth/permission scopes you requested when authenticating with this store — send only if it applies to you.","items":{"maxLength":64,"type":"string"},"maxItems":20,"type":"array"}cross_merchant_abuse,"return_policy_mismatch":{"description":"True if the return policy you were shown does not match what this store publishes elsewhere. Merchant/platform fact — send only with evidence; it can only make a check stricterrefund_ratio, never looser.","type":"boolean"}dispute_count,"shipping_freight_forwarder":{"description":"True if the shipping address is a freight-forwarder address — send only if it applies to you.","type":"boolean"}completed_orders_24h,"shipping_po_box":{"description":"True if the shipping address is a PO box. The server checks this itself; a value you send cannot hide what it detects.","type":"boolean"}merchant_orders_1h,"stored_value_cents":{"description":"Stored-value amount (e.g. gift card) applied to this cartdigital_good_types, in cents. The server checks this itself; a value you send cannot hide what it detects.","maximum":100000000,"minimum":0,"type":"integeragent_provider_id."}},"type":"object"},"checkout_session_id":{" ⟨712 unchanged words⟩ 

 ⟨170 unchanged words⟩ a tool name: provide_shipping_destination, refresh_shipping_rates, choose_shipping_option, ask_user_payment_method.preview_ucp_checkout, review_not_available_in_ucp.","type":"string"},"next_step_message":{ ⟨68 unchanged words⟩ 

 ⟨170 unchanged words⟩ a tool name: provide_shipping_destination, refresh_shipping_rates, choose_shipping_option, ask_user_payment_method.preview_ucp_checkout, review_not_available_in_ucp.","type":"string"},"next_step_message":{ ⟨68 unchanged words⟩ 

 ⟨170 unchanged words⟩ a tool name: provide_shipping_destination, refresh_shipping_rates, choose_shipping_option, ask_user_payment_method.preview_ucp_checkout, review_not_available_in_ucp.","type":"string"},"next_step_message":{ ⟨68 unchanged words⟩ 

 ⟨5 unchanged words⟩  before payment. Advances the session to ready-for-payment state. If you only need the price, call quote_checkout instead: it computes the same total without advancing the session or opening an approval.

PREFER THE CART CARD: if there is  ⟨95 unchanged words⟩ 

Full-text search across all Trusteed public documentation: pages, blog posts, FAQ entries, error codes, the agent checkout guide, and FAQthe entries.tools of this endpoint. Returns ranked results by relevance. Use this to ⟨11 unchanged words⟩ 

 ⟨43 unchanged words⟩ "Filter results by type: page, blog, faq, error (error codes), guide (checkout guide sections) or faq.tool (tools served by this endpoint). Omit to search all types.","enum":["page","blog","faq","error","guide","tool"],"type":"string"}},"required" ⟨3 unchanged words⟩ 

 ⟨30 unchanged words⟩ "enum":["page","blog","faq","error","guide","tool"],"type":"string"}},"required": ⟨19 unchanged words⟩ 

 ⟨31 unchanged words⟩ string"},"idempotency_key":{"description":"REQUIRED asfor anthis argumentwrite inunless thissent tool:as the `Idempotency-Key` header or `_meta` alone is not enough.`params._meta[\"trusteed/idempotency-key\"]`. 1-128 chars from [A-Za-z0-9._:/-]. Reuse  ⟨27 unchanged words⟩ string"}},"required":["cart_id","shipping_handle","idempotency_key"],"type":"object"}

 ⟨244 unchanged words⟩  REST API, not payment in this tool. On demo-store the approval step records a confirmation but does not verify that a human gave it. PAYMENT MANDATE: this tool also requires one. Send ⟨215 unchanged words⟩ 

 ⟨844 unchanged words⟩ :"string"},"idempotency_key":{"description":"Unique keyREQUIRED toas preventan duplicateargument chargesin onthis retry.tool: Generatethe once`Idempotency-Key` perheader purchaseor attempt.`_meta` Replayalone is enforced primarily on checkout_session_idnot (theenough. existing1-128 orderchars isfrom returned)[A-Za-z0-9._:/-]. The first key seen for a session is recorded; reusingReuse the same keyvalue short-circuitswhen toretrying the existingsame order.operation.","maxLength":128,"pattern":"^[A-Za-z0-9._:/-]{1,128}$","type":"string"},"kyapay_token":{ ⟨647 unchanged words⟩ 

 ⟨131 unchanged words⟩ :"string"},"idempotency_key":{"description":"Idempotency keyREQUIRED for this cart creation (UUID-v4 or bounded ASCII token, 1-128write chars).unless Equivalentsent toas the `Idempotency-Key` header — send it here if youror client`params._meta[\"trusteed/idempotency-key\"]`. cannot1-128 setchars headers.from Retrying[A-Za-z0-9._:/-]. withReuse the same keyvalue returnswhen retrying the same cart instead of creating a second one.operation.","maxLength":128,"pattern":"^[A-Za-z0-9._:/-]{1,128}$","type":"string"},"items":{ ⟨66 unchanged words⟩ 

 ⟨94 unchanged words⟩ "description":"Province or state code (optional): the subdivision part only, without the country prefix and not the full ISO 3166-2 code (e.g. \"CA\" for California, \"ON\" for Ontario, \"B\" for Barcelona; never \"US-CA\" or \"ES-B\"). Only the Shopify checkout prefill reads it.","type":"string"},"zip":{ ⟨27 unchanged words⟩ 

 ⟨76 unchanged words⟩ that made the purchase can read its receipt. A receipt attests that the call happened, not that money moved: read `settlement` (it is `not_attested` unless the payment rail confirmed it). PREFER THE CART CARD: if the purchase was ⟨65 unchanged words⟩ 

 ⟨31 unchanged words⟩ :"string"},"idempotency_key":{"description":"Required.REQUIRED Reuseas thisan keyargument onlyin whenthis retryingtool: the same`Idempotency-Key` cartheader andor shipping`_meta` option;alone useis anot newenough. key1-128 ifchars eitherfrom changes.[A-Za-z0-9._:/-]. Reuse the same value when retrying the same operation.","maxLength":128,"minLength":1,"pattern":"^[A-Za-z0-9._:/-]{1,128 ⟨18 unchanged words⟩ 

 ⟨34 unchanged words⟩ :"string"},"idempotency_key":{"description":"OptionalREQUIRED idempotencyfor keythis towrite preventunless duplicatesent cancellations.as the `Idempotency-Key` header or `params._meta[\"trusteed/idempotency-key\"]`. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same operation.","maxLength":128,"pattern":"^[A-Za-z0-9._:/-]{1,128}$","type":"string"},"reason":{ ⟨10 unchanged words⟩ 

 ⟨163 unchanged words⟩ ,"type":"object"},"next_step":{"description":"Next-action code, not a tool name: provide_shipping_destination, refresh_shipping_rates, choose_shipping_option, ask_user_payment_method.","type":"string"},"next_step_message":{"type" ⟨67 unchanged words⟩ 

 ⟨121 unchanged words⟩ :"string"},"idempotency_key":{"description":"UniqueREQUIRED keyas toan preventargument duplicatein completions.this Generatetool: oncethe per`Idempotency-Key` attempt.header or `_meta` alone is not enough. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same operation.","maxLength":128,"pattern":"^[A-Za-z0-9._:/-]{1,128}$","type":"string"},"meta":{ ⟨439 unchanged words⟩ 

 ⟨163 unchanged words⟩ ,"type":"object"},"next_step":{"description":"Next-action code, not a tool name: provide_shipping_destination, refresh_shipping_rates, choose_shipping_option, ask_user_payment_method.","type":"string"},"next_step_message":{"type" ⟨67 unchanged words⟩ 

 ⟨38 unchanged words⟩ :"string"},"idempotency_key":{"description":"Required by the checkoutREQUIRED bucketfor (UUID-v4this orwrite boundedunless ASCIIsent token).as Choosethe one`Idempotency-Key` perheader purchaseor attempt`params._meta[\"trusteed/idempotency-key\"]`. and1-128 reusechars itfrom to[A-Za-z0-9._:/-]. retryReuse safely.the Alternativelysame sendvalue itwhen asretrying the Idempotency-Key header orsame params._meta[\operation."trusteed/idempotency-key\,"maxLength":128,"pattern":"^[A-Za-z0-9._:/-].{1,128}$","type":"string"},"intent":{ ⟨212 unchanged words⟩ 

 ⟨163 unchanged words⟩ ,"type":"object"},"next_step":{"description":"Next-action code, not a tool name: provide_shipping_destination, refresh_shipping_rates, choose_shipping_option, ask_user_payment_method.","type":"string"},"next_step_message":{"type" ⟨67 unchanged words⟩ 

 ⟨163 unchanged words⟩ ,"type":"object"},"next_step":{"description":"Next-action code, not a tool name: provide_shipping_destination, refresh_shipping_rates, choose_shipping_option, ask_user_payment_method.","type":"string"},"next_step_message":{"type" ⟨67 unchanged words⟩ 

 ⟨159 unchanged words⟩ "string"}},"type":"object"},"idempotency_key":{"description":"REQUIRED for this write unless sent as the `Idempotency-Key` header or `params._meta[\"trusteed/idempotency-key\"]`. 1-128 chars from [A-Za-z0-9._:/-]. Reuse the same value when retrying the same operation.","maxLength":128,"pattern":"^[A-Za-z0-9._:/-]{1,128}$","type":"string"},"line_items":{"description":"Replacement line items ( ⟨162 unchanged words⟩ 

 ⟨163 unchanged words⟩ ,"type":"object"},"next_step":{"description":"Next-action code, not a tool name: provide_shipping_destination, refresh_shipping_rates, choose_shipping_option, ask_user_payment_method.","type":"string"},"next_step_message":{"type" ⟨67 unchanged words⟩ 

 ⟨59 unchanged words⟩ the receipt is on its way; `checkout_in_progress` means itthe hascomplete_checkout notcall settledis yet.still running. Only the credential that made the purchase can ⟨76 unchanged words⟩ 

Create a shopping cart in Demo Store. Returns a cart_id (thecart_id. samePass valueit as checkout_session_idcart_id into preview_checkoutget_shipping_rates, select_shipping_option, apply_discount and preview_checkout; complete_checkout and get_trust_receipt) for usetake withthe get_shipping_rates,same preview_checkout,value andas complete_checkout.checkout_session_id.

KYA IDENTITY: a Skyfire kya token has  ⟨27 unchanged words⟩  Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).//guides/checkout. CREDENTIAL: this store needs one. Call the  ⟨53 unchanged words⟩ 

 ⟨123 unchanged words⟩  Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).//guides/checkout. CREDENTIAL: this store needs one. Call the  ⟨53 unchanged words⟩ 

 ⟨148 unchanged words⟩  Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).//guides/checkout.

 ⟨47 unchanged words⟩  Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).//guides/checkout. CREDENTIAL: this store needs one. Call the  ⟨53 unchanged words⟩ 

 ⟨35 unchanged words⟩ ,"payment_mandate":{"anyOf":[{"additionalProperties":true,"properties":{"aud":{"description":"This store's slug (the one in the URL you are calling) — not a domain.","maxLength":256,"minLength":1,"type":"string"},"currency":{"description":"Three-letter currency code; must match the cart's currency.","maxLength":3,"minLength":3,"type":"string"},"exp":{"description":"Expiry as an INTEGER of Unix seconds, in the future — not an ISO 8601 date string.","exclusiveMinimum":0,"type":"integer"},"mandate_id":{"description":"Your identifier for this mandate.","maxLength":128,"minLength":1,"type":"string"},"max_amount_cents":{"description":"Spending limit the buyer gave you, as an integer in minor units (cents).","exclusiveMinimum":0,"type":"integer"},"sub":{"description":"The identity you authenticate as — it is compared against it. When the credential tool returns a `mandate_subject`, use that value.","maxLength":256,"minLength":1,"type":"string"}},"required":["mandate_id","max_amount_cents","currency","exp","sub","aud"],"type":"object"},{"type":" ⟨101 unchanged words⟩ 

 ⟨74 unchanged words⟩  Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).//guides/checkout. CREDENTIAL: this store needs one. Call the  ⟨53 unchanged words⟩ 

 ⟨39 unchanged words⟩  Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).//guides/checkout.

 ⟨72 unchanged words⟩ ":"integer"},"extensions":{"additionalProperties":true,"properties":{"warnings":{"items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"disclosure_url":{"type":"string"},"message":{"type":"string"},"severity":{"enum":["info","caution","critical"],"typedescription":"string"}},"required":`warnings["code","message","severity"]` with `code`,"type":"object"} `message`,"type":"array `severity`."}},"type":"object"},"fulfillment":{"additionalProperties":true,"properties":{"destination":{"additionalProperties":true,"properties":{"city":{"type":"string"},"country_code":{"type":"string"},"province_code":{"type":"string"},"zip":{"type":"string"}},"required":["city","country_code","zip"],"type":"object"},"options":{"items":{"additionalProperties":true,"properties":{"authoritative":{"type":"boolean"},"estimated_delivery":{"type":"string"},"id":{"type":"string"},"price":{"additionalProperties":true,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"],"type":"object"},"source":{"enum":["platform","merchant_policy","estimated"],"type":"string"},"title":{"type":"string"}},"required":["id","title","price","source","authoritative"],"type":"object"},"type":"array"},"selected_option_id":{"type":"string"}},"type":"object"},"id":{"type":"string"},"idempotency_key":{"type":"string"},"intent":{"additionalProperties":true,"properties":{"action":{"type":"string"},"context":{"type":"string"},"locale":{"type":"string"}},"required":["action"],"type":"object"},"label":{"type":"string" ⟨47 unchanged words⟩ ":"array"},"next_action":{"additionalProperties":true,"properties":{"actor":{"const":"buyer","type":"string"},"do":{"enumdescription":["Only when a person must approve"," or pay"],"type":"string"},"instruction":{"type":"string"},"reuse_arguments":{"items":{"enum":["checkout_session_id","checkout_id","idempotency_key"],"type":"string"},"type":"array"},"then_call":{"maxLength":64,"minLength":1,"type":"string"},"url":{"type":"string"}},"required":["actor","do" `url`,"url" `kind`,"instruction `retry`."],"type":"object"},"next_step":{"const":"ask_user_payment_method","type":"string"},"next_step_message":{"type":"string"},"payment_options":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"charges_without_approval":{"const":true,"type":"boolean"},"funding_source":{"anyOf":[{"enum":["platform_test_card","platform_test_wallet","buyer_wallet"],"type":"string"},{"type":"null"}]},"id":{"enum":["demo_card","demo_wallet","own_wallet","merchant_card","paypal","kyapay"],"typedescription":"string"}When present,"label":{"type":"string ask the person which option they want; never choose for them."},"railitems":{"enum":["stripe","x402","kyapay","paypal"],"type":"string"},"reason_unavailableadditionalProperties":{"enum":["coming_soon","not_enabled","currency_not_supported","unsupported_on_this_tool"],"type":"string"}},"required":["id","label","rail","funding_source","available"],"type":"object"},"type":"array ⟨45 unchanged words⟩ 

 ⟨199 unchanged words⟩  you: ask them if they gave none. Schema: https://trusteed.xyz/.well-known/payment-mandate.schema.json. Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).//guides/checkout.

 ⟨226 unchanged words⟩ ,"payment_mandate":{"anyOf":[{"additionalProperties":true,"properties":{"aud":{"description":"This store's slug (the one in the URL you are calling) — not a domain.","maxLength":256,"minLength":1,"type":"string"},"currency":{"description":"Three-letter currency code; must match the cart's currency.","maxLength":3,"minLength":3,"type":"string"},"exp":{"description":"Expiry as an INTEGER of Unix seconds, in the future — not an ISO 8601 date string.","exclusiveMinimum":0,"type":"integer"},"mandate_id":{"description":"Your identifier for this mandate.","maxLength":128,"minLength":1,"type":"string"},"max_amount_cents":{"description":"Spending limit the buyer gave you, as an integer in minor units (cents).","exclusiveMinimum":0,"type":"integer"},"sub":{"description":"The identity you authenticate as — it is compared against it. When the credential tool returns a `mandate_subject`, use that value.","maxLength":256,"minLength":1,"type":"string"}},"required":["mandate_id","max_amount_cents","currency","exp","sub","aud"],"type":"object"},{"type":" ⟨211 unchanged words⟩ 

 ⟨72 unchanged words⟩ ":"integer"},"extensions":{"additionalProperties":true,"properties":{"warnings":{"items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"disclosure_url":{"type":"string"},"message":{"type":"string"},"severity":{"enum":["info","caution","critical"],"typedescription":"string"}},"required":`warnings["code","message","severity"]` with `code`,"type":"object"} `message`,"type":"array `severity`."}},"type":"object"},"fulfillment":{"additionalProperties":true,"properties":{"destination":{"additionalProperties":true,"properties":{"city":{"type":"string"},"country_code":{"type":"string"},"province_code":{"type":"string"},"zip":{"type":"string"}},"required":["city","country_code","zip"],"type":"object"},"options":{"items":{"additionalProperties":true,"properties":{"authoritative":{"type":"boolean"},"estimated_delivery":{"type":"string"},"id":{"type":"string"},"price":{"additionalProperties":true,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"],"type":"object"},"source":{"enum":["platform","merchant_policy","estimated"],"type":"string"},"title":{"type":"string"}},"required":["id","title","price","source","authoritative"],"type":"object"},"type":"array"},"selected_option_id":{"type":"string"}},"type":"object"},"id":{"type":"string"},"

 ⟨43 unchanged words⟩  Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).//guides/checkout.

 ⟨72 unchanged words⟩ ":"integer"},"extensions":{"additionalProperties":true,"properties":{"warnings":{"items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"disclosure_url":{"type":"string"},"message":{"type":"string"},"severity":{"enum":["info","caution","critical"],"typedescription":"string"}},"required":`warnings["code","message","severity"]` with `code`,"type":"object"} `message`,"type":"array `severity`."}},"type":"object"},"fulfillment":{"additionalProperties":true,"properties":{"destination":{"additionalProperties":true,"properties":{"city":{"type":"string"},"country_code":{"type":"string"},"province_code":{"type":"string"},"zip":{"type":"string"}},"required":["city","country_code","zip"],"type":"object"},"options":{"items":{"additionalProperties":true,"properties":{"authoritative":{"type":"boolean"},"estimated_delivery":{"type":"string"},"id":{"type":"string"},"price":{"additionalProperties":true,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"],"type":"object"},"source":{"enum":["platform","merchant_policy","estimated"],"type":"string"},"title":{"type":"string"}},"required":["id","title","price","source","authoritative"],"type":"object"},"type":"array"},"selected_option_id":{"type":"string"}},"type":"object"},"id":{"type":"string"},"idempotency_key":{"type":"string"},"intent":{"additionalProperties":true,"properties":{"action":{"type":"string"},"context":{"type":"string"},"locale":{"type":"string"}},"required":["action"],"type":"object"},"label":{"type":"string" ⟨47 unchanged words⟩ ":"array"},"next_action":{"additionalProperties":true,"properties":{"actor":{"const":"buyer","type":"string"},"do":{"enumdescription":["Only when a person must approve"," or pay"],"type":"string"},"instruction":{"type":"string"},"reuse_arguments":{"items":{"enum":["checkout_session_id","checkout_id","idempotency_key"],"type":"string"},"type":"array"},"then_call":{"maxLength":64,"minLength":1,"type":"string"},"url":{"type":"string"}},"required":["actor","do" `url`,"url" `kind`,"instruction `retry`."],"type":"object"},"next_step":{"const":"ask_user_payment_method","type":"string"},"next_step_message":{"type":"string"},"payment_options":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"charges_without_approval":{"const":true,"type":"boolean"},"funding_source":{"anyOf":[{"enum":["platform_test_card","platform_test_wallet","buyer_wallet"],"type":"string"},{"type":"null"}]},"id":{"enum":["demo_card","demo_wallet","own_wallet","merchant_card","paypal","kyapay"],"typedescription":"string"}When present,"label":{"type":"string ask the person which option they want; never choose for them."},"railitems":{"enum":["stripe","x402","kyapay","paypal"],"type":"string"},"reason_unavailableadditionalProperties":{"enum":["coming_soon","not_enabled","currency_not_supported","unsupported_on_this_tool"],"type":"string"}},"required":["id","label","rail","funding_source","available"],"type":"object"},"type":"array ⟨45 unchanged words⟩ 

 ⟨39 unchanged words⟩  Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).//guides/checkout.

 ⟨72 unchanged words⟩ ":"integer"},"extensions":{"additionalProperties":true,"properties":{"warnings":{"items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"disclosure_url":{"type":"string"},"message":{"type":"string"},"severity":{"enum":["info","caution","critical"],"typedescription":"string"}},"required":`warnings["code","message","severity"]` with `code`,"type":"object"} `message`,"type":"array `severity`."}},"type":"object"},"fulfillment":{"additionalProperties":true,"properties":{"destination":{"additionalProperties":true,"properties":{"city":{"type":"string"},"country_code":{"type":"string"},"province_code":{"type":"string"},"zip":{"type":"string"}},"required":["city","country_code","zip"],"type":"object"},"options":{"items":{"additionalProperties":true,"properties":{"authoritative":{"type":"boolean"},"estimated_delivery":{"type":"string"},"id":{"type":"string"},"price":{"additionalProperties":true,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"],"type":"object"},"source":{"enum":["platform","merchant_policy","estimated"],"type":"string"},"title":{"type":"string"}},"required":["id","title","price","source","authoritative"],"type":"object"},"type":"array"},"selected_option_id":{"type":"string"}},"type":"object"},"id":{"type":"string"},"idempotency_key":{"type":"string"},"intent":{"additionalProperties":true,"properties":{"action":{"type":"string"},"context":{"type":"string"},"locale":{"type":"string"}},"required":["action"],"type":"object"},"label":{"type":"string" ⟨47 unchanged words⟩ ":"array"},"next_action":{"additionalProperties":true,"properties":{"actor":{"const":"buyer","type":"string"},"do":{"enumdescription":["Only when a person must approve"," or pay"],"type":"string"},"instruction":{"type":"string"},"reuse_arguments":{"items":{"enum":["checkout_session_id","checkout_id","idempotency_key"],"type":"string"},"type":"array"},"then_call":{"maxLength":64,"minLength":1,"type":"string"},"url":{"type":"string"}},"required":["actor","do" `url`,"url" `kind`,"instruction `retry`."],"type":"object"},"next_step":{"const":"ask_user_payment_method","type":"string"},"next_step_message":{"type":"string"},"payment_options":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"charges_without_approval":{"const":true,"type":"boolean"},"funding_source":{"anyOf":[{"enum":["platform_test_card","platform_test_wallet","buyer_wallet"],"type":"string"},{"type":"null"}]},"id":{"enum":["demo_card","demo_wallet","own_wallet","merchant_card","paypal","kyapay"],"typedescription":"string"}When present,"label":{"type":"string ask the person which option they want; never choose for them."},"railitems":{"enum":["stripe","x402","kyapay","paypal"],"type":"string"},"reason_unavailableadditionalProperties":{"enum":["coming_soon","not_enabled","currency_not_supported","unsupported_on_this_tool"],"type":"string"}},"required":["id","label","rail","funding_source","available"],"type":"object"},"type":"array ⟨45 unchanged words⟩ 

 ⟨62 unchanged words⟩  Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).//guides/checkout.

 ⟨72 unchanged words⟩ ":"integer"},"extensions":{"additionalProperties":true,"properties":{"warnings":{"items":{"additionalProperties":true,"properties":{"code":{"type":"string"},"disclosure_url":{"type":"string"},"message":{"type":"string"},"severity":{"enum":["info","caution","critical"],"typedescription":"string"}},"required":`warnings["code","message","severity"]` with `code`,"type":"object"} `message`,"type":"array `severity`."}},"type":"object"},"fulfillment":{"additionalProperties":true,"properties":{"destination":{"additionalProperties":true,"properties":{"city":{"type":"string"},"country_code":{"type":"string"},"province_code":{"type":"string"},"zip":{"type":"string"}},"required":["city","country_code","zip"],"type":"object"},"options":{"items":{"additionalProperties":true,"properties":{"authoritative":{"type":"boolean"},"estimated_delivery":{"type":"string"},"id":{"type":"string"},"price":{"additionalProperties":true,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"],"type":"object"},"source":{"enum":["platform","merchant_policy","estimated"],"type":"string"},"title":{"type":"string"}},"required":["id","title","price","source","authoritative"],"type":"object"},"type":"array"},"selected_option_id":{"type":"string"}},"type":"object"},"id":{"type":"string"},"idempotency_key":{"type":"string"},"intent":{"additionalProperties":true,"properties":{"action":{"type":"string"},"context":{"type":"string"},"locale":{"type":"string"}},"required":["action"],"type":"object"},"label":{"type":"string" ⟨47 unchanged words⟩ ":"array"},"next_action":{"additionalProperties":true,"properties":{"actor":{"const":"buyer","type":"string"},"do":{"enumdescription":["Only when a person must approve"," or pay"],"type":"string"},"instruction":{"type":"string"},"reuse_arguments":{"items":{"enum":["checkout_session_id","checkout_id","idempotency_key"],"type":"string"},"type":"array"},"then_call":{"maxLength":64,"minLength":1,"type":"string"},"url":{"type":"string"}},"required":["actor","do" `url`,"url" `kind`,"instruction `retry`."],"type":"object"},"next_step":{"const":"ask_user_payment_method","type":"string"},"next_step_message":{"type":"string"},"payment_options":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"charges_without_approval":{"const":true,"type":"boolean"},"funding_source":{"anyOf":[{"enum":["platform_test_card","platform_test_wallet","buyer_wallet"],"type":"string"},{"type":"null"}]},"id":{"enum":["demo_card","demo_wallet","own_wallet","merchant_card","paypal","kyapay"],"typedescription":"string"}When present,"label":{"type":"string ask the person which option they want; never choose for them."},"railitems":{"enum":["stripe","x402","kyapay","paypal"],"type":"string"},"reason_unavailableadditionalProperties":{"enum":["coming_soon","not_enabled","currency_not_supported","unsupported_on_this_tool"],"type":"string"}},"required":["id","label","rail","funding_source","available"],"type":"object"},"type":"array ⟨45 unchanged words⟩ 

 ⟨56 unchanged words⟩  not to the MCP tools. Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json.//trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs). CREDENTIAL: this store needs one. Call the  ⟨53 unchanged words⟩ 

 ⟨118 unchanged words⟩  to handle it in chat. Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json.//trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs). CREDENTIAL: this store needs one. Call the  ⟨53 unchanged words⟩ 

 ⟨143 unchanged words⟩  later in a new turn. Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json.//trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).

 ⟨42 unchanged words⟩  the flow in one card. Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json.//trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs). CREDENTIAL: this store needs one. Call the  ⟨53 unchanged words⟩ 

 ⟨69 unchanged words⟩  a new one per step. Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json.//trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs). CREDENTIAL: this store needs one. Call the  ⟨53 unchanged words⟩ 

 ⟨6 unchanged words⟩ to 'canceled' status. Cannot cancel already completed checkouts. Use ONLY for a checkout session created with ucp_create_checkout (Universal Commerce Protocol); for the standard flow (create_cart, preview_checkout, complete_checkout) do not call this tool. Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json.//trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).

 ⟨10 unchanged words⟩ — safe to retry with the same idempotency_key. Use ONLY for a checkout session created with ucp_create_checkout (Universal Commerce Protocol); for the standard flow (create_cart, preview_checkout, complete_checkout) do not call this tool. For a cart built with create_cart use complete_checkout. PAYMENT MANDATE: this tool also requires one. Send ⟨145 unchanged words⟩ gave none. Schema: https://trusteed.xyz/.well-known/payment-mandate.schema.json. Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json.//trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).

Create a UCP (Universal Commerce Protocol) checkout session from line items. Returns a UCP checkout object with status 'incomplete'. Starts the UCP flow (ucp_* tools); for the standard flow use create_cart instead. Do not mix the two flows on the same purchase. Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json.//trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).

 ⟨6 unchanged words⟩ ID. Returns the current state of the checkout. Use ONLY for a checkout session created with ucp_create_checkout (Universal Commerce Protocol); for the standard flow (create_cart, preview_checkout, complete_checkout) do not call this tool. Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json.//trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).

 ⟨39 unchanged words⟩ totals). Only allowed when status is 'incomplete'. Use ONLY for sessions created with ucp_create_checkout; for the standard flow use create_cart and select_shipping_option. Checkout guide: read the MCP resource trusteed://guides/checkout (or https://trusteed.xyz/.well-known/agent-checkout-guide.json.//trusteed.xyz/.well-known/agent-checkout-guide.json if you can fetch URLs).

 ⟨94 unchanged words⟩ {"available":{"type":"boolean"},"charges_without_approval":{"const":true,"type":"boolean"},"funding_source":{"anyOf":[{"enum":[" ⟨108 unchanged words⟩ 

 ⟨320 unchanged words⟩ {"available":{"type":"boolean"},"charges_without_approval":{"const":true,"type":"boolean"},"funding_source":{"anyOf":[{"enum":[" ⟨91 unchanged words⟩ 

 ⟨320 unchanged words⟩ {"available":{"type":"boolean"},"charges_without_approval":{"const":true,"type":"boolean"},"funding_source":{"anyOf":[{"enum":[" ⟨91 unchanged words⟩ 

 ⟨320 unchanged words⟩ {"available":{"type":"boolean"},"charges_without_approval":{"const":true,"type":"boolean"},"funding_source":{"anyOf":[{"enum":[" ⟨91 unchanged words⟩ 

 ⟨320 unchanged words⟩ {"available":{"type":"boolean"},"charges_without_approval":{"const":true,"type":"boolean"},"funding_source":{"anyOf":[{"enum":[" ⟨91 unchanged words⟩ 

 ⟨320 unchanged words⟩ {"available":{"type":"boolean"},"charges_without_approval":{"const":true,"type":"boolean"},"funding_source":{"anyOf":[{"enum":[" ⟨91 unchanged words⟩ 

 ⟨335 unchanged words⟩ demo_card","demo_wallet","own_wallet","merchant_card","paypal","kyapay"],"type":"string"},"label" ⟨3 unchanged words⟩ "enum":["stripe","x402","kyapay","paypal"],"type":"string"},"reason_unavailable":{"enum":["coming_soon","not_enabled","currency_not_supported","unsupported_on_this_tool"],"type":"string"}},"required" ⟨54 unchanged words⟩ 

 ⟨368 unchanged words⟩ ["demo_card","demo_wallet","own_wallet","merchant_card","paypal"],"type":"string"},"shared_payment_token":{ ⟨67 unchanged words⟩ 

 ⟨335 unchanged words⟩ demo_card","demo_wallet","own_wallet","merchant_card","paypal","kyapay"],"type":"string"},"label" ⟨3 unchanged words⟩ "enum":["stripe","x402","kyapay","paypal"],"type":"string"},"reason_unavailable":{"enum":["coming_soon","not_enabled","currency_not_supported","unsupported_on_this_tool"],"type":"string"}},"required" ⟨54 unchanged words⟩ 

 ⟨335 unchanged words⟩ demo_card","demo_wallet","own_wallet","merchant_card","paypal","kyapay"],"type":"string"},"label" ⟨3 unchanged words⟩ "enum":["stripe","x402","kyapay","paypal"],"type":"string"},"reason_unavailable":{"enum":["coming_soon","not_enabled","currency_not_supported","unsupported_on_this_tool"],"type":"string"}},"required" ⟨54 unchanged words⟩ 

 ⟨335 unchanged words⟩ demo_card","demo_wallet","own_wallet","merchant_card","paypal","kyapay"],"type":"string"},"label" ⟨3 unchanged words⟩ "enum":["stripe","x402","kyapay","paypal"],"type":"string"},"reason_unavailable":{"enum":["coming_soon","not_enabled","currency_not_supported","unsupported_on_this_tool"],"type":"string"}},"required" ⟨54 unchanged words⟩ 

 ⟨335 unchanged words⟩ demo_card","demo_wallet","own_wallet","merchant_card","paypal","kyapay"],"type":"string"},"label" ⟨3 unchanged words⟩ "enum":["stripe","x402","kyapay","paypal"],"type":"string"},"reason_unavailable":{"enum":["coming_soon","not_enabled","currency_not_supported","unsupported_on_this_tool"],"type":"string"}},"required" ⟨54 unchanged words⟩ 

 ⟨20 unchanged words⟩ for use with get_shipping_rates, preview_checkout, and complete_checkout.

SKYFIRE TOKENKYA (optional)IDENTITY: Provide a kya or kya-pay Skyfire kya token inhas theno skyfire-pay-ideffect requeston headerthis totool boost(it yourgrants agentno trust score (up toboost +0.35here), which may unlock better pricing or priority service. No token; requiredKYA —identity requestapplies proceedsto withthe neutralREST trustagent scoreAPI (0.50`Authorization: Bearer`), ifnot omittedto orthe invalid.MCP tools. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json. CREDENTIAL: this store ⟨57 unchanged words⟩ 

 ⟨115 unchanged words⟩  explicitly asks you to handle it in chat.

SKYFIRE TOKEN (optional): Pass a kya or kya-pay token in the skyfire-pay-id header to boost trust score. No token required — request proceeds normally if omitted. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json. CREDENTIAL: this store ⟨57 unchanged words⟩ 

 ⟨39 unchanged words⟩  — it keeps the flow in one card.

SKYFIRE TOKEN (optional): Pass a kya or kya-pay token in the skyfire-pay-id header to boost trust score. No token required — request proceeds normally if omitted. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json. CREDENTIAL: this store ⟨57 unchanged words⟩ 

 ⟨66 unchanged words⟩  instead of opening a new one per step.

SKYFIRE TOKEN (optional): Pass a kya or kya-pay token in the skyfire-pay-id header to boost trust score. No token required — request proceeds normally if omitted. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json. CREDENTIAL: this store ⟨57 unchanged words⟩ 

 ⟨254 unchanged words⟩ },"minItems":1,"type":"array"},"meta":{"description":"UCP request metadata. meta['ucp-agent'].profile = URL of the platform profile; it must be an https URL without credentials (at most 2048 characters)."}},"required":["currency","line_items"],"type":"object"}

 ⟨31 unchanged words⟩  (valid UUID)","type":"string"},"meta":{"description":"UCP request metadata. meta['ucp-agent'].profile = URL of the platform profile; it must be an https URL without credentials (at most 2048 characters)."}},"required":["checkout_id"],"type":"object"}

 ⟨294 unchanged words⟩ },"minItems":1,"type":"array"},"meta":{"description":"UCP request metadata. meta['ucp-agent'].profile = URL of the platform profile; it must be an https URL without credentials (at most 2048 characters)."}},"required":["checkout_id"],"type":"object"}

 ⟨85 unchanged words⟩ "type":["string","null"]},"recommended_action":{"anyOf":[{"additionalProperties":true,"properties":{"action":{"enum":["proceed","proceed_with_human_confirmation","do_not_proceed"],"type":"string"},"derived_from":{"items":{"type":"string"},"type":"array"},"reason_code":{"enum":["below_eligibility_threshold","limited_history","established_record","unrecognized_confidence_level"],"type":"string"},"signed":{"const":false,"type":"boolean"}},"required":["action","reason_code","derived_from","signed"],"type":"object"},{"type":"null"}]},"score":{"type":["number","null" ⟨39 unchanged words⟩ ","issued_at","breakdown","signature","confidence_interval","recommended_action"],"type":"object"}

 ⟨24 unchanged words⟩ ,"expires_at":{"type":"string"},"expires_in_seconds":{"description":"Whole seconds left on this checkout SESSION at response time (0 when already past). It is not a stock reservation and not a price guarantee.","minimum":0,"type":"integer"},"items":{"items":{"additionalProperties":true," ⟨142 unchanged words⟩ 

 ⟨12 unchanged words⟩ ,"currency":{"type":"string"},"expires_at":{"description":"ISO-8601 UTC instant at which this checkout SESSION stops being usable. It is not a stock reservation and not a price guarantee.","type":"string"},"expires_in_seconds":{"description":"Whole seconds left on this checkout SESSION at response time (0 when already past). It is not a stock reservation and not a price guarantee.","minimum":0,"type":"integer"},"extensions":{"additionalProperties":true,"properties":{" ⟨337 unchanged words⟩ 

 ⟨12 unchanged words⟩ ,"currency":{"type":"string"},"expires_at":{"description":"ISO-8601 UTC instant at which this checkout SESSION stops being usable. It is not a stock reservation and not a price guarantee.","type":"string"},"expires_in_seconds":{"description":"Whole seconds left on this checkout SESSION at response time (0 when already past). It is not a stock reservation and not a price guarantee.","minimum":0,"type":"integer"},"extensions":{"additionalProperties":true,"properties":{" ⟨337 unchanged words⟩ 

 ⟨12 unchanged words⟩ ,"currency":{"type":"string"},"expires_at":{"description":"ISO-8601 UTC instant at which this checkout SESSION stops being usable. It is not a stock reservation and not a price guarantee.","type":"string"},"expires_in_seconds":{"description":"Whole seconds left on this checkout SESSION at response time (0 when already past). It is not a stock reservation and not a price guarantee.","minimum":0,"type":"integer"},"extensions":{"additionalProperties":true,"properties":{" ⟨337 unchanged words⟩ 

 ⟨12 unchanged words⟩ ,"currency":{"type":"string"},"expires_at":{"description":"ISO-8601 UTC instant at which this checkout SESSION stops being usable. It is not a stock reservation and not a price guarantee.","type":"string"},"expires_in_seconds":{"description":"Whole seconds left on this checkout SESSION at response time (0 when already past). It is not a stock reservation and not a price guarantee.","minimum":0,"type":"integer"},"extensions":{"additionalProperties":true,"properties":{" ⟨337 unchanged words⟩ 

 ⟨12 unchanged words⟩ ,"currency":{"type":"string"},"expires_at":{"description":"ISO-8601 UTC instant at which this checkout SESSION stops being usable. It is not a stock reservation and not a price guarantee.","type":"string"},"expires_in_seconds":{"description":"Whole seconds left on this checkout SESSION at response time (0 when already past). It is not a stock reservation and not a price guarantee.","minimum":0,"type":"integer"},"extensions":{"additionalProperties":true,"properties":{" ⟨337 unchanged words⟩ 

 ⟨294 unchanged words⟩ reason_unavailable":{"enum":["coming_soon","not_enabled","currency_not_supported"],"type":"string"}},"required": ⟨54 unchanged words⟩ 

 ⟨294 unchanged words⟩ reason_unavailable":{"enum":["coming_soon","not_enabled","currency_not_supported"],"type":"string"}},"required": ⟨54 unchanged words⟩ 

 ⟨294 unchanged words⟩ reason_unavailable":{"enum":["coming_soon","not_enabled","currency_not_supported"],"type":"string"}},"required": ⟨54 unchanged words⟩ 

 ⟨49 unchanged words⟩ properties":{"address1":{"description":"Street addressname and number, plus flat/door if any (e.g. \"Calle Mayor 1, 2B\")","type":"string"},"city":{"description" ⟨2 unchanged words⟩ string"},"country_code":{"description":"ISO 3166-1 alpha-2 country code, two letters (e.g. ES, US, CA). Never the country name.","type":"string"},"province_code":{ ⟨8 unchanged words⟩ zip":{"description":"Postal / ZIP code exactly as written, keeping leading zeros (e.g. \"08001\")","type":"string"}},"required": ⟨10 unchanged words⟩ 

 ⟨77 unchanged words⟩ ":["demo_card","demo_wallet","own_wallet","merchant_card","kyapay"],"type":"string"},"label" ⟨87 unchanged words⟩ 

 ⟨277 unchanged words⟩ ":["demo_card","demo_wallet","own_wallet","merchant_card","kyapay"],"type":"string"},"label" ⟨70 unchanged words⟩ 

 ⟨246 unchanged words⟩ "enum":["demo_card","demo_wallet","own_wallet","merchant_card"],"type":"string"},"shared_payment_token":{ ⟨67 unchanged words⟩ 

 ⟨277 unchanged words⟩ ":["demo_card","demo_wallet","own_wallet","merchant_card","kyapay"],"type":"string"},"label" ⟨70 unchanged words⟩ 

 ⟨277 unchanged words⟩ ":["demo_card","demo_wallet","own_wallet","merchant_card","kyapay"],"type":"string"},"label" ⟨70 unchanged words⟩ 

 ⟨277 unchanged words⟩ ":["demo_card","demo_wallet","own_wallet","merchant_card","kyapay"],"type":"string"},"label" ⟨70 unchanged words⟩ 

 ⟨277 unchanged words⟩ ":["demo_card","demo_wallet","own_wallet","merchant_card","kyapay"],"type":"string"},"label" ⟨70 unchanged words⟩ 

 ⟨47 unchanged words⟩ "array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"properties":{"destination":{"additionalProperties":true,"properties":{"city":{"type":"string"},"country_code":{"type":"string"},"province_code":{"type":"string"},"zip":{"type":"string"}},"required":["city","country_code","zip"],"type":"object"},"options":{"items":{"additionalProperties":true,"properties":{"authoritative":{"type":"boolean"},"estimated_delivery":{"type":"string"},"id":{"type":"string"},"price":{"additionalProperties":true,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"],"type":"object"},"source":{"enum":["platform","merchant_policy","estimated"],"type":"string"},"title":{"type":"string"}},"required":["id","title","price","source","authoritative"],"type":"object"},"type":"array"},"selected_option_id":{"type":"string"}},"type":"object"},"id":{"type":"string"},"idempotency_key":{"type":"string"},"intent" ⟨45 unchanged words⟩ "quantity":{"type":"number"},"title":{"type":"string"},"variant_id":{"type":"string"},"variant_title":{"type":"string"}},"required" ⟨159 unchanged words⟩ 

Update a UCP checkout sessionsession. bySend fullyline_items replacingto replace all lines (each line items.may name a variant_id), and/or fulfillment to set the delivery address (fulfillment.destination, which returns the shipping options) and choose one (fulfillment.selected_option_id, which adds shipping to the totals). Only allowed when status is 'incomplete'. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json.

 ⟨37 unchanged words⟩ ":"ISO 4217 currency code (e.g. USD). Optional: defaults to the checkout's currency.","maxLength":3,"minLength":3,"type":"string"},"fulfillment":{"additionalProperties":true,"description":"Delivery. Send destination first, then selected_option_id (or both in one call).","properties":{"destination":{"additionalProperties":true,"description":"Delivery address. Sending it loads the shipping options for that destination; the response lists them in fulfillment.options.","properties":{"address1":{"description":"Street address","type":"string"},"city":{"description":"City","type":"string"},"country_code":{"description":"ISO 3166-1 alpha-2 country code (e.g. US, ES)","type":"string"},"province_code":{"description":"Province or state code (optional)","type":"string"},"zip":{"description":"Postal / ZIP code","type":"string"}},"required":["address1","city","country_code","zip"],"type":"object"},"selected_option_id":{"description":"Id of one of fulfillment.options. Choosing it adds the shipping amount to the totals.","type":"string"}},"type":"object"},"line_items":{"description":"Replacement line items (replaces all lines). Omit to leave the lines as they are.","items":{"additionalProperties":true,"properties" ⟨70 unchanged words⟩ ","minLength":1,"type":"string"},"variant_id":{"description":"Variant (size/colour) id as listed by get_product_details. Required when the product has more than one variant; the price and stock of THAT variant apply.","minLength":1,"type":"string"}},"required":["product_id","title","quantity ⟨5 unchanged words⟩ type":"array"}},"required":["checkout_id","currency","line_items"],"type":"object"}

 ⟨47 unchanged words⟩ "array"}},"type":"object"},"fulfillment":{"additionalProperties":true,"properties":{"destination":{"additionalProperties":true,"properties":{"city":{"type":"string"},"country_code":{"type":"string"},"province_code":{"type":"string"},"zip":{"type":"string"}},"required":["city","country_code","zip"],"type":"object"},"options":{"items":{"additionalProperties":true,"properties":{"authoritative":{"type":"boolean"},"estimated_delivery":{"type":"string"},"id":{"type":"string"},"price":{"additionalProperties":true,"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"required":["amount","currency"],"type":"object"},"source":{"enum":["platform","merchant_policy","estimated"],"type":"string"},"title":{"type":"string"}},"required":["id","title","price","source","authoritative"],"type":"object"},"type":"array"},"selected_option_id":{"type":"string"}},"type":"object"},"id":{"type":"string"},"idempotency_key":{"type":"string"},"intent" ⟨45 unchanged words⟩ "quantity":{"type":"number"},"title":{"type":"string"},"variant_id":{"type":"string"},"variant_title":{"type":"string"}},"required" ⟨159 unchanged words⟩ 

 ⟨75 unchanged words⟩ that made the purchase can read its receipt. PREFER THE CART CARD: if the purchase was completed on an interactive card, it already fetches and shows this receipt itself right after the order — calling this tool yourself right after is usually redundant and opens a new card in the transcript. Call it yourself only when there is no interactive card, or the buyer asks for the receipt later in a new turn. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json.

 ⟨5 unchanged words⟩ before payment. Advances the session to ready-for-payment state.

PREFER THE CART CARD: if there is an interactive card for this cart, let it compute and show the summary instead of calling this tool yourself — it keeps the flow in one card.

SKYFIRE TOKEN (optional): Pass a kya or ⟨83 unchanged words⟩ 

 ⟨25 unchanged words⟩ option; use a new key if either changes.

PREFER THE CART CARD: if there is an interactive card for this cart, let the buyer pick shipping there instead of calling this tool yourself — it keeps the flow in one card instead of opening a new one per step.

SKYFIRE TOKEN (optional): Pass a kya or ⟨83 unchanged words⟩ 

 ⟨46 unchanged words⟩ :"object"},"type":"array"},"next_step":{"const":"ask_user_payment_method","type":"string"},"next_step_message":{"type":"string"},"payment_options":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"funding_source":{"anyOf":[{"enum":["platform_test_card","platform_test_wallet","buyer_wallet"],"type":"string"},{"type":"null"}]},"id":{"enum":["demo_card","demo_wallet","own_wallet","kyapay"],"type":"string"},"label":{"type":"string"},"rail":{"enum":["stripe","x402","kyapay"],"type":"string"},"reason_unavailable":{"enum":["coming_soon","not_enabled"],"type":"string"}},"required":["id","label","rail","funding_source","available"],"type":"object"},"type":"array"},"shipping_authoritative":{"type":"boolean"},"shipping_cents" ⟨58 unchanged words⟩ 

 ⟨160 unchanged words⟩ ,"instruction"],"type":"object"},"next_step":{"const":"ask_user_payment_method","type":"string"},"next_step_message":{"type":"string"},"payment_options":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"funding_source":{"anyOf":[{"enum":["platform_test_card","platform_test_wallet","buyer_wallet"],"type":"string"},{"type":"null"}]},"id":{"enum":["demo_card","demo_wallet","own_wallet","kyapay"],"type":"string"},"label":{"type":"string"},"rail":{"enum":["stripe","x402","kyapay"],"type":"string"},"reason_unavailable":{"enum":["coming_soon","not_enabled"],"type":"string"}},"required":["id","label","rail","funding_source","available"],"type":"object"},"type":"array"},"status":{"enum":["incomplete","requires_escalation" ⟨41 unchanged words⟩ 

 ⟨160 unchanged words⟩ ,"instruction"],"type":"object"},"next_step":{"const":"ask_user_payment_method","type":"string"},"next_step_message":{"type":"string"},"payment_options":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"funding_source":{"anyOf":[{"enum":["platform_test_card","platform_test_wallet","buyer_wallet"],"type":"string"},{"type":"null"}]},"id":{"enum":["demo_card","demo_wallet","own_wallet","kyapay"],"type":"string"},"label":{"type":"string"},"rail":{"enum":["stripe","x402","kyapay"],"type":"string"},"reason_unavailable":{"enum":["coming_soon","not_enabled"],"type":"string"}},"required":["id","label","rail","funding_source","available"],"type":"object"},"type":"array"},"status":{"enum":["incomplete","requires_escalation" ⟨41 unchanged words⟩ 

 ⟨160 unchanged words⟩ ,"instruction"],"type":"object"},"next_step":{"const":"ask_user_payment_method","type":"string"},"next_step_message":{"type":"string"},"payment_options":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"funding_source":{"anyOf":[{"enum":["platform_test_card","platform_test_wallet","buyer_wallet"],"type":"string"},{"type":"null"}]},"id":{"enum":["demo_card","demo_wallet","own_wallet","kyapay"],"type":"string"},"label":{"type":"string"},"rail":{"enum":["stripe","x402","kyapay"],"type":"string"},"reason_unavailable":{"enum":["coming_soon","not_enabled"],"type":"string"}},"required":["id","label","rail","funding_source","available"],"type":"object"},"type":"array"},"status":{"enum":["incomplete","requires_escalation" ⟨41 unchanged words⟩ 

 ⟨160 unchanged words⟩ ,"instruction"],"type":"object"},"next_step":{"const":"ask_user_payment_method","type":"string"},"next_step_message":{"type":"string"},"payment_options":{"items":{"additionalProperties":true,"properties":{"available":{"type":"boolean"},"funding_source":{"anyOf":[{"enum":["platform_test_card","platform_test_wallet","buyer_wallet"],"type":"string"},{"type":"null"}]},"id":{"enum":["demo_card","demo_wallet","own_wallet","kyapay"],"type":"string"},"label":{"type":"string"},"rail":{"enum":["stripe","x402","kyapay"],"type":"string"},"reason_unavailable":{"enum":["coming_soon","not_enabled"],"type":"string"}},"required":["id","label","rail","funding_source","available"],"type":"object"},"type":"array"},"status":{"enum":["incomplete","requires_escalation" ⟨41 unchanged words⟩ 

{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":true,"properties":{"approval_url":{"type":"string"},"created_at":{"type":"string"},"currency" ⟨101 unchanged words⟩ ,"type":"object"},"type":"array"},"next_action":{"additionalProperties":true,"properties":{"actor":{"const":"buyer","type":"string"},"do":{"enum":["approve","pay"],"type":"string"},"instruction":{"type":"string"},"reuse_arguments":{"items":{"enum":["checkout_session_id","checkout_id","idempotency_key"],"type":"string"},"type":"array"},"then_call":{"maxLength":64,"minLength":1,"type":"string"},"url":{"type":"string"}},"required":["actor","do","url","instruction"],"type":"object"},"status":{"enum":["incomplete" ⟨42 unchanged words⟩ 

{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":true,"properties":{"approval_url":{"type":"string"},"created_at":{"type":"string"},"currency" ⟨101 unchanged words⟩ ,"type":"object"},"type":"array"},"next_action":{"additionalProperties":true,"properties":{"actor":{"const":"buyer","type":"string"},"do":{"enum":["approve","pay"],"type":"string"},"instruction":{"type":"string"},"reuse_arguments":{"items":{"enum":["checkout_session_id","checkout_id","idempotency_key"],"type":"string"},"type":"array"},"then_call":{"maxLength":64,"minLength":1,"type":"string"},"url":{"type":"string"}},"required":["actor","do","url","instruction"],"type":"object"},"status":{"enum":["incomplete" ⟨42 unchanged words⟩ 

{"$schema":"http://json-schema.org/draft-07/schema#","additionalProperties":true,"properties":{"approval_url":{"type":"string"},"created_at":{"type":"string"},"currency" ⟨101 unchanged words⟩ ,"type":"object"},"type":"array"},"next_action":{"additionalProperties":true,"properties":{"actor":{"const":"buyer","type":"string"},"do":{"enum":["approve","pay"],"type":"string"},"instruction":{"type":"string"},"reuse_arguments":{"items":{"enum":["checkout_session_id","checkout_id","idempotency_key"],"type":"string"},"type":"array"},"then_call":{"maxLength":64,"minLength":1,"type":"string"},"url":{"type":"string"}},"required":["actor","do","url","instruction"],"type":"object"},"status":{"enum":["incomplete" ⟨42 unchanged words⟩ 

 ⟨12 unchanged words⟩ ,"code":{"type":"string"},"dimensions":{"additionalProperties":false,"properties":{"chain_coverage":{"additionalProperties":true,"properties":{"checkpoint_day":{"type":["string","null"]},"covered_through_seq":{"anyOf":[{"type":"integer"},{"type":"null"}]},"receipt_seq":{"anyOf":[{"type":"integer"},{"type":"null"}]},"status":{"enum":["covered","not_covered","unknown"],"type":"string"}},"required":["status","receipt_seq","covered_through_seq","checkpoint_day"],"type":"object"},"evidence_present":{"enum":["present","absent","unknown"],"type":"string"},"evidence_verified":{"enum":["verified","not_verified","not_applicable"],"type":"string"},"issuer_signed":{"enum":["verified","present_unverified","absent","rejected"],"type":"string"},"revocation":{"additionalProperties":true,"properties":{"checked_at":{"type":["string","null"]},"freshness_seconds":{"anyOf":[{"minimum":0,"type":"integer"},{"type":"null"}]},"status":{"enum":["not_revoked","revoked","unknown"],"type":"string"},"status_list_url":{"type":["string","null"]}},"required":["status","checked_at","freshness_seconds","status_list_url"],"type":"object"},"settlement":{"additionalProperties":true,"properties":{"rail_evidence_ref":{"minLength":1,"type":"string"},"status":{"enum":["settled","not_attested"],"type":"string"}},"required":["status"],"type":"object"},"version":{"const":"1.0","type":"string"}},"required":["version","issuer_signed","evidence_present","evidence_verified","chain_coverage","revocation","settlement"],"type":"object"},"docs":{"type":"string"},"does_not_attest":{"items":{"type":"string"},"type":"array"},"issued_at":{"type":"string"} ⟨37 unchanged words⟩ 

 ⟨31 unchanged words⟩ token required — request proceeds normally if omitted. PAYMENT MANDATE: this tool also requires one. Send it as the `payment_mandate` argument if your client cannot set headers, or as an `X-Payment-Mandate` header. It must carry `mandate_id`, `max_amount_cents`, `currency`, `exp`, `sub`, `aud`. Two of these are rejected outright if guessed: `exp` is an INTEGER of Unix seconds (not an ISO 8601 date), and `aud` is this store's slug (the one in the URL you are calling, not a domain). Its `currency` must match the cart's currency. Demo Store enforces `max_amount_cents` against the cart total; a real merchant may only observe that boundary, so enforce the buyer's limit in the agent too. The mandate is a spending cap you declare to limit yourself — it authorises nothing and does not prove the buyer's consent — and its `sub` must be the identity you authenticate as. `max_amount_cents` is the spending limit the person you are buying for gave you: ask them if they gave none. Schema: https://trusteed.xyz/.well-known/payment-mandate.schema.json. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json. CREDENTIAL: this store  ⟨57 unchanged words⟩ 

 ⟨67 unchanged words⟩ trust score (0.50) if omitted or invalid. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json. CREDENTIAL: this store needs one. Call the `create_sandbox_key` ⟨52 unchanged words⟩ 

 ⟨62 unchanged words⟩ :"object"},"type":"array"},"next_step":{"type":"string"},"session_state":{"enum":["new","resumed" ⟨19 unchanged words⟩ ","status","agent_session_id","session_state","display_context","next_step"],"type":"object"}

 ⟨7 unchanged words⟩  Requires shipping_address — pass it in the call. If the buyer requests the cheapest option, use cheapest_shipping_handle when non-null; it is null when rates cannot be compared in the cart currency. Rates marked authoritative=false are estimates, not the final charge.

SKYFIRE TOKEN (optional): Pass a kya  ⟨12 unchanged words⟩  token required — request proceeds normally if omitted. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json. CREDENTIAL: this store needs one. Call the  ⟨53 unchanged words⟩ 

 ⟨12 unchanged words⟩ ,"cart_id":{"type":"string"},"cheapest_shipping_handle":{"type":["string","null"]},"rates":{"items":{"additionalProperties":true," ⟨36 unchanged words⟩ array"}},"required":["cart_id","rates","cheapest_shipping_handle"],"type":"object"}

 ⟨75 unchanged words⟩  that made the purchase can read its receipt. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json.

 ⟨108 unchanged words⟩ domain). Its `currency` must match the cart's currency,currency. andDemo Store enforces `max_amount_cents` against the capcart intotal; `max_amount_cents`a isreal enforcedmerchant againstmay only observe that boundary, so enforce the cartbuyer's total.limit in the agent too. The mandate is a spending cap you declare  ⟨36 unchanged words⟩ gave you: ask them if they gave none. Schema: https://trusteed.xyz/.well-known/payment-mandate.schema.json. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json. CREDENTIAL: this store needs one. Call the  ⟨53 unchanged words⟩ 

 ⟨51 unchanged words⟩ token required — request proceeds normally if omitted. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json. CREDENTIAL: this store needs one. Call the `create_sandbox_key` ⟨52 unchanged words⟩ 

 ⟨6 unchanged words⟩  to 'canceled' status. Cannot cancel already completed checkouts. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json.

 ⟨8 unchanged words⟩  Returns a UCP checkout object with status 'incomplete'. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json.

 ⟨6 unchanged words⟩  ID. Returns the current state of the checkout. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json.

 ⟨9 unchanged words⟩  line items. Only allowed when status is 'incomplete'. Checkout guide: https://trusteed.xyz/.well-known/agent-checkout-guide.json.

Create a shopping cart in Demo Store. Returns a cart_id (the same value as checkout_session_id in preview_checkout, complete_checkout and get_trust_receipt) for use with get_shipping_rates, preview_checkout, and complete_checkout.

 ⟨107 unchanged words⟩ 

 ⟨29 unchanged words⟩ ,"line_price":{"type":"number"},"line_price_cents":{"type":"number"},"name":{"type":"string"},"quantity" ⟨2 unchanged words⟩ "sku":{"type":"string"},"unit_price":{"type":"number"},"unit_price_cents":{"type":"number"},"variant_id": ⟨43 unchanged words⟩ 

 ⟨12 unchanged words⟩ ,"expires_at":{"type":"string"},"mandate_subject":{"type":"string"},"presented_as":{"items":{"type":"string" ⟨7 unchanged words⟩ 

 ⟨642 unchanged words⟩ behind the published score call GET /api/v1/stores/{slug}/trust-score, or get_store_trust for the signed envelope./trust-score. Omitted when every value is zero.","properties ⟨63 unchanged words⟩ ]},"verificationLevel":{"type":"string"},"verificationProvenance":{"enum":["seeded","verified"],"type":"string"}},"required":["overallScore","scoringVersion","verificationLevel","verificationProvenance","componentsSourceOfTruth"],"type":"object"}} ⟨20 unchanged words⟩ 

 ⟨14 unchanged words⟩  field returned by search_products or nlweb_ask (e.g. 'prod-snk-001''prod-001'). Do not invent IDs.","type": ⟨5 unchanged words⟩ 

Get available shipping rates for the cart. CollectsRequires shippingshipping_address address— viapass elicitationit ifin supported.the call.

SKYFIRE TOKEN (optional): Pass a kya  ⟨80 unchanged words⟩ 

 ⟨36 unchanged words⟩ {"additionalProperties":true,"description":"Destination address. OmitRequired: tothis collecttool viadoes elicitationnot (Claude.ai).prompt for it.","properties":{"address1":{"description": ⟨47 unchanged words⟩ 

Retrieve the signed trust receipt for a checkoutcheckout. youA completed.receipt records the complete_checkout call; read `order_placed` before telling anyone a purchase happened. Returns the receipt id, the JWS signature and ⟨12 unchanged words⟩ answer `status: "pending"` with a retry delaydelay. —`pending` thatwith code `receipt_pending` means the purchase went throughcompleted and the receipt is on its way,way; not`checkout_in_progress` thatmeans anythingit failed.has not settled yet. Only the credential that made the purchase can read its receipt.

 ⟨6 unchanged words⟩ {"call_id":{"type":"string"},"checkout_status":{"type":"string"},"code":{"type":"string"},"docs" ⟨10 unchanged words⟩ "string"},"order_id":{"type":"string"},"order_placed":{"type":"boolean"},"receipt_id":{"type":"string"} ⟨22 unchanged words⟩ 

 ⟨120 unchanged words⟩ in `max_amount_cents` is enforced against the cart total. The mandate is a spending cap you declare to limit yourself — it authorises nothing and does not prove the buyer's consent — and its `sub` must be the identity you authenticate as. `max_amount_cents` is the spending limit the person you are buying for gave you: ask them if they gave none. CREDENTIAL: this store needs one. Call the `create_sandbox_key` ⟨52 unchanged words⟩ 

 ⟨68 unchanged words⟩  an ISO 8601 date string), `sub` (yourthe agentidentity idyou authenticate as — it is compared against it) and `aud` (the store slug this mandate ⟨8 unchanged words⟩  you are calling — not a domain). It is a spending cap you declare to limit yourself: it authorises nothing and does not prove the buyer's consent. Use this when your client cannot set an ⟨6 unchanged words⟩ 

 ⟨61 unchanged words⟩ ,"subtotal_cents":{"type":"number"},"tax_cents":{"type":"number"},"tax_status":{"enum":["included","not_calculated"],"type":"string"},"total_cents":{"type":"number"},"total_is_final":{"type":"boolean"},"total_note":{"type":"string"}},"required":["checkout_session_id","store_name","items","subtotal_cents","shipping_cents","discount_cents","total_cents","currency","tax_cents","tax_status","total_is_final","total_note","status"],"type":"object"}

 ⟨108 unchanged words⟩ ,"properties":{"amount":{"description":"PriceIgnored: inthe smallestcatalogue unitprice (cents)is used and returned per line. Any non-negative integer is accepted.","minimum":0,"type":"number"} ⟨31 unchanged words⟩ :"integer"},"title":{"description":"ProductIgnored: the catalogue title is used. Any non-empty string is accepted.","minLength":1,"type":"string"} ⟨16 unchanged words⟩ 

 ⟨61 unchanged words⟩ ,"properties":{"amount":{"description":"PriceIgnored: inthe smallestcatalogue unitprice (cents)is used and returned per line. Any non-negative integer is accepted.","minimum":0,"type":"number"} ⟨31 unchanged words⟩ :"integer"},"title":{"description":"ProductIgnored: the catalogue title is used. Any non-empty string is accepted.","minLength":1,"type":"string"} ⟨17 unchanged words⟩