Quy cách trình xử lý thanh toán Google Pay

Tên trình xử lý: com.google.pay
Phiên bản: 2026-01-11

1. Giới thiệu

Trình xử lý com.google.pay cho phép các doanh nghiệp cung cấp Google Pay dưới dạng một lựa chọn thanh toán nhanh thông qua các nền tảng tương thích với UCP. Google Pay API giúp thanh toán nhanh chóng bằng cách cho phép người dùng truy cập vào các phương thức thanh toán được lưu trữ trong Tài khoản Google của họ.

Trình xử lý này cho phép mô hình tích hợp không cần giao diện người dùng, trong đó các doanh nghiệp cung cấp cấu hình Google Pay (chẳng hạn như các mạng thẻ được phép và các thông số cổng), đồng thời các nền tảng xử lý hoạt động tương tác phía máy khách với Google Pay API để tạo mã thông báo thanh toán an toàn.

1.1 Lợi ích chính

Cấu hình chung: Doanh nghiệp định cấu hình Google Pay một lần bằng JSON tiêu chuẩn, cho phép mọi nền tảng được uỷ quyền hiển thị giao diện thanh toán mà không cần mã giao diện người dùng tuỳ chỉnh.
Giao diện người dùng tách biệt: Các nền tảng xử lý sự phức tạp của việc tích hợp API hoặc SDK JavaScript của Google Pay, trong khi các doanh nghiệp sử dụng mã thông báo nhận được.
Mã hoá bằng mã thông báo an toàn: Tận dụng tính năng mã hoá bằng mã thông báo tích hợp của Google để chuyển trực tiếp thông tin đăng nhập đã mã hoá cho Nhà cung cấp dịch vụ thanh toán (PSP) của doanh nghiệp.

2. Tích hợp doanh nghiệp

2.1 Yêu cầu

Trước khi quảng cáo Google Pay thông qua UCP, các doanh nghiệp phải:

Lấy mã nhận dạng người bán trên Google Pay: Bắt buộc để xử lý trong môi trường PRODUCTION (đăng ký trong Google Pay & Wallet Console).
Xác minh sự hỗ trợ của PSP: Đảm bảo rằng Nhà cung cấp dịch vụ thanh toán (PSP) của bạn có trong danh sách các đơn vị xử lý và cổng được hỗ trợ để mã hoá bằng mã thông báo Google Pay.

2.2 Cấu hình trình xử lý

Các doanh nghiệp quảng cáo việc hỗ trợ Google Pay bằng cách thêm trình xử lý vào mảng trình xử lý thanh toán của họ. Cấu hình này tuân thủ nghiêm ngặt cấu trúc cần thiết để khởi chạy API Google Pay.

Giản đồ cấu hình 2.2.1

Đối tượng cấu hình xác định môi trường, danh tính doanh nghiệp và các phương thức thanh toán được phép.

Phương thức thanh toán bằng Google Pay

Dựa trên PaymentMethod của Google Pay.

Quy cách mã hoá

Dựa trên TokenizationSpecification của Google Pay.

2.2.2 Ví dụ về khai báo trình xử lý

{
  "payment": {
    "handlers": [
      {
        "id": "8c9202bd-63cc-4241-8d24-d57ce69ea31c",
        "name": "com.google.pay",
        "version": "2026-01-11",
        "spec": "https://pay.google.com/gp/p/ucp/2026-01-11/",
        "config_schema": "https://pay.google.com/gp/p/ucp/2026-01-11/schemas/config.json",
        "instrument_schemas": [
          "https://pay.google.com/gp/p/ucp/2026-01-11/schemas/card_payment_instrument.json"
        ],
        "config": {
          "api_version": 2,
          "api_version_minor": 0,
          "environment": "TEST",
          "merchant_info": {
            "merchant_name": "Example Merchant",
            "merchant_id": "01234567890123456789",
            "merchant_origin": "checkout.merchant.com"
          },
          "allowed_payment_methods": [
            {
              "type": "CARD",
              "parameters": {
                "allowed_auth_methods": ["PAN_ONLY"],
                "allowed_card_networks": ["VISA", "MASTERCARD"]
              },
              "tokenization_specification": {
                "type": "PAYMENT_GATEWAY",
                "parameters": {
                  "gateway": "example",
                  "gatewayMerchantId": "exampleGatewayMerchantId"
                }
              }
            }
          ]
        }
      }
    ]
  }
}

