Demo build. Every business shown is fictional, data is synthetic and partner integrations are simulated.What is real here
AGORA
Sign inStart a free trial
Menu
BusinessesAgenciesGroupsPricingDocsTrust
Scan your siteSign inStart a free trial

Conversion: checkout

Agents buy through UCP or ACP checkout, or hand the customer to your own checkout with a signed link.

Checkout lets a customer's agent complete a purchase. There are two modes, and a business can use both:

  • Hand-off (the default in the general pack): the agent builds the selection, AGORA mints a signed, short-lived hand-off link, and the customer finishes on your own checkout. The site SDK lands the link and attributes the conversion. Nothing about payment passes through AGORA.
  • Protocol checkout: the agent runs a UCP or ACP checkout session against your MCP or protocol endpoint. Payment is a delegated PSP token (pm_demo_... in this build). The session completes only with your PSP's confirmation reference, so you remain the merchant of record.

Set it up

  1. Enable checkout for the merchant (Settings, conversion types) and choose hand-off or protocol mode.
  2. Make sure each purchasable offering has a price, availability and the policies an agent must quote (returns, delivery or fulfilment).
  3. For protocol mode, connect your PSP in the console; the demo uses a PSP sandbox stand-in.
  4. Publish. The UCP profile and, where the graph qualifies, purchase feeds are generated for you.

What an agent does

Search or list offerings, request a quote (totals, taxes, delivery), then either fetch a hand-off link or create and complete a checkout session with an Idempotency-Key. A completed checkout emits commerce.order.created, which you can receive as a webhook.

Applies to

product mustservice mayplan mayprogramme maylisting n/amembership mayevent mustconsultation mayother may

Endpoints in this build

GET/m/:slug/ucp/v1/capabilitiesregistered
POST/m/:slug/ucp/v1/checkout-sessionsregistered
POST/m/:slug/acp/checkout_sessionsregistered
POST/m/:slug/commerce/v1/cartsregistered
GET/h/:tokennot registered on this host

MCP tools

Besides the read tools every merchant server has, a business that enables Checkout exposes:

  • search_catalogue: Search catalogue
  • get_product: Get product
  • get_availability: Get availability
  • get_quote: Get quote
  • get_offers: Get offers
  • get_handoff_link: Get handoff link
  • get_order: Get order
  • start_return: Start return
  • create_case: Create case
  • get_loyalty: Get loyalty
  • negotiate_price: Negotiate price
  • acp_create_checkout_session: Create checkout session (ACP)
  • acp_update_checkout_session: Update checkout session (ACP)
  • acp_get_checkout_session: Get checkout session (ACP)
  • acp_complete_checkout_session: Complete checkout session (ACP)
  • acp_create_cart: Create cart (ACP)
  • acp_get_cart: Get cart (ACP)
  • acp_update_cart: Update cart (ACP)
  • acp_get_order: Get order (ACP)

Events

Delivered as webhooks:

commerce.checkout.created commerce.checkout.completed commerce.order.created handoff.link.generated handoff.conversion.observed

Source: docs/portal/docs/conversions/checkout.md + KIND_CONVERSION_MATRIX + registered routes + MCP tool registry