MCP Tools Reference: paydeveloper.googleapis.com

Công cụ: list_google_pay_integrations

Trả về trạng thái hiện tại và thông tin chi tiết về cấu hình cho tất cả các hoạt động tích hợp Google Pay được liên kết với một mã người bán cụ thể. API này cung cấp ý kiến phản hồi ngay lập tức về trạng thái tích hợp và việc xem xét tài liệu.

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

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": "list_google_pay_integrations",
    "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 liệt kê các dịch vụ tích hợp Google Pay cho một người bán cụ thể.

ListGooglePayIntegrationsRequest

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

string

Bắt buộc. Mã người bán để liệt kê các mối tích hợp.

Giản đồ đầu ra

Thông báo phản hồi để liệt kê các công cụ tích hợp Google Pay.

ListGooglePayIntegrationsResponse

Biểu diễn dưới dạng JSON 
{
  "googlePayIntegrations": [
    {
      object (GooglePayIntegration)
    }
  ]
}
Trường
googlePayIntegrations[]

object (GooglePayIntegration)

Các dịch vụ tích hợp Google Pay của người bán.

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.

Chú giải công cụ

Gợi ý phá hoại: ❌ | Gợi ý bất biến: ✅ | Gợi ý chỉ đọc: ✅ | Gợi ý thế giới mở: ❌