acp-sandbox

Tools

Token cost is the o200k count of the tools list JSON, including schemas, before any tool is called.

• list_products

  List everything the demo store sells, with product ids and prices. Prices are in USD.

• create_checkout

  Start a checkout (an Agentic Commerce Protocol checkout session) with the products and quantities the user wants. Returns the session id, the cart and its total. If you have no api_key yet, leave it o

• update_checkout

  Replace the items in an open checkout (e.g. the user changed their mind). Any PayPal payment created for the old total is dropped — request a new one.

• get_checkout

  Read the current cart, total, payment status and order of a checkout.

• request_paypal_payment

  Create a PayPal (sandbox) payment for the checkout's exact total. Returns approve_url: give that link to the user and ask them to approve the payment on PayPal — you cannot approve it yourself. Then c

• wait_for_payment_approval

  Wait (up to 45s per call) until PayPal reports the user approved the payment. If it returns still_waiting, the user hasn't approved yet — ask them, then call again.

• complete_checkout

  Place the order. With payment "paypal" the approved PayPal payment is captured first, and the order only goes through if PayPal confirms the money for the exact total. "mock" skips real payment (testi

• cancel_checkout

  Cancel an open checkout. Nothing is charged.