MCP Tools Reference: paydeveloper.googleapis.com

Công cụ: create_google_pay_integration

Tạo một chế độ tích hợp Google Pay cho một người bán cụ thể. Để thực hiện thao tác này, người dùng phải chấp nhận Điều khoản dịch vụ của Business Console và Điều khoản dịch vụ của Google Pay API. Bạn không cần phải kiểm tra trước những điều này. Nếu chưa được chấp nhận, lệnh gọi công cụ sẽ không thành công và thông báo lỗi sẽ chứa các URL cụ thể của Điều khoản dịch vụ cần được chấp nhận. Nếu điều này xảy ra, hãy cho người dùng thấy các URL để họ chấp nhận và hướng dẫn họ thử lại sau khi chấp nhận. Hãy làm theo trình tự này để tương tác với người dùng TRƯỚC KHI gọi công cụ: 1. Trước tiên, hãy yêu cầu người dùng cung cấp mục tích hợp (Hiện tại, chỉ hỗ trợ tích hợp Web). – Yêu cầu cung cấp URL của trang web. # – Nếu mục tích hợp là Tích hợp ứng dụng, hãy yêu cầu tên gói ứng dụng Android. 2. Sau đó, hãy hỏi người dùng về loại tích hợp: – Yêu cầu người dùng chọn Cổng nếu họ sử dụng một trong những Nhà cung cấp dịch vụ thanh toán (PSP) mà chúng tôi hỗ trợ (https://developers.google.com/pay/api#participating-processors), nếu không, hãy chọn Trực tiếp. 3. Đối với TẤT CẢ các loại tích hợp (Trực tiếp hoặc Cổng): – Yêu cầu người dùng tải ảnh chụp màn hình (tối đa 1 MB) về quy trình mua được tích hợp với API Google Pay lên. Quy trình mua hàng của họ phải được xem xét và phê duyệt thì họ mới được cấp quyền truy cập vào kênh phát hành công khai. Ví dụ: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together. – Bạn PHẢI yêu cầu người dùng cung cấp 5 ảnh chụp màn hình hỗ trợ. Yêu cầu họ cung cấp từng thông tin MỘT để đảm bảo việc liên kết chính xác. CHỈ sử dụng nội dung mô tả enum thân thiện với người dùng khi đặt câu hỏi. 4. Nếu loại tích hợp là Trực tiếp: – BẠN CŨNG PHẢI yêu cầu người dùng cung cấp chứng nhận PCI ở định dạng PDF. CHỈ sử dụng nội dung mô tả enum thân thiện với người dùng khi đặt câu hỏi. 5. Đối với mỗi tệp được cung cấp, hãy yêu cầu người dùng cung cấp đường dẫn hoặc tên tài liệu nếu tệp đó nằm trong thư mục hiện tại. Liên kết yêu cầu này với DocumentType chính xác và đặt trường tên thành một tên mô tả (ví dụ: item_selection.png hoặc pci_attestation.pdf). Đừng gọi công cụ này cho đến khi bạn đã cố gắng thu thập các tài liệu bắt buộc cho loại tích hợp đã chọn.

Mẫu sau đây minh hoạ cách sử dụng curl để gọi công cụ MCP create_google_pay_integration.

Yêu cầu Curl 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "create_google_pay_integration",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Giản đồ đầu vào

Thông báo yêu cầu cho CreateGooglePayIntegration.

CreateGooglePayIntegrationRequest

Biểu diễn dưới dạng JSON 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
Trường
merchantId

string

Bắt buộc. Mã người bán của người bán mà bạn muốn thêm tính năng tích hợp Google Pay.
googlePayIntegration

object (GooglePayIntegration)

Bắt buộc. Liên kết tích hợp Google Pay cần tạo.

GooglePayIntegration

