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.
Как объявить поддержку
{ "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'