2.3 Thực thể

2.3.1 Giản đồ thiết bị

Công cụ Google Pay (card_payment_instrument) mở rộng Card Payment Instrument cơ bản. Thẻ này kế thừa các trường hiển thị chuẩn (chẳng hạn như brand và last_digits) để đảm bảo việc kết xuất biên nhận nhất quán, đồng thời tinh chỉnh trường credential để mang tải trọng mã hoá cụ thể của Google Pay.

Hành vi của nền tảng: Nền tảng này chịu trách nhiệm lập bản đồ từ phản hồi Google Pay PaymentMethodData vào cấu trúc này trước khi gửi cho doanh nghiệp.

Tên	Loại	Bắt buộc	Mô tả
id	chuỗi	Có	Giá trị nhận dạng duy nhất của phương thức thanh toán này, do nền tảng chỉ định.
handler_id	chuỗi	Có	Giá trị nhận dạng cho trình xử lý Google Pay.
loại	chuỗi	Có	Hằng số = `card`. Cho biết công cụ này hoạt động như một thẻ (kế thừa các trường hiển thị thẻ).
thương hiệu	chuỗi	Có	Mạng của thẻ (ví dụ: `visa`, `mastercard`). Được liên kết từ `info.cardNetwork` của Google Pay.
last_digits	chuỗi	Có	4 chữ số cuối của thẻ. Được liên kết từ `info.cardDetails` của Google Pay.
rich_text_description	chuỗi	Không	Nội dung mô tả văn bản đa dạng thức (không bắt buộc) của thẻ (ví dụ: "Thẻ Visa có 4 số cuối là 1234, hết hạn vào tháng 12 năm 2025").
rich_card_art	chuỗi (uri)	Không	Một URI không bắt buộc đến một hình ảnh đa dạng thức đại diện cho thẻ (ví dụ: hình ảnh thẻ của tổ chức phát hành).
billing_address	Địa chỉ bưu chính	Không	Địa chỉ thanh toán được liên kết với thẻ.
giấy chứng nhận	Tải trọng thông tin xác thực	Không	Dữ liệu mã hoá an toàn do Google Pay trả về.

Tải trọng thông tin xác thực

Đối tượng này đóng vai trò là credential cho công cụ. Nó liên kết trực tiếp với Dữ liệu mã hoá kỹ thuật số của Google Pay.

Địa chỉ bưu chính

Đối tượng này đóng vai trò là trường address. Thuộc tính này liên kết trực tiếp đến PostalAddress.

3. Tích hợp nền tảng

3.1 Yêu cầu

Trước khi xử lý các khoản thanh toán com.google.pay, các nền tảng phải:

Có khả năng tải API Google Pay cho Web (hoặc API tương đương cho Android).
Tuân thủ Nguyên tắc sử dụng thương hiệu của Google Pay khi hiển thị nút thanh toán.

3.2 Giao thức thanh toán

Các nền tảng PHẢI tuân theo quy trình này để xử lý trình xử lý:

Bước 1: Khám phá và định cấu hình

Nền tảng này khởi tạo ứng dụng để quản lý vòng đời API.

Tài liệu tham khảo: PaymentsClient

Bước 2: Kiểm tra trạng thái Sẵn sàng thanh toán

Nền tảng này sẽ kiểm tra xem người dùng có thể thanh toán bằng các phương thức thanh toán đã chỉ định hay không trước khi hiển thị nút.