Biểu diễn dưới dạng JSON 
{
  "integrationState": enum (IntegrationState),
  "createTime": string,
  "updateTime": string,
  "integrationType": enum (IntegrationType),
  "integrationDocuments": [
    {
      object (IntegrationDocument)
    }
  ],

  // Union field item can be only one of the following:
  "webDomain": string,
  "androidAppPackage": string
  // End of list of possible types for union field item.
}
Trường
integrationState

enum (IntegrationState)

Chỉ có đầu ra. Trạng thái tích hợp Google Pay của người bán.
createTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm tạo tài nguyên tích hợp.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Chỉ có đầu ra. Thời điểm gần đây nhất tài nguyên tích hợp được cập nhật.

Hãy dùng RFC 3339, trong đó dữ liệu đầu ra được tạo sẽ luôn được chuẩn hoá theo múi giờ và sử dụng 0, 3, 6 hoặc 9 chữ số thập phân. Các khoảng lệch khác ngoài "Z" cũng được chấp nhận. Ví dụ: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" hoặc "2014-10-02T15:01:23+05:30".
integrationType

enum (IntegrationType)

Bắt buộc. Loại tích hợp của chế độ tích hợp Google Pay.
integrationDocuments[]

object (IntegrationDocument)

Bắt buộc. Chỉ có đầu vào. Tài liệu tích hợp của tính năng tích hợp Google Pay.
Trường nhóm item. Mục tích hợp. Bạn phải đặt một trong những giá trị này. item chỉ có thể là một trong những trạng thái sau:
webDomain

string

Miền trên web của người bán.
androidAppPackage

string

Tên gói ứng dụng Android của người bán.

Dấu thời gian

Biểu diễn dưới dạng JSON 
{
  "seconds": string,
  "nanos": integer
}
Trường
seconds

string (int64 format)

Biểu thị số giây của thời gian UTC kể từ thời gian bắt đầu của hệ thống Unix là 1970-01-01T00:00:00Z. Phải nằm trong khoảng từ -62135596800 đến 253402300799 (tương ứng với 0001-01-01T00:00:00Z đến 9999-12-31T23:59:59Z).
nanos

integer

Phân số không âm của một giây ở độ phân giải nano giây. Trường này là phần nano giây của khoảng thời gian, chứ không phải là một lựa chọn thay thế cho giây. Giá trị giây âm có phân số vẫn phải có giá trị nano giây không âm để đếm thời gian. Phải nằm trong khoảng từ 0 đến 999.999.999.

IntegrationDocument

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
Trường
name

string

Bắt buộc. Tên của tài liệu.
data

string (bytes format)

Bắt buộc. Dữ liệu của chứng từ.

Một chuỗi được mã hoá base64.
documentType

enum (DocumentType)

Bắt buộc. Loại tài liệu.
mimeType

enum (MimeType)

Bắt buộc. Loại MIME của tài liệu.

IntegrationState

Trạng thái tích hợp Google Pay của một miền web hoặc ứng dụng Android của người bán.

Enum
INTEGRATION_STATE_UNSPECIFIED Trạng thái tích hợp chưa được chỉ định.
NOT_STARTED Trạng thái này là khi ứng dụng Android được liên kết với nhà phát triển (trên Cửa hàng Play) và nhà phát triển chưa bắt đầu quy trình tích hợp nào cho ứng dụng đó.
INCOMPLETE Nhà phát triển chưa gửi yêu cầu xem xét việc tích hợp và việc tích hợp này cũng chưa hoàn tất (ví dụ: thiếu tài liệu hỗ trợ).
READY_FOR_REVIEW Nhà phát triển chưa gửi yêu cầu xem xét việc tích hợp nhưng đã sẵn sàng để xem xét (ví dụ: đã tải tài liệu hỗ trợ lên).
UNDER_REVIEW Yêu cầu bật tính năng tích hợp đang chờ quản trị viên xem xét.
NEED_INFO Quá trình tích hợp cần thêm thông tin của quản trị viên gTech trong quá trình xem xét.
ACTIVE Tiện ích tích hợp hiện đang hoạt động.
DELETED Người bán đã xoá chế độ tích hợp.
REJECTED Yêu cầu tích hợp bị từ chối.

