Commerce Сложно

UCP (Universal Commerce Protocol): весь цикл покупки для агента

Что такое UCP (Google + Shopify/Visa/…), чем шире чем x402/MPP, как объявить поддержку и как мы это проверяем.

Обновлено:

Что это

UCP (Universal Commerce Protocol) — открытый стандарт коммерческих транзакций для AI-агентов от Google (совместно с Shopify, Etsy, Wayfair, Target, Walmart и 20+ endorsers, включая Visa, Mastercard, Stripe). В отличие от x402 и MPP (только платёж), UCP покрывает весь цикл: discovery → cart → checkout → order management.

Зачем это AI-агентам

Когда агент получает задание «закажи доставку», ему нужен стандартный способ пройти весь сценарий автономно:

ЭтапЧто делает агент
DiscoveryНаходит товар/сервис по каталогу
CartФормирует корзину, проверяет наличие
CheckoutОформляет заказ и платёж
Order managementОтслеживает статус, возвраты

Транспорты — REST и JSON-RPC; работает с агентными стеками AP2/A2A/MCP; питает checkout в Google AI Mode и Gemini.

Как объявить поддержку

В ai-agent.json:

{ "payments": { "ucp": "https://api.example.com/ucp" } }

Или Link-заголовком:

Link: <https://api.example.com/ucp>; rel="ucp-endpoint"

Полная интеграция — реализация UCP-эндпоинтов для каждого этапа. Документация: developers.google.com/merchant/ucp.

Типичные ошибки

  • Нет декларации в ai-agent.json/Link — агент не найдёт поддержку.
  • Реализован только платёж, без discovery/cart/order — это не полный UCP.
  • Битый endpoint по объявленному URL.

Как проверить

Проверка UCP информационная (на балл не влияет). Сканер ищет декларацию: поле payments.ucp в /.well-known/ai-agent.json или Link rel="ucp-endpoint". Реальный коммерческий флоу не тестируется.

curl -s https://example.com/.well-known/ai-agent.json | jq '.payments.ucp'
curl -sI https://example.com/ | grep -i 'ucp-endpoint'

Источники