ACP Checkout Gateway — пример шлюза оформления заказов агентами

ACP Checkout Gateway — эталонная реализация HTTP-сервиса для обработки запросов от агентов в рамках протокола Agentic Commerce Protocol (ACP). Он позволяет мерчантам развернуть собственный шлюз для управления сессиями оформления заказа, валидации запросов и предоставления актуального состояния корзины. Сервис предназначен для компаний, которым требуется интеграция их систем электронной коммерции с агентскими платформами.

Возможности и состав проекта

Шлюз предоставляет HTTP-endpoints сессий checkout, связь с системой заказов и вебхуки синхронизации. В реализации предусмотрены история сессий, идемпотентность и проверка входных данных. При этом раздел Known Limitations уточняет, что проверка подписей запросов и API-key-аутентификация входящих вызовов не реализованы, несмотря на более широкое описание во введении.

Начало работы и требования

README описывает локальную разработку на Node.js и развёртывание в AWS Lambda через Terraform или AWS SAM. Нужны настройки таблиц DynamoDB, URL политик мерчанта и реализация MerchantService для собственной корзины, наличия и заказов. Примеры имён репозитория и ресурсов следует адаптировать к своему окружению.

Ограничения и выбор сценария

Это референсная интеграция, которую нельзя считать готовой платёжной границей безопасности. Авторы прямо указывают отсутствие проверки подписи и входящей API-key-аутентификации. Перед публичным размещением нужны собственные контроль доступа и проверка происхождения запросов, а также тесты повторов, согласованности корзины и отказов внешней системы заказов.

Лицензия и условия использования

GitHub определяет лицензию репозитория как Apache-2.0. Перед использованием и распространением проверьте полный текст LICENSE и отдельные условия зависимостей, данных или моделей: лицензия репозитория не заменяет их лицензии.