Để cho phép người dùng thanh toán, bạn phải triển khai tính năng tích hợp thanh toán ngay trên nền tảng. Việc này bao gồm việc tạo một API REST tiêu chuẩn cho phép Google quản lý quy trình thanh toán theo phương thức lập trình bằng máy chủ của bạn. Phương thức này mang lại trải nghiệm liền mạch nhất cho người dùng. Ban đầu, Google sẽ hiển thị giao diện người dùng cho người mua, đồng thời có kế hoạch hỗ trợ nhiều trải nghiệm dựa trên tác nhân hơn trong tương lai.
Quy trình thanh toán
Tính năng tích hợp gốc yêu cầu bạn tạo một API RESTful mà Google có thể gọi để tạo và quản lý các phiên thanh toán.
Quy trình tổng thể như sau:
- Tạo phiên thanh toán: Người dùng và có thể là một Nhân viên đang trong một vòng lặp thêm các mặt hàng vào phiên.
- Bàn giao cho giao diện người dùng của Google: Sau khi người dùng quyết định thanh toán, Agent (nếu đã tương tác) sẽ chuyển quyền kiểm soát cho giao diện người dùng của Google (truyền dữ liệu phiên thanh toán)
- Thanh toán thủ công: Giờ đây, người dùng chỉ tương tác với giao diện người dùng của Google để điền thông tin nhạy cảm về việc thực hiện đơn đặt hàng và thông tin thanh toán rồi gửi đơn đặt hàng. Tác nhân không tham gia vào phần này, đảm bảo tính xác định.
- Hoàn tất và trả về: Giao diện người dùng của Google sẽ hiện trang "Cảm ơn" để xác nhận đơn đặt hàng. Nếu muốn, người dùng có thể được chuyển hướng trở lại Đại lý. Đại lý này có thể đã được thông báo về giao dịch mua đã hoàn tất.
Vòng đời trạng thái phiên thanh toán
Khi người dùng thực hiện quy trình thanh toán, bạn phải cập nhật status của phiên thanh toán để phản ánh trạng thái hiện tại của phiên đó. Phiên sẽ trải qua vòng đời sau đây:
incomplete: Trạng thái ban đầu khi một phiên được tạo. Điều này cho biết thông tin bắt buộc (chẳng hạn như phương thức vận chuyển, thuế hoặc thông tin chi tiết về người dùng) bị thiếu hoặc chưa được tính toán.ready_for_payment: Trạng thái cần sử dụng sau khi người dùng cập nhật địa chỉ giao hàng và bạn tính toán các lựa chọn giao hàng cũng như tổng số tiền, nhưng trước khi phương thức thanh toán được hoàn tất.ready_for_complete: Trạng thái cần sử dụng trong quá trình hoàn tất việc tạo đối tượng thanh toán, sau khi phương thức thanh toán được chọn và tất cả thông tin chi tiết về đơn đặt hàng đều được xác thực.completed: Trạng thái cuối cùng được trả về sau khi bạn xử lý thành công khoản thanh toán và đặt đơn hàng.canceled: Trạng thái được trả về nếu phiên thanh toán bị huỷ.error: Trạng thái được trả về nếu lỗi logic nghiệp vụ không thể khắc phục ngăn quá trình thanh toán. Trạng thái này có trong UCP phiên bản2026-04-08trở lên.
Quy trình thanh toán nhiều mặt hàng:
Google hiện hỗ trợ nhiều mục hàng riêng biệt trong một phiên thanh toán duy nhất. Quy trình chung như sau:
- Người dùng bắt đầu thanh toán từ một giao diện có bật UCP (ví dụ: bằng cách nhấp vào "Mua ngay" trên một sản phẩm).
- Lệnh gọi
POST /checkout-sessionsđược thực hiện, bao gồm tất cả các mục riêng biệt trong mảngline_items. Mảngline_itemssẽ chứa một đối tượng riêng biệt cho từng mặt hàng riêng biệt đang được thanh toán. - Người dùng có thể cập nhật phương thức thanh toán, thông tin chi tiết về việc thực hiện hoặc áp dụng chiết khấu bằng cách sử dụng các lệnh gọi
PUT /checkout-sessions/{id}. - Khi người dùng nhấp vào nút "Thanh toán bằng GPay", lệnh gọi
POST /checkout-sessions/{id}/completesẽ được thực hiện.
Xác thực
Để biết thông tin chi tiết về cách bảo mật các điểm cuối Native Checkout API, bao gồm cả các phương thức xác thực được hỗ trợ như khoá API và OAuth 2.0, hãy xem hướng dẫn Xác thực và bảo mật.
Công cụ dành cho nhà phát triển
Để hỗ trợ việc triển khai Native Checkout API, bạn có thể tìm thấy các tài nguyên sau trong kho lưu trữ Giao thức thương mại toàn cầu trên GitHub:
- Kho lưu trữ UCP trên GitHub: Khám phá kho lưu trữ chính để xem tài liệu, quy cách và tài nguyên cộng đồng toàn diện.
- SDK: Sử dụng Bộ phát triển phần mềm để đẩy nhanh quá trình tích hợp. Có các SDK theo ngôn ngữ cụ thể, bao gồm:
Kiểm thử mức độ tuân thủ: Xác thực các điểm cuối API của bạn theo quy cách UCP bằng cách sử dụng bộ kiểm thử mức độ tuân thủ
Điều này giúp đảm bảo việc triển khai của bạn đáp ứng các tiêu chuẩn và hành vi bắt buộc.
Bạn nên sử dụng những công cụ này để đơn giản hoá quy trình phát triển và kiểm thử.
Mục tiêu mức độ dịch vụ
Các mục tiêu mức độ dịch vụ (SLO) sau đây áp dụng cho các điểm cuối REST API của quy trình thanh toán gốc. Các doanh nghiệp tích hợp với Google phải đáp ứng những mục tiêu này về hiệu suất và khả năng cung cấp API.
| Điểm cuối | Phạm vi cung cấp | Độ trễ (Phân vị thứ 50) | Độ trễ (Phân vị thứ 95) |
|---|---|---|---|
POST /checkout-sessions (Tạo) |
>= 95% | <= 1 giây | <= 4 giây |
PUT /checkout-sessions/{id} (Cập nhật) |
>= 95% | <= 1 giây | <= 5 giây |
POST /checkout-sessions/{id}/complete (Hoàn tất) |
>= 95% | <= 6 giây | <= 10 giây |
Độ trễ ở phân vị thứ 50 cho biết ít nhất 50% yêu cầu dự kiến sẽ được hoàn thành trong khoảng thời gian này. Độ trễ ở phân vị thứ 95 cho biết rằng ít nhất 95% yêu cầu dự kiến sẽ được hoàn tất trong khoảng thời gian này.
Các bước tiếp theo
Xem tải trọng API thanh toán và thông tin chi tiết về việc triển khai kỹ thuật cho phiên bản UCP của bạn: