Trong hướng dẫn này, bạn sẽ tìm hiểu Universal Commerce Protocol (UCP) là gì, dành cho ai, vì sao cần một tiêu chuẩn thương mại mới và kiến trúc của nó vận hành ra sao.
Bạn cũng sẽ làm theo phần hướng dẫn thực hành để thiết lập máy chủ mẫu UCP của riêng mình, khám phá hồ sơ khám phá (discovery profile), tạo phiên thanh toán (checkout session) và chạy một luồng ví dụ hoàn chỉnh trên máy cục bộ.
Điều này sẽ giúp bạn vừa hiểu rõ giao thức, vừa có điểm khởi đầu thực tiễn để kiểm thử cách UCP hoạt động trong triển khai thực tế.
Giới thiệu về Universal Commerce Protocol
Universal Commerce Protocol là một tiêu chuẩn mở giúp các tác nhân AI, ứng dụng, doanh nghiệp và nhà cung cấp thanh toán phối hợp với nhau trong một luồng mua sắm chung. Thay vì phải xây dựng tích hợp tùy chỉnh cho từng đối tác mới, UCP cung cấp một cách giao tiếp chung.
UCP được thiết kế cho mua sắm do tác nhân dẫn dắt hiện đại, nơi người dùng khám phá và mua sản phẩm thông qua trợ lý AI và giao diện hội thoại. Nó hỗ trợ toàn bộ hành trình, từ khám phá doanh nghiệp cung cấp gì đến bắt đầu thanh toán và quản lý giao dịch theo cách có cấu trúc.
Nói đơn giản, UCP hoạt động như một ngôn ngữ chung cho thương mại. Doanh nghiệp có thể công bố những gì mình hỗ trợ, và tác nhân có thể đọc thông tin đó để tương tác mà không cần tích hợp API riêng lẻ. Shopify mô tả đây là hạ tầng được xây dựng để vận hành thương mại do tác nhân dẫn dắt ở quy mô lớn.
UCP cũng là mã nguồn mở và trung lập nhà cung cấp. Nó được thiết kế để làm việc với các hệ thống thương mại hiện có, và tương thích với Agent Payments Protocol (AP2) để thanh toán an toàn do tác nhân thực hiện. Nó cũng có thể hoạt động qua các phương thức truyền tải khác nhau, bao gồm REST API, giao tiếp tác nhân–tác nhân và MCP.
Universal Commerce Protocol được xây dựng cho ai?
UCP được xây dựng cho các nhóm chính tham gia vào thương mại số hiện đại. Mục tiêu là cung cấp cho tất cả một cách giao tiếp chung, để họ có thể hợp tác mà không cần tích hợp tùy chỉnh cho từng kết nối.
Chủ yếu dành cho:
1. Tác nhân AI và các nền tảng dành cho người tiêu dùng
Đây là các ứng dụng, trợ lý và bề mặt khám phá giúp người dùng tìm sản phẩm và mua hàng. UCP giúp họ hiểu doanh nghiệp hỗ trợ gì và tương tác theo cách có cấu trúc. Google mô tả điều này là kết nối các bề mặt người tiêu dùng với hệ thống hậu trường của doanh nghiệp để mua sắm liền mạch.
2. Doanh nghiệp và nhà bán hàng
UCP giúp doanh nghiệp công bố sản phẩm, luồng thanh toán và các tính năng được hỗ trợ theo một định dạng tiêu chuẩn. Điều này giúp họ làm việc dễ dàng hơn với các nền tảng và tác nhân AI khác nhau mà không cần xây dựng tích hợp riêng cho từng bên.
3. Nhà cung cấp thanh toán
Các nhà cung cấp thanh toán cũng là một phần của hệ sinh thái UCP. Giao thức được thiết kế để hỗ trợ các bộ xử lý thanh toán và thông tin thanh toán khác nhau một cách linh hoạt, giúp xử lý thanh toán an toàn trên nhiều hệ thống.
4. Nhà phát triển và người xây dựng giao thức
UCP là mã nguồn mở, nên cũng dành cho các nhà phát triển muốn triển khai, mở rộng hoặc đóng góp cho tiêu chuẩn. Dự án UCP mời gọi doanh nghiệp, nhà phát triển và nhà cung cấp thanh toán cùng định hình tương lai của giao thức.
Nói ngắn gọn, UCP được xây dựng cho bất kỳ ai tham gia vào thương mại vận hành bằng AI: nền tảng hỗ trợ người dùng mua sắm, doanh nghiệp bán sản phẩm, hệ thống thanh toán xử lý giao dịch và các nhà phát triển xây dựng kết nối giữa họ.
Vì sao cần một tiêu chuẩn thương mại mới
Cần một tiêu chuẩn thương mại mới vì hầu hết các hệ thống hiện tại được xây cho website và ứng dụng di động truyền thống, không phải cho trợ lý AI và mua sắm hội thoại.
Mô hình cũ thường phụ thuộc vào API tùy chỉnh và các tích hợp đơn lẻ, khiến việc mở rộng trên nhiều nền tảng trở nên chậm và khó khăn. UCP ra đời để giải quyết điều đó bằng cách cung cấp cho doanh nghiệp, tác nhân và nền tảng một cách giao tiếp chung.
Khi ngày càng nhiều người bắt đầu mua sắm qua công cụ AI, thương mại cần hỗ trợ các hành động trực tiếp như khám phá sản phẩm, thanh toán, giảm giá và cập nhật đơn hàng trong cùng một cuộc hội thoại.
UCP được thiết kế cho phong cách mua sắm mới này, nơi trải nghiệm mang tính tương tác hơn và diễn ra trên nhiều bề mặt số khác nhau.
Nó cũng cần thiết vì hệ sinh thái thương mại ngày nay bị phân mảnh. Các doanh nghiệp, nhà cung cấp thanh toán và nền tảng khác nhau thường dùng hệ thống khác nhau. UCP giúp đưa họ lại với nhau qua một tiêu chuẩn chung, để có thể hợp tác mà không phải xây đi xây lại cùng một tích hợp hết lần này đến lần khác.
Nói đơn giản, UCP cần thiết vì các công cụ thương mại cũ không được xây cho mua sắm do AI dẫn dắt. Nó mang lại nền tảng hiện đại, linh hoạt hơn cho cách mọi người sẽ khám phá và mua sản phẩm trong tương lai.
Tìm hiểu kiến trúc Universal Commerce Protocol
Universal Commerce Protocol (UCP) là một hệ thống mô-đun cho thương mại do tác nhân điều phối. Nó cung cấp cho doanh nghiệp, tác nhân AI và nhà cung cấp thanh toán một cách chung để xử lý hành trình mua sắm, từ khám phá đến thanh toán và hơn thế nữa.
Thay vì xây các tích hợp tùy chỉnh riêng cho từng nền tảng, UCP cho phép doanh nghiệp công bố những gì mình hỗ trợ để tác nhân có thể đọc thông tin và đi theo một luồng chuẩn.
UCP được thiết kế theo hướng mô-đun và có thể mở rộng, hỗ trợ các phương thức truyền tải như REST, MCP và A2A, và làm việc với bộ xử lý thanh toán để doanh nghiệp có thể dễ dàng tiếp tục dùng thiết lập thanh toán sẵn có.
1. Doanh nghiệp công bố hồ sơ khám phá
Một doanh nghiệp hỗ trợ UCP sẽ phơi bày một hồ sơ tại /.well-known/ucp. Hồ sơ này cho nền tảng và tác nhân biết doanh nghiệp hỗ trợ những gì trước khi bất kỳ giao dịch nào bắt đầu, bao gồm các khả năng và endpoint khả dụng.
2. Tác nhân đọc các khả năng được hỗ trợ
Sau khi khám phá, tác nhân kiểm tra doanh nghiệp cung cấp dịch vụ và khả năng nào. Đợt ra mắt đầu tiên của UCP tập trung vào các khả năng cốt lõi như Thanh toán (Checkout), Liên kết danh tính (Identity Linking) và Quản lý đơn hàng (Order Management), đóng vai trò là các khối xây dựng chính của giao thức.
3. Phần mở rộng bổ sung tính năng
UCP giữ luồng lõi đơn giản, nhưng doanh nghiệp có thể thêm các phần mở rộng tùy chọn khi cần. Các phần mở rộng này xây dựng dựa trên khả năng cốt lõi và cho phép doanh nghiệp hỗ trợ tính năng phong phú hơn mà không phải thay đổi toàn bộ giao thức.
4. Luồng chạy qua một phương thức truyền tải được hỗ trợ
Khi tác nhân biết những gì được hỗ trợ, nó có thể tương tác với doanh nghiệp bằng một phương thức truyền tải như REST, MCP hoặc A2A. Điều này giúp cùng một logic thương mại dễ dùng hơn trên API, công cụ AI và hệ thống tác nhân–tác nhân.
5. Thanh toán được xử lý qua bộ xử lý thanh toán
UCP tách luồng thương mại khỏi lớp thanh toán. Doanh nghiệp có thể khai báo các bộ xử lý thanh toán được hỗ trợ, và giao thức được thiết kế để nhà bán có thể tiếp tục dùng các tích hợp thanh toán hiện tại thay vì xây lại từ đầu.
6. Thanh toán an toàn do tác nhân thực hiện có thể dùng AP2
UCP tương thích với Agent Payments Protocol (AP2), bổ sung một lớp an toàn cho thanh toán do tác nhân thực hiện. Điều này giúp hỗ trợ ủy quyền an toàn hơn khi tác nhân AI hành động thay mặt người dùng.
Hướng dẫn Universal Commerce Protocol từ đầu đến cuối
Hướng dẫn này trình bày một luồng Universal Commerce Protocol hoàn chỉnh bằng bản triển khai tham chiếu Python. Bạn sẽ thiết lập máy chủ mẫu của nhà bán, nạp danh mục cửa hàng hoa demo, khám phá các khả năng của doanh nghiệp, tạo phiên thanh toán, áp dụng mã giảm giá và sau đó dừng máy chủ.
Bước 1: Thiết lập máy chủ doanh nghiệp
Ở bước này, bạn sẽ cài đặt uv để quản lý phụ thuộc Python, sau đó clone cả UCP Python SDK và kho máy chủ mẫu. README của máy chủ mẫu làm theo mẫu thiết lập tương tự và lưu ý rằng đường dẫn tương đối đến SDK là quan trọng cho các ví dụ.
Vì hệ điều hành của chúng ta là Linux, chúng ta sẽ dùng lệnh sau để cài đặt uv. uv là trình quản lý gói và môi trường Python nhanh, tin cậy. Nó có mục đích tương tự các công cụ như Anaconda, nhưng nhẹ và nhanh hơn nhiều.
curl-LsSf https://astral.sh/uv/install.sh |shĐược hỗ trợ bởi
Sau khi cài đặt xong, tải lại phiên terminal của bạn để lệnh uv khả dụng trong shell hiện tại.
Đến đây, máy chủ doanh nghiệp mẫu đã sẵn sàng trong không gian làm việc của bạn. Máy chủ này đã triển khai các khả năng mua sắm cốt lõi do UCP định nghĩa.
Bước 2: Tạo cơ sở dữ liệu sản phẩm mẫu
Ở bước này, bạn sẽ tạo một cửa hàng demo cục bộ dựa trên SQLite cho doanh nghiệp mẫu. Doanh nghiệp mẫu trong hướng dẫn này là một cửa hàng hoa, và lệnh này sẽ nạp danh mục sản phẩm ví dụ và cơ sở dữ liệu giao dịch mà máy chủ sẽ dùng.
Trước tiên, tạo một thư mục tạm thời để lưu các tệp cơ sở dữ liệu.
Tiếp theo, chạy script nhập liệu để tạo và nạp cơ sở dữ liệu sản phẩm và giao dịch.
uv run import_csv.py \--products_db_path=/tmp/ucp_test/products.db \--transactions_db_path=/tmp/ucp_test/transactions.db \--data_dir=../test_data/flower_shopĐược hỗ trợ bởi
Lệnh này thực hiện những việc sau:
--products_db_path tạo cơ sở dữ liệu danh mục sản phẩm.
--transactions_db_path tạo cơ sở dữ liệu giao dịch dùng cho trạng thái checkout.
--data_dir=../test_data/flower_shop trỏ đến dữ liệu cửa hàng hoa mẫu đi kèm trong kho.
Sau bước này, dữ liệu cửa hàng mẫu cục bộ của bạn đã sẵn sàng và máy chủ có thể sử dụng.
Bước 3: Khởi động máy chủ doanh nghiệp
Ở bước này, bạn sẽ khởi động máy chủ doanh nghiệp UCP mẫu. Máy chủ này sẽ dùng cơ sở dữ liệu sản phẩm và giao dịch bạn đã tạo ở bước trước và phơi bày các API mua sắm UCP trên cổng 8182.
Chạy lệnh sau để khởi động máy chủ ở chế độ nền.
uv run server.py \--products_db_path=/tmp/ucp_test/products.db \--transactions_db_path=/tmp/ucp_test/transactions.db \--port=8182&SERVER_PID=$!Được hỗ trợ bởi
Lệnh này thực hiện những việc sau:
uv run server.py khởi động máy chủ Python mẫu.
--products_db_path kết nối máy chủ với cơ sở dữ liệu sản phẩm.
--transactions_db_path kết nối máy chủ với cơ sở dữ liệu giao dịch.
--port=8182 yêu cầu máy chủ chạy trên cổng 8182.
& chạy tiến trình ở chế độ nền để bạn tiếp tục dùng terminal.
SERVER_PID=$! lưu ID tiến trình để dừng máy chủ sau này.
Lúc này, máy chủ doanh nghiệp đang chạy và sẵn sàng nhận yêu cầu từ tác nhân.
Bước 4: Khám phá các khả năng của doanh nghiệp
Ở bước này, bạn sẽ truy vấn endpoint khám phá của UCP. Mọi doanh nghiệp hỗ trợ UCP đều công bố tài liệu khám phá tại /.well-known/ucp, cho phép tác nhân hiểu doanh nghiệp hỗ trợ gì trước khi gửi bất kỳ yêu cầu nào.
Trước tiên, lưu URL máy chủ vào một biến để các lệnh sau dễ đọc hơn.
những khả năng nào được triển khai, như checkout và giảm giá,
và bộ xử lý hoặc lược đồ thanh toán nào được hỗ trợ.
Bước khám phá này quan trọng vì loại bỏ nhu cầu tích hợp tùy chỉnh hard-code. Tác nhân có thể kiểm tra máy chủ trước rồi quyết định cách tương tác.
Bước 5: Tạo phiên thanh toán (checkout session)
Ở bước này, bạn sẽ tạo một phiên thanh toán mới bằng khả năng checkout của UCP. Đây là lúc tác nhân gửi sản phẩm đã chọn, thông tin người mua và cấu trúc thanh toán đến máy chủ doanh nghiệp.
Trước khi gửi yêu cầu, hãy tạo các header bắt buộc. Các header này hỗ trợ truy vết yêu cầu, đảm bảo idempotent và xác thực chữ ký.
exportREQUEST_ID=$(uuidgen 2>/dev/null ||cat /proc/sys/kernel/random/uuid)exportIDEMPOTENCY_KEY=$(uuidgen 2>/dev/null ||cat /proc/sys/kernel/random/uuid)exportREQUEST_SIGNATURE="dev"Được hỗ trợ bởi
Cụ thể:
REQUEST_ID tạo một định danh duy nhất cho yêu cầu.
IDEMPOTENCY_KEY đảm bảo cùng một yêu cầu sẽ không bị xử lý hai lần nếu được gửi lại.
REQUEST_SIGNATURE cung cấp header chữ ký bắt buộc. Trong môi trường demo cục bộ, có thể dùng "dev" nếu không bật xác thực chữ ký nghiêm ngặt.
và payment để cung cấp cấu trúc thanh toán bắt buộc.
Phản hồi sẽ trả về đối tượng phiên checkout. Bao gồm ID checkout mới, ID dòng hàng, tổng tiền, thông tin người mua và trạng thái checkout hiện tại.
Bước 6: Áp dụng giảm giá bằng UCP
Ở bước này, bạn sẽ cập nhật phiên checkout hiện có và áp dụng mã giảm giá. Giảm giá trong UCP được triển khai như một phần mở rộng của khả năng checkout, vì vậy mã giảm giá sẽ được thêm vào trong yêu cầu cập nhật checkout.
Đầu tiên, lưu ID checkout thật và ID dòng hàng được trả về từ phản hồi checkout trước đó.
exportCHECKOUT_ID=5dd08e18-c9c1-4fa1-a0d1-885ca81cda29
exportLINE_ITEM_ID=ed72ebe6-2484-4e7b-afc8-a8ff5c8f430eĐược hỗ trợ bởi
Tiếp theo, tạo mới request ID và idempotency key cho yêu cầu cập nhật này.
exportREQUEST_ID=$(uuidgen 2>/dev/null ||cat /proc/sys/kernel/random/uuid)exportIDEMPOTENCY_KEY=$(uuidgen 2>/dev/null ||cat /proc/sys/kernel/random/uuid)exportREQUEST_SIGNATURE="dev"Được hỗ trợ bởi
Bây giờ gửi yêu cầu cập nhật checkout kèm mã giảm giá.
Phản hồi sẽ trả về đối tượng checkout đã cập nhật với:
tổng tiền được tính lại,
số tiền giảm giá,
tổng tiền cuối cùng đã cập nhật,
và chi tiết giảm giá đã áp dụng.
Mã giảm giá hợp lệ; bạn sẽ thấy giá thay đổi trong phản hồi.
Bước 7: Tắt máy chủ
Ở bước cuối cùng này, bạn sẽ dừng máy chủ doanh nghiệp mẫu đã khởi động trước đó. Vì bạn đã lưu ID tiến trình khi khởi động máy chủ, bạn có thể tắt nó dễ dàng chỉ với một lệnh.
Từ đầu đến cuối, bạn đã xây dựng và kiểm thử thành công một luồng UCP end-to-end trên máy cục bộ của mình.
Bạn đã:
cài đặt công cụ Python cần thiết bằng uv,
clone UCP Python SDK và kho máy chủ mẫu,
tạo cơ sở dữ liệu sản phẩm cho cửa hàng hoa mẫu,
khởi động máy chủ doanh nghiệp,
khám phá các khả năng UCP của máy chủ qua endpoint khám phá,
tạo một phiên checkout với vai trò tác nhân,
cập nhật phiên đó bằng cách áp dụng mã giảm giá,
và cuối cùng tắt máy chủ.
Nói một cách đơn giản, bạn đã thiết lập một doanh nghiệp hỗ trợ UCP hoạt động, kết nối tới đó như một tác nhân, tạo quy trình thanh toán và kiểm thử cách UCP xử lý cập nhật như giảm giá. Điều này mang lại cho bạn một ví dụ cơ bản đầy đủ về cách doanh nghiệp và tác nhân có thể tương tác bằng Universal Commerce Protocol.
Kết luận
Universal Commerce Protocol mang đến cho ngành một nền tảng chung cho thương mại do AI dẫn dắt. Nó tạo ra cách chuẩn để doanh nghiệp, tác nhân AI và hệ thống thanh toán giao tiếp, giúp hỗ trợ khám phá, thanh toán, cập nhật và chi trả dễ dàng hơn mà không phải xây tích hợp tùy chỉnh cho từng nền tảng mới.
Trong hướng dẫn này, bạn đã biết UCP là gì, vì sao quan trọng, kiến trúc hoạt động ra sao, và cách chạy một ví dụ cục bộ hoàn chỉnh từ đầu đến cuối. Bằng việc thiết lập máy chủ mẫu, khám phá các khả năng, tạo phiên checkout và áp dụng giảm giá, bạn đã thấy cách UCP biến thương mại thành một quy trình có cấu trúc, thân thiện với tác nhân.
Cơ hội lớn nhất của UCP là rõ ràng: nó có thể giảm phân mảnh và làm cho thương mại tương tác liên vận hơn trong bối cảnh mua sắm ngày càng diễn ra thông qua trợ lý AI và giao diện hội thoại.
Tuy nhiên, thách thức thực sự sẽ là mức độ chấp nhận. Doanh nghiệp có thể vẫn chọn API tùy chỉnh, tích hợp dựa trên REST hiện có, công cụ dựa trên MCP hoặc các luồng tác nhân khác mà họ đang dùng. Để UCP thành công, cần có sự ủng hộ mạnh mẽ từ hệ sinh thái gồm nhà bán, nền tảng, nhà phát triển và nhà cung cấp thanh toán.
Câu hỏi thường gặp về UCP
Universal Commerce Protocol (UCP) là gì?⌄
Được công bố vào tháng 1 năm 2026 bởi Google và Shopify, UCP là một tiêu chuẩn mã nguồn mở đóng vai trò như ngôn ngữ chung cho "agentic commerce" (thương mại do tác nhân điều phối). Thay vì yêu cầu kết nối API tùy chỉnh cho mọi nền tảng AI mới, UCP cho phép trợ lý AI (như Gemini, ChatGPT hoặc Copilot) khám phá sản phẩm, thương lượng các khả năng và hoàn tất thanh toán an toàn trên nhiều nhà bán khác nhau bằng một khung chuẩn duy nhất.
Nếu tác nhân AI xử lý thanh toán, tôi có mất trạng thái "Merchant of Record" không?⌄
Không. Một trong những nguyên tắc cốt lõi của UCP là doanh nghiệp vẫn giữ vai trò Merchant of Record (MoR). Bạn vẫn sở hữu đầy đủ mối quan hệ với khách hàng, dữ liệu sơ cấp của mình, logic định giá và trải nghiệm hậu mua hàng (như thực hiện đơn và hoàn trả). AI chỉ đóng vai trò là lớp tương tác thay mặt người dùng.
UCP có thay thế backend thương mại điện tử hiện tại của tôi không?⌄
Hoàn toàn không. UCP được thiết kế để nằm trên hạ tầng hiện có của bạn. Bằng cách công bố một hồ sơ khám phá JSON đơn giản tại /.well-known/ucp, bạn khai báo những gì backend hiện tại hỗ trợ. UCP không phụ thuộc phương thức truyền tải, nghĩa là có thể định tuyến các yêu cầu này qua REST API tiêu chuẩn, Model Context Protocol (MCP) hoặc giao tiếp tác nhân–tác nhân (A2A) mà không cần bạn xây lại toàn bộ cơ sở dữ liệu hay danh mục.
UCP xử lý thanh toán an toàn mà không có sự can thiệp của con người như thế nào?⌄
UCP chủ đích tách luồng thương mại (giỏ hàng, giảm giá, vận chuyển) khỏi lớp thanh toán. Nó cho phép nhà bán khai báo các bộ xử lý thanh toán được hỗ trợ (như Stripe, Adyen hoặc Google Pay). Đối với giao dịch tự động, do tác nhân dẫn dắt, UCP tích hợp với Agent Payments Protocol (AP2), giao thức sử dụng ủy nhiệm mật mã để chứng minh người dùng đã ủy quyền giao dịch một cách an toàn trước khi tác nhân thực thi.
Trong hướng dẫn này, bạn sẽ tìm hiểu Universal Commerce Protocol (UCP) là gì, dành cho ai, vì sao cần một tiêu chuẩn thương mại mới và kiến trúc của nó vận hành ra sao.
Bạn cũng sẽ làm theo phần hướng dẫn thực hành để thiết lập máy chủ mẫu UCP của riêng mình, khám phá hồ sơ khám phá (discovery profile), tạo phiên thanh toán (checkout session) và chạy một luồng ví dụ hoàn chỉnh trên máy cục bộ.
Điều này sẽ giúp bạn vừa hiểu rõ giao thức, vừa có điểm khởi đầu thực tiễn để kiểm thử cách UCP hoạt động trong triển khai thực tế.
Giới thiệu về Universal Commerce Protocol
Universal Commerce Protocol là một tiêu chuẩn mở giúp các tác nhân AI, ứng dụng, doanh nghiệp và nhà cung cấp thanh toán phối hợp với nhau trong một luồng mua sắm chung. Thay vì phải xây dựng tích hợp tùy chỉnh cho từng đối tác mới, UCP cung cấp một cách giao tiếp chung.
UCP được thiết kế cho mua sắm do tác nhân dẫn dắt hiện đại, nơi người dùng khám phá và mua sản phẩm thông qua trợ lý AI và giao diện hội thoại. Nó hỗ trợ toàn bộ hành trình, từ khám phá doanh nghiệp cung cấp gì đến bắt đầu thanh toán và quản lý giao dịch theo cách có cấu trúc.
Nguồn: Google Developers Blog
Nói đơn giản, UCP hoạt động như một ngôn ngữ chung cho thương mại. Doanh nghiệp có thể công bố những gì mình hỗ trợ, và tác nhân có thể đọc thông tin đó để tương tác mà không cần tích hợp API riêng lẻ. Shopify mô tả đây là hạ tầng được xây dựng để vận hành thương mại do tác nhân dẫn dắt ở quy mô lớn.
UCP cũng là mã nguồn mở và trung lập nhà cung cấp. Nó được thiết kế để làm việc với các hệ thống thương mại hiện có, và tương thích với Agent Payments Protocol (AP2) để thanh toán an toàn do tác nhân thực hiện. Nó cũng có thể hoạt động qua các phương thức truyền tải khác nhau, bao gồm REST API, giao tiếp tác nhân–tác nhân và MCP.
Universal Commerce Protocol được xây dựng cho ai?
UCP được xây dựng cho các nhóm chính tham gia vào thương mại số hiện đại. Mục tiêu là cung cấp cho tất cả một cách giao tiếp chung, để họ có thể hợp tác mà không cần tích hợp tùy chỉnh cho từng kết nối.
Chủ yếu dành cho:
1. Tác nhân AI và các nền tảng dành cho người tiêu dùng
Đây là các ứng dụng, trợ lý và bề mặt khám phá giúp người dùng tìm sản phẩm và mua hàng. UCP giúp họ hiểu doanh nghiệp hỗ trợ gì và tương tác theo cách có cấu trúc. Google mô tả điều này là kết nối các bề mặt người tiêu dùng với hệ thống hậu trường của doanh nghiệp để mua sắm liền mạch.
2. Doanh nghiệp và nhà bán hàng
UCP giúp doanh nghiệp công bố sản phẩm, luồng thanh toán và các tính năng được hỗ trợ theo một định dạng tiêu chuẩn. Điều này giúp họ làm việc dễ dàng hơn với các nền tảng và tác nhân AI khác nhau mà không cần xây dựng tích hợp riêng cho từng bên.
3. Nhà cung cấp thanh toán
Các nhà cung cấp thanh toán cũng là một phần của hệ sinh thái UCP. Giao thức được thiết kế để hỗ trợ các bộ xử lý thanh toán và thông tin thanh toán khác nhau một cách linh hoạt, giúp xử lý thanh toán an toàn trên nhiều hệ thống.
4. Nhà phát triển và người xây dựng giao thức
UCP là mã nguồn mở, nên cũng dành cho các nhà phát triển muốn triển khai, mở rộng hoặc đóng góp cho tiêu chuẩn. Dự án UCP mời gọi doanh nghiệp, nhà phát triển và nhà cung cấp thanh toán cùng định hình tương lai của giao thức.
Nói ngắn gọn, UCP được xây dựng cho bất kỳ ai tham gia vào thương mại vận hành bằng AI: nền tảng hỗ trợ người dùng mua sắm, doanh nghiệp bán sản phẩm, hệ thống thanh toán xử lý giao dịch và các nhà phát triển xây dựng kết nối giữa họ.
Vì sao cần một tiêu chuẩn thương mại mới
Cần một tiêu chuẩn thương mại mới vì hầu hết các hệ thống hiện tại được xây cho website và ứng dụng di động truyền thống, không phải cho trợ lý AI và mua sắm hội thoại.
Mô hình cũ thường phụ thuộc vào API tùy chỉnh và các tích hợp đơn lẻ, khiến việc mở rộng trên nhiều nền tảng trở nên chậm và khó khăn. UCP ra đời để giải quyết điều đó bằng cách cung cấp cho doanh nghiệp, tác nhân và nền tảng một cách giao tiếp chung.
Khi ngày càng nhiều người bắt đầu mua sắm qua công cụ AI, thương mại cần hỗ trợ các hành động trực tiếp như khám phá sản phẩm, thanh toán, giảm giá và cập nhật đơn hàng trong cùng một cuộc hội thoại.
UCP được thiết kế cho phong cách mua sắm mới này, nơi trải nghiệm mang tính tương tác hơn và diễn ra trên nhiều bề mặt số khác nhau.
Nó cũng cần thiết vì hệ sinh thái thương mại ngày nay bị phân mảnh. Các doanh nghiệp, nhà cung cấp thanh toán và nền tảng khác nhau thường dùng hệ thống khác nhau. UCP giúp đưa họ lại với nhau qua một tiêu chuẩn chung, để có thể hợp tác mà không phải xây đi xây lại cùng một tích hợp hết lần này đến lần khác.
Nói đơn giản, UCP cần thiết vì các công cụ thương mại cũ không được xây cho mua sắm do AI dẫn dắt. Nó mang lại nền tảng hiện đại, linh hoạt hơn cho cách mọi người sẽ khám phá và mua sản phẩm trong tương lai.
Tìm hiểu kiến trúc Universal Commerce Protocol
Universal Commerce Protocol (UCP) là một hệ thống mô-đun cho thương mại do tác nhân điều phối. Nó cung cấp cho doanh nghiệp, tác nhân AI và nhà cung cấp thanh toán một cách chung để xử lý hành trình mua sắm, từ khám phá đến thanh toán và hơn thế nữa.
Thay vì xây các tích hợp tùy chỉnh riêng cho từng nền tảng, UCP cho phép doanh nghiệp công bố những gì mình hỗ trợ để tác nhân có thể đọc thông tin và đi theo một luồng chuẩn.
UCP được thiết kế theo hướng mô-đun và có thể mở rộng, hỗ trợ các phương thức truyền tải như REST, MCP và A2A, và làm việc với bộ xử lý thanh toán để doanh nghiệp có thể dễ dàng tiếp tục dùng thiết lập thanh toán sẵn có.
1. Doanh nghiệp công bố hồ sơ khám phá
Một doanh nghiệp hỗ trợ UCP sẽ phơi bày một hồ sơ tại
/.well-known/ucp. Hồ sơ này cho nền tảng và tác nhân biết doanh nghiệp hỗ trợ những gì trước khi bất kỳ giao dịch nào bắt đầu, bao gồm các khả năng và endpoint khả dụng.2. Tác nhân đọc các khả năng được hỗ trợ
Sau khi khám phá, tác nhân kiểm tra doanh nghiệp cung cấp dịch vụ và khả năng nào. Đợt ra mắt đầu tiên của UCP tập trung vào các khả năng cốt lõi như Thanh toán (Checkout), Liên kết danh tính (Identity Linking) và Quản lý đơn hàng (Order Management), đóng vai trò là các khối xây dựng chính của giao thức.
3. Phần mở rộng bổ sung tính năng
UCP giữ luồng lõi đơn giản, nhưng doanh nghiệp có thể thêm các phần mở rộng tùy chọn khi cần. Các phần mở rộng này xây dựng dựa trên khả năng cốt lõi và cho phép doanh nghiệp hỗ trợ tính năng phong phú hơn mà không phải thay đổi toàn bộ giao thức.
4. Luồng chạy qua một phương thức truyền tải được hỗ trợ
Khi tác nhân biết những gì được hỗ trợ, nó có thể tương tác với doanh nghiệp bằng một phương thức truyền tải như REST, MCP hoặc A2A. Điều này giúp cùng một logic thương mại dễ dùng hơn trên API, công cụ AI và hệ thống tác nhân–tác nhân.
5. Thanh toán được xử lý qua bộ xử lý thanh toán
UCP tách luồng thương mại khỏi lớp thanh toán. Doanh nghiệp có thể khai báo các bộ xử lý thanh toán được hỗ trợ, và giao thức được thiết kế để nhà bán có thể tiếp tục dùng các tích hợp thanh toán hiện tại thay vì xây lại từ đầu.
6. Thanh toán an toàn do tác nhân thực hiện có thể dùng AP2
UCP tương thích với Agent Payments Protocol (AP2), bổ sung một lớp an toàn cho thanh toán do tác nhân thực hiện. Điều này giúp hỗ trợ ủy quyền an toàn hơn khi tác nhân AI hành động thay mặt người dùng.
Hướng dẫn Universal Commerce Protocol từ đầu đến cuối
Hướng dẫn này trình bày một luồng Universal Commerce Protocol hoàn chỉnh bằng bản triển khai tham chiếu Python. Bạn sẽ thiết lập máy chủ mẫu của nhà bán, nạp danh mục cửa hàng hoa demo, khám phá các khả năng của doanh nghiệp, tạo phiên thanh toán, áp dụng mã giảm giá và sau đó dừng máy chủ.
Bước 1: Thiết lập máy chủ doanh nghiệp
Ở bước này, bạn sẽ cài đặt
uvđể quản lý phụ thuộc Python, sau đó clone cả UCP Python SDK và kho máy chủ mẫu. README của máy chủ mẫu làm theo mẫu thiết lập tương tự và lưu ý rằng đường dẫn tương đối đến SDK là quan trọng cho các ví dụ.Vì hệ điều hành của chúng ta là Linux, chúng ta sẽ dùng lệnh sau để cài đặt
uv.uvlà trình quản lý gói và môi trường Python nhanh, tin cậy. Nó có mục đích tương tự các công cụ như Anaconda, nhưng nhẹ và nhanh hơn nhiều.Sau khi cài đặt xong, tải lại phiên terminal của bạn để lệnh uv khả dụng trong shell hiện tại.
Tiếp theo, tạo một thư mục mới tên là sdk. Thư mục này sẽ lưu Universal Commerce Protocol Python SDK khi chúng ta clone từ kho GitHub.
Bây giờ chuyển vào thư mục
sdk/python, nơi kho SDK đã được clone.Khi đã ở trong thư mục SDK, cài đặt tất cả phụ thuộc Python cần thiết cho SDK bằng
uv sync.Sau khi cài đặt phụ thuộc, quay lại thư mục làm việc trước đó.
Giờ hãy clone kho samples, nơi chứa máy chủ nhà bán tham chiếu bằng Python được dùng trong phần hướng dẫn này.
Tiếp theo, chuyển vào ví dụ máy chủ Python trong kho samples.
Cuối cùng, cài đặt mọi phụ thuộc Python cần thiết để chạy máy chủ mẫu.
Đến đây, máy chủ doanh nghiệp mẫu đã sẵn sàng trong không gian làm việc của bạn. Máy chủ này đã triển khai các khả năng mua sắm cốt lõi do UCP định nghĩa.
Bước 2: Tạo cơ sở dữ liệu sản phẩm mẫu
Ở bước này, bạn sẽ tạo một cửa hàng demo cục bộ dựa trên SQLite cho doanh nghiệp mẫu. Doanh nghiệp mẫu trong hướng dẫn này là một cửa hàng hoa, và lệnh này sẽ nạp danh mục sản phẩm ví dụ và cơ sở dữ liệu giao dịch mà máy chủ sẽ dùng.
Trước tiên, tạo một thư mục tạm thời để lưu các tệp cơ sở dữ liệu.
Tiếp theo, chạy script nhập liệu để tạo và nạp cơ sở dữ liệu sản phẩm và giao dịch.
Lệnh này thực hiện những việc sau:
--products_db_pathtạo cơ sở dữ liệu danh mục sản phẩm.--transactions_db_pathtạo cơ sở dữ liệu giao dịch dùng cho trạng thái checkout.--data_dir=../test_data/flower_shoptrỏ đến dữ liệu cửa hàng hoa mẫu đi kèm trong kho.Sau bước này, dữ liệu cửa hàng mẫu cục bộ của bạn đã sẵn sàng và máy chủ có thể sử dụng.
Bước 3: Khởi động máy chủ doanh nghiệp
Ở bước này, bạn sẽ khởi động máy chủ doanh nghiệp UCP mẫu. Máy chủ này sẽ dùng cơ sở dữ liệu sản phẩm và giao dịch bạn đã tạo ở bước trước và phơi bày các API mua sắm UCP trên cổng
8182.Chạy lệnh sau để khởi động máy chủ ở chế độ nền.
Lệnh này thực hiện những việc sau:
uv run server.pykhởi động máy chủ Python mẫu.--products_db_pathkết nối máy chủ với cơ sở dữ liệu sản phẩm.--transactions_db_pathkết nối máy chủ với cơ sở dữ liệu giao dịch.--port=8182yêu cầu máy chủ chạy trên cổng 8182.SERVER_PID=$!lưu ID tiến trình để dừng máy chủ sau này.Bước 4: Khám phá các khả năng của doanh nghiệp
Ở bước này, bạn sẽ truy vấn endpoint khám phá của UCP. Mọi doanh nghiệp hỗ trợ UCP đều công bố tài liệu khám phá tại
/.well-known/ucp, cho phép tác nhân hiểu doanh nghiệp hỗ trợ gì trước khi gửi bất kỳ yêu cầu nào.Trước tiên, lưu URL máy chủ vào một biến để các lệnh sau dễ đọc hơn.
Bây giờ, lấy tài liệu khám phá UCP từ máy chủ doanh nghiệp.
Phản hồi này cho tác nhân biết:
Bước khám phá này quan trọng vì loại bỏ nhu cầu tích hợp tùy chỉnh hard-code. Tác nhân có thể kiểm tra máy chủ trước rồi quyết định cách tương tác.
Bước 5: Tạo phiên thanh toán (checkout session)
Ở bước này, bạn sẽ tạo một phiên thanh toán mới bằng khả năng checkout của UCP. Đây là lúc tác nhân gửi sản phẩm đã chọn, thông tin người mua và cấu trúc thanh toán đến máy chủ doanh nghiệp.
Trước khi gửi yêu cầu, hãy tạo các header bắt buộc. Các header này hỗ trợ truy vết yêu cầu, đảm bảo idempotent và xác thực chữ ký.
Cụ thể:
REQUEST_IDtạo một định danh duy nhất cho yêu cầu.IDEMPOTENCY_KEYđảm bảo cùng một yêu cầu sẽ không bị xử lý hai lần nếu được gửi lại.REQUEST_SIGNATUREcung cấp header chữ ký bắt buộc. Trong môi trường demo cục bộ, có thể dùng"dev"nếu không bật xác thực chữ ký nghiêm ngặt.Bây giờ gửi yêu cầu checkout đến máy chủ.
Yêu cầu này bao gồm:
line_itemsđể xác định người mua muốn mua gì,item.idđể định danh sản phẩm,item.titleđể cung cấp tên dễ đọc,quantityđể chỉ rõ số lượng mua,buyerđể bao gồm thông tin khách hàng,currencyđể xác định loại tiền tệ thanh toán,paymentđể cung cấp cấu trúc thanh toán bắt buộc.Phản hồi sẽ trả về đối tượng phiên checkout. Bao gồm ID checkout mới, ID dòng hàng, tổng tiền, thông tin người mua và trạng thái checkout hiện tại.
Bước 6: Áp dụng giảm giá bằng UCP
Ở bước này, bạn sẽ cập nhật phiên checkout hiện có và áp dụng mã giảm giá. Giảm giá trong UCP được triển khai như một phần mở rộng của khả năng checkout, vì vậy mã giảm giá sẽ được thêm vào trong yêu cầu cập nhật checkout.
Đầu tiên, lưu ID checkout thật và ID dòng hàng được trả về từ phản hồi checkout trước đó.
Tiếp theo, tạo mới request ID và idempotency key cho yêu cầu cập nhật này.
Bây giờ gửi yêu cầu cập nhật checkout kèm mã giảm giá.
Yêu cầu này thực hiện những việc sau:
PUT,discounts,10OFF.Phản hồi sẽ trả về đối tượng checkout đã cập nhật với:
Mã giảm giá hợp lệ; bạn sẽ thấy giá thay đổi trong phản hồi.
Bước 7: Tắt máy chủ
Ở bước cuối cùng này, bạn sẽ dừng máy chủ doanh nghiệp mẫu đã khởi động trước đó. Vì bạn đã lưu ID tiến trình khi khởi động máy chủ, bạn có thể tắt nó dễ dàng chỉ với một lệnh.
Chạy lệnh sau để dừng máy chủ.
Từ đầu đến cuối, bạn đã xây dựng và kiểm thử thành công một luồng UCP end-to-end trên máy cục bộ của mình.
Bạn đã:
uv,Nói một cách đơn giản, bạn đã thiết lập một doanh nghiệp hỗ trợ UCP hoạt động, kết nối tới đó như một tác nhân, tạo quy trình thanh toán và kiểm thử cách UCP xử lý cập nhật như giảm giá. Điều này mang lại cho bạn một ví dụ cơ bản đầy đủ về cách doanh nghiệp và tác nhân có thể tương tác bằng Universal Commerce Protocol.
Kết luận
Universal Commerce Protocol mang đến cho ngành một nền tảng chung cho thương mại do AI dẫn dắt. Nó tạo ra cách chuẩn để doanh nghiệp, tác nhân AI và hệ thống thanh toán giao tiếp, giúp hỗ trợ khám phá, thanh toán, cập nhật và chi trả dễ dàng hơn mà không phải xây tích hợp tùy chỉnh cho từng nền tảng mới.
Trong hướng dẫn này, bạn đã biết UCP là gì, vì sao quan trọng, kiến trúc hoạt động ra sao, và cách chạy một ví dụ cục bộ hoàn chỉnh từ đầu đến cuối. Bằng việc thiết lập máy chủ mẫu, khám phá các khả năng, tạo phiên checkout và áp dụng giảm giá, bạn đã thấy cách UCP biến thương mại thành một quy trình có cấu trúc, thân thiện với tác nhân.
Cơ hội lớn nhất của UCP là rõ ràng: nó có thể giảm phân mảnh và làm cho thương mại tương tác liên vận hơn trong bối cảnh mua sắm ngày càng diễn ra thông qua trợ lý AI và giao diện hội thoại.
Tuy nhiên, thách thức thực sự sẽ là mức độ chấp nhận. Doanh nghiệp có thể vẫn chọn API tùy chỉnh, tích hợp dựa trên REST hiện có, công cụ dựa trên MCP hoặc các luồng tác nhân khác mà họ đang dùng. Để UCP thành công, cần có sự ủng hộ mạnh mẽ từ hệ sinh thái gồm nhà bán, nền tảng, nhà phát triển và nhà cung cấp thanh toán.