Tham khảo: isReadyToPay

Bước 3: Tạo yêu cầu thanh toán

Nền tảng này tập hợp đối tượng yêu cầu dữ liệu thanh toán, bao gồm cấu hình người bán, phương thức thanh toán và thông tin giao dịch (giá và đơn vị tiền tệ).

Tài liệu tham khảo: PaymentDataRequest

Bước 4: Gọi Tương tác của người dùng

Nền tảng này kích hoạt việc hiển thị trang thanh toán khi người dùng tương tác với nút thanh toán.

Tài liệu tham khảo: loadPaymentData

Bước 5: Hoàn tất quy trình thanh toán

Sau khi người dùng tương tác thành công, Google Pay API sẽ trả về một đối tượng PaymentInstrument trong khoá payment_data. Nền tảng này liên kết phản hồi này với giản đồ card_payment_instrument và gửi yêu cầu hoàn tất quy trình thanh toán.

POST /checkout-sessions/{checkout_id}/complete

{
  "payment_data": {
    "id": "pm_1234567890abc",
    "handler_id": "8c9202bd-63cc-4241-8d24-d57ce69ea31c",
    "type": "card",
    "brand": "visa",
    "last_digits": "4242",
    "billing_address": {
      "street_address": "123 Main Street",
      "extended_address": "Suite 400",
      "address_locality": "Charleston",
      "address_region": "SC",
      "postal_code": "29401",
      "address_country": "US",
      "first_name": "Jane",
      "last_name": "Smith"
    },
    "credential": {
      "type": "PAYMENT_GATEWAY",
      "token": "{\"signature\":\"...\",\"protocolVersion\":\"ECv2\"...}"
    }
  },
  "risk_signals": {
      ...
  }
}

4. Xử lý kinh doanh

Khi nhận được một công cụ thanh toán qua Google Pay, doanh nghiệp PHẢI:

Xác thực trình xử lý: Xác nhận handler_id tương ứng với trình xử lý Google Pay.
Trích xuất mã thông báo: Truy xuất chuỗi mã thông báo từ payment_data.credential.token.
Xử lý thanh toán: Truyền chuỗi mã thông báo và thông tin giao dịch đến điểm cuối của PSP.
- Lưu ý: Hầu hết các PSP đều có một trường cụ thể cho "Tải trọng Google Pay" hoặc "Mã thông báo mạng".
Phản hồi trả về: Phản hồi bằng trạng thái thanh toán cuối cùng (Thành công/Thất bại).

5. Lưu ý về bảo mật

5.1 Bảo mật mã thông báo

PAYMENT_GATEWAY: Khi sử dụng loại mã hoá này, mã thông báo sẽ được mã hoá riêng cho bên mã hoá. Bên trung gian không thể giải mã mã thông báo này và phải chuyển tiếp nguyên trạng mã thông báo đó đến bên mã hoá.
TRỰC TIẾP: Nếu sử dụng tính năng mã hoá DIRECT, doanh nghiệp sẽ nhận được dữ liệu thẻ đã mã hoá mà họ phải giải mã. Điều này làm tăng đáng kể phạm vi tuân thủ PCI DSS và thường không được khuyến khích trừ phi doanh nghiệp là Nhà cung cấp dịch vụ tuân thủ PCI Cấp 1.

5.2 Cách ly môi trường

Chế độ KIỂM THỬ: Trong môi trường TEST, Google Pay trả về mã thông báo giả. Bạn không thể tính phí cho những nội dung này.
Chế độ PRODUCTION: Sử dụng thẻ thật. Doanh nghiệp phải đảm bảo thông tin đăng nhập PSP trong config.allowed_payment_methods khớp với môi trường.

Thanh toán tích hợp (không bắt buộc)

Tiếp

Liên kết danh tính (không bắt buộc)

Quy cách trình xử lý thanh toán Google Pay Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.