Skip to main content

Agentic commerce Beta

Agentic commerce represents a transformative approach to commerce, where AI agents handle the entire shopping experience for a shopper, from product discovery to checkout.

To increase the value of agentic commerce, Talon.One offers the Unified Incentives Protocol (UIP). UIP is a set of platform-agnostic standards that expose loyalty and promotion methods in a unified way, in all phases of the shopping lifecycle.

Universal Commerce Protocol (UCP)​

UCP is Google's approach to establishing a framework for seamless, secure, and standardized interactions between businesses and AI agents such as Gemini.

Talon.One's loyalty extension​

With Talon.One's UCP loyalty extension, you can let AI agents support complex profile or card-based loyalty scenarios involving memberships, multi-wallet programs, tiers, and more.

1

Create your initial UCP profile​

Familiarize yourself with the UCP core concepts and the UCP specification, then create your initial UCP profile located at /.well-known/ucp to let AI agents discover and interact with your business.

2

Enable the required Google capabilities​

Google offers a number of UCP capabilities that the Talon.One loyalty extension requires:

  1. Enable the dev.ucp.shopping.checkout capability. Talon.One relies on this capability to be aware of the session data.
  2. Enable the dev.ucp.common.identity_linking capability. Talon.One's loyalty extension requires identity information to link a shopper to their loyalty profile.
  3. This guide focuses on REST endpoints to handle UCP requests for this capability, so you must reference your endpoint in your UCP profile.
.well-known/ucp
{
  "ucp": {
    "version": "2026-01-11",
    "services": {
      "dev.ucp.shopping": {
        "version": "2026-01-11",
        "spec": "https://ucp.dev/specification/overview",
        "rest": {
          "schema": "https://ucp.dev/services/shopping/rest.openapi.json",
          "endpoint": "https://business.example.com/ucp/v1"
        },
      },
      ...
    },
    "capabilities": [
      {
        "name": "dev.ucp.shopping.checkout",
        "version": "2026-01-11",
        "spec": "https://ucp.dev/specification/checkout",
        "schema": "https://ucp.dev/schemas/shopping/checkout.json"
      },
      {
       "name": "dev.ucp.common.identity_linking",
       "version": "2026-01-11",
       "specs": {
         ...
       }
      },
      ...
    ]
  },
  "payment": {
    ...
  },
  ...
}
3

Enable the Talon.One UCP loyalty extension​

To enable the loyalty extension, reference it in your UCP profile's capabilities array:

.well-known/ucp
{
    "capabilities": [
      {
        "name": "dev.uip.shopping.loyalty",
        "version": "2026-01-23",
        "extends": "dev.ucp.shopping.checkout",
        "spec": "https://uip.dev/specification/ucp/loyalty",
        "schema": "https://uip.dev/schemas/ucp/shopping/loyalty.json"
      }
    ]
}
4

Inject loyalty data in your UCP responses​

Once your UCP profile includes Talon.One's loyalty extension, implement extra logic in your backend services to include loyalty-related data in your responses for relevant UCP operations. Retrieve loyalty data with the Integration API's loyalty endpoints and structure that data according to the loyalty extension schema.

For example, for the Create checkout operation, you can fetch the user's loyalty point balance from Talon.One and include it in the checkout session creation response:

Create checkout operation
POST /checkout-sessions HTTP/1.1
UCP-Agent: profile="https://platform.example/profile"
Content-Type: application/json

{
  "line_items": [
    {
      "item": {
        "id": "item_123",
        "title": "Red T-Shirt",
        "price": 2500
      },
      "id": "li_1",
      "quantity": 2
    }
  ]
}

Upgrade the Talon.One UCP extension​

When a new version of the extension is released, update the version field in your UCP profile accordingly. You can find the latest version here.

Version history​

  • 2026-01-23 (current)