IntegrationType

Loại tích hợp của một chế độ tích hợp Google Pay.

Enum
INTEGRATION_TYPE_UNSPECIFIED Chưa xác định loại tích hợp.
DIRECT_INTEGRATION Loại tích hợp là tích hợp trực tiếp.
PAYMENT_SERVICE_PROVIDER Loại tích hợp là nhà cung cấp dịch vụ thanh toán.

DocumentType

Loại tài liệu.

Enum
DOCUMENT_TYPE_UNSPECIFIED Loại tài liệu chưa được chỉ định.
ITEM_SELECTION_SCREENSHOT Khi người dùng đang duyệt xem một mặt hàng hoặc dịch vụ.
PRE_PURCHASE_SCREENSHOT Khi người dùng đã sẵn sàng mua hàng.
PAYMENT_METHOD_SCREENSHOT Khi người dùng chọn Google Pay làm phương thức thanh toán.
PAYMENT_INFO_SCREENSHOT Khi người dùng thấy thông tin thanh toán mà họ đã lưu vào Google Pay. Mẹo: Android sẽ không cho phép bạn chụp ảnh màn hình này, vì vậy, hãy chụp ảnh màn hình bằng một thiết bị khác.
POST_PURCHASE_SCREENSHOT Khi người dùng đã thực hiện giao dịch mua thành công.
PCI_ATTESTATION_DOCUMENT Tài liệu chứng thực PCI ở định dạng PDF.

MimeType

Loại MIME của một tài liệu.

Enum
MIME_TYPE_UNSPECIFIED Loại mime chưa được chỉ định.
JPEG Loại MIME là JPEG.
PNG Loại MIME là PNG.
WEBP Loại mime là WEBP.
PDF Loại MIME là PDF.

Giản đồ đầu ra

Thông báo phản hồi cho CreateGooglePayIntegration.

CreateGooglePayIntegrationResponse

Biểu diễn dưới dạng JSON 
{
  "integrationState": enum (IntegrationState)
}
Trường
integrationState

enum (IntegrationState)

Trạng thái tích hợp của chế độ tích hợp Google Pay.

IntegrationState

Trạng thái tích hợp Google Pay của một miền web hoặc ứng dụng Android của người bán.

Enum
INTEGRATION_STATE_UNSPECIFIED Trạng thái tích hợp chưa được chỉ định.
NOT_STARTED Trạng thái này là khi ứng dụng Android được liên kết với nhà phát triển (trên Cửa hàng Play) và nhà phát triển chưa bắt đầu quy trình tích hợp nào cho ứng dụng đó.
INCOMPLETE Nhà phát triển chưa gửi yêu cầu xem xét việc tích hợp và việc tích hợp này cũng chưa hoàn tất (ví dụ: thiếu tài liệu hỗ trợ).
READY_FOR_REVIEW Nhà phát triển chưa gửi yêu cầu xem xét việc tích hợp nhưng đã sẵn sàng để xem xét (ví dụ: đã tải tài liệu hỗ trợ lên).
UNDER_REVIEW Yêu cầu bật tính năng tích hợp đang chờ quản trị viên xem xét.
NEED_INFO Quá trình tích hợp cần thêm thông tin của quản trị viên gTech trong quá trình xem xét.
ACTIVE Tiện ích tích hợp hiện đang hoạt động.
DELETED Người bán đã xoá chế độ tích hợp.
REJECTED Yêu cầu tích hợp bị từ chối.

Chú giải công cụ

Gợi ý mang tính huỷ diệt: ❌ | Gợi ý mang tính luỹ đẳng: ❌ | Gợi ý chỉ đọc: ❌ | Gợi ý về thế giới mở: ❌