MCP Tools Reference: paydeveloper.googleapis.com

เครื่องมือ: create_google_pay_integration

สร้างการผสานรวม Google Pay สำหรับผู้ขายรายใดรายหนึ่ง การดำเนินการนี้กำหนดให้ผู้ใช้ต้องยอมรับข้อกำหนดในการให้บริการของ Business Console และข้อกำหนดในการให้บริการของ Google Pay API คุณไม่จำเป็นต้องตรวจสอบข้อผิดพลาดเหล่านี้ล่วงหน้า หากยังไม่ได้รับการยอมรับ การเรียกใช้เครื่องมือจะล้มเหลว และข้อความแสดงข้อผิดพลาดจะมี URL ของข้อกำหนดในการให้บริการที่เฉพาะเจาะจงซึ่งต้องได้รับการยอมรับ หากเกิดกรณีนี้ ให้แสดง URL แก่ผู้ใช้เพื่อให้ยอมรับ และแนะนำให้ผู้ใช้ลองอีกครั้งเมื่อยอมรับแล้ว ทำตามลำดับนี้เพื่อโต้ตอบกับผู้ใช้ก่อนเรียกใช้เครื่องมือ 1. ก่อนอื่น ให้ขอรายการการผสานรวมจากผู้ใช้ (ขณะนี้ระบบรองรับการผสานรวมบนเว็บเท่านั้น) - ขอ URL ของเว็บไซต์ # - หากรายการการผสานรวมเป็นการผสานรวมแอป ให้ขอชื่อแพ็กเกจแอป Android 2. จากนั้นสอบถามผู้ใช้เกี่ยวกับประเภทการผสานรวม - บอกให้ผู้ใช้เลือกเกตเวย์หากใช้ผู้ให้บริการชำระเงิน (PSP: https://developers.google.com/pay/api#participating-processors) ที่เรารองรับ หรือเลือก "โดยตรง" 3. สำหรับการผสานรวมทุกประเภท (โดยตรงหรือเกตเวย์) - บอกให้ผู้ใช้อัปโหลดภาพหน้าจอ (สูงสุด 1 MB) ของขั้นตอนการซื้อที่ผสานรวมกับ Google Pay API ขั้นตอนการซื้อต้องได้รับการตรวจสอบและอนุมัติก่อนที่ผู้ขายจะได้รับสิทธิ์เข้าถึงเวอร์ชันที่ใช้งานจริงอย่างเต็มรูปแบบ ตัวอย่าง: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together - คุณต้องขอให้ผู้ใช้ส่งภาพหน้าจอประกอบ 5 ภาพ ขอให้ลูกค้าส่งรูปภาพทีละรูปเพื่อให้แน่ใจว่ามีการจับคู่ที่ถูกต้อง โปรดใช้เฉพาะคำอธิบาย Enum ที่ใช้งานง่ายเมื่อถาม 4. หากประเภทการผสานรวมเป็น "โดยตรง" - คุณต้องขอให้ผู้ใช้ส่งเอกสารรับรอง PCI ในรูปแบบ PDF ด้วย ใช้เฉพาะคำอธิบาย Enum ที่ใช้งานง่ายเมื่อถาม 5. สำหรับไฟล์แต่ละไฟล์ที่ระบุ ให้ขอให้ผู้ใช้ระบุเส้นทางหรือชื่อเอกสารหากอยู่ในไดเรกทอรีปัจจุบัน แมปกับ DocumentType ที่ถูกต้องและตั้งค่าฟิลด์ชื่อเป็นชื่อที่สื่อความหมาย (เช่น item_selection.png หรือ pci_attestation.pdf) ในคำขอ อย่าเรียกใช้เครื่องมือนี้จนกว่าคุณจะพยายามรวบรวมเอกสารที่จำเป็นสำหรับประเภทการผสานรวมที่เลือก

ตัวอย่างต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ create_google_pay_integration MCP

คำขอ 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
}'

สคีมาอินพุต

ข้อความคำขอสำหรับ CreateGooglePayIntegration

CreateGooglePayIntegrationRequest

การแสดง JSON 
{
  "merchantId": string,
  "googlePayIntegration": {
    object (GooglePayIntegration)
  }
}
ช่อง
merchantId

string

ต้องระบุ รหัสผู้ขายของผู้ขายที่จะเพิ่มการผสานรวม Google Pay
googlePayIntegration

object (GooglePayIntegration)

ต้องระบุ การผสานรวม Google Pay ที่จะสร้าง

GooglePayIntegration

การแสดง 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.
}
ช่อง
integrationState

enum (IntegrationState)

เอาต์พุตเท่านั้น สถานะการผสานรวม Google Pay ของผู้ขาย
createTime

string (Timestamp format)

เอาต์พุตเท่านั้น เมื่อสร้างทรัพยากรการผสานรวม

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
updateTime

string (Timestamp format)

เอาต์พุตเท่านั้น เวลาที่อัปเดตทรัพยากรการผสานรวมครั้งล่าสุด

ใช้ RFC 3339 โดยเอาต์พุตที่สร้างขึ้นจะได้รับการแปลงเป็นรูปแบบ Z เสมอ และใช้ตัวเลขเศษส่วน 0, 3, 6 หรือ 9 หลัก นอกจากนี้ ระบบยังยอมรับออฟเซ็ตอื่นๆ นอกเหนือจาก "Z" ด้วย เช่น "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" หรือ "2014-10-02T15:01:23+05:30"
integrationType

enum (IntegrationType)

ต้องระบุ ประเภทการผสานรวมของการผสานรวม Google Pay
integrationDocuments[]

object (IntegrationDocument)

ต้องระบุ อินพุตเท่านั้น เอกสารการผสานรวมของการผสานรวม Google Pay
ฟิลด์ Union item รายการการผสานรวม ต้องตั้งค่าอย่างใดอย่างหนึ่ง item ต้องเป็นค่าใดค่าหนึ่งต่อไปนี้เท่านั้น
webDomain

string

โดเมนเว็บของผู้ขาย
androidAppPackage

string

ชื่อแพ็กเกจแอป Android ของผู้ขาย

การประทับเวลา

การแสดง JSON 
{
  "seconds": string,
  "nanos": integer
}
ช่อง
seconds

string (int64 format)

แสดงวินาทีของเวลา UTC ตั้งแต่ Epoch ของ Unix 1970-01-01T00:00:00Z ต้องอยู่ระหว่าง -62135596800 ถึง 253402300799 เท่านั้น (ซึ่งสอดคล้องกับ 0001-01-01T00:00:00Z ถึง 9999-12-31T23:59:59Z)
nanos

integer

เศษส่วนของวินาทีที่ไม่เป็นลบที่ความละเอียดระดับนาโนวินาที ฟิลด์นี้คือส่วนนาโนวินาทีของระยะเวลา ไม่ใช่ทางเลือกแทนวินาที ค่าวินาทีที่เป็นลบซึ่งมีเศษส่วนยังคงต้องมีค่านาโนที่เป็นค่าบวกซึ่งนับไปข้างหน้าตามเวลา ต้องอยู่ระหว่าง 0 ถึง 999,999,999 เท่านั้น

IntegrationDocument

การแสดง JSON 
{
  "name": string,
  "data": string,
  "documentType": enum (DocumentType),
  "mimeType": enum (MimeType)
}
ช่อง
name

string

ต้องระบุ ชื่อเอกสาร
data

string (bytes format)

ต้องระบุ ข้อมูลของเอกสาร

สตริงที่เข้ารหัส Base64
documentType

enum (DocumentType)

ต้องระบุ ประเภทของเอกสาร
mimeType

enum (MimeType)

ต้องระบุ ประเภท MIME ของเอกสาร

IntegrationState

สถานะการผสานรวม Google Pay ของโดเมนเว็บของผู้ขายหรือแอป Android

Enum
INTEGRATION_STATE_UNSPECIFIED ไม่ได้ระบุสถานะการผสานรวม
NOT_STARTED สถานะนี้ใช้ในกรณีที่แอป Android เชื่อมโยงกับนักพัฒนาแอป (ใน Play Store) และนักพัฒนาแอปยังไม่ได้เริ่มกระบวนการผสานรวมใดๆ สำหรับแอป
INCOMPLETE นักพัฒนาแอปยังไม่ได้ส่งการผสานรวมเพื่อรับการตรวจสอบ และการผสานรวมยังไม่สมบูรณ์ (เช่น ไม่มีเอกสารประกอบ)
READY_FOR_REVIEW นักพัฒนาแอปยังไม่ได้ส่งการผสานรวมให้ตรวจสอบ แต่พร้อมรับการตรวจสอบแล้ว (เช่น อัปโหลดเอกสารประกอบแล้ว)
UNDER_REVIEW คำขอเปิดใช้การผสานรวมอยู่ระหว่างรอการตรวจสอบโดยผู้ดูแลระบบ
NEED_INFO การผสานรวมต้องการข้อมูลเพิ่มเติมจากผู้ดูแลระบบ gTech ระหว่างการตรวจสอบ
ACTIVE การผสานรวมทำงานอยู่ในขณะนี้
DELETED ผู้ขายลบการผสานรวม
REJECTED การผสานรวมถูกปฏิเสธ

IntegrationType

ประเภทการผสานรวมของการผสานรวม Google Pay

Enum
INTEGRATION_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทการผสานรวม
DIRECT_INTEGRATION ประเภทการผสานรวมคือการผสานรวมโดยตรง
PAYMENT_SERVICE_PROVIDER ประเภทการผสานรวมคือผู้ให้บริการชำระเงิน

DocumentType

ประเภทของเอกสาร

Enum
DOCUMENT_TYPE_UNSPECIFIED ไม่ได้ระบุประเภทเอกสาร
ITEM_SELECTION_SCREENSHOT เมื่อผู้ใช้เรียกดูสินค้าหรือบริการ
PRE_PURCHASE_SCREENSHOT เมื่อผู้ใช้พร้อมที่จะทำการซื้อ
PAYMENT_METHOD_SCREENSHOT เมื่อผู้ใช้เลือก Google Pay เป็นวิธีการชำระเงิน
PAYMENT_INFO_SCREENSHOT เมื่อผู้ใช้เห็นข้อมูลการชำระเงินที่บันทึกไว้ใน Google Pay เคล็ดลับ: Android จะไม่อนุญาตให้คุณถ่ายภาพหน้าจอของหน้าจอนี้ ดังนั้นให้ถ่ายรูปหน้าจอโดยใช้อุปกรณ์อื่น
POST_PURCHASE_SCREENSHOT เมื่อผู้ใช้ทำการซื้อสำเร็จ
PCI_ATTESTATION_DOCUMENT เอกสารรับรอง PCI ในรูปแบบ PDF

MimeType

ประเภท MIME ของเอกสาร

Enum
MIME_TYPE_UNSPECIFIED ไม่ได้ระบุประเภท MIME
JPEG ประเภท MIME คือ JPEG
PNG ประเภท MIME คือ PNG
WEBP ประเภท MIME คือ WEBP
PDF ประเภท MIME คือ PDF

สคีมาเอาต์พุต

ข้อความตอบกลับสำหรับ CreateGooglePayIntegration

CreateGooglePayIntegrationResponse

การแสดง JSON 
{
  "integrationState": enum (IntegrationState)
}
ช่อง
integrationState

enum (IntegrationState)

สถานะการผสานรวมของการผสานรวม Google Pay

IntegrationState

สถานะการผสานรวม Google Pay ของโดเมนเว็บของผู้ขายหรือแอป Android

Enum
INTEGRATION_STATE_UNSPECIFIED ไม่ได้ระบุสถานะการผสานรวม
NOT_STARTED สถานะนี้ใช้ในกรณีที่แอป Android เชื่อมโยงกับนักพัฒนาแอป (ใน Play Store) และนักพัฒนาแอปยังไม่ได้เริ่มกระบวนการผสานรวมใดๆ สำหรับแอป
INCOMPLETE นักพัฒนาแอปยังไม่ได้ส่งการผสานรวมเพื่อรับการตรวจสอบ และการผสานรวมยังไม่สมบูรณ์ (เช่น ไม่มีเอกสารประกอบ)
READY_FOR_REVIEW นักพัฒนาแอปยังไม่ได้ส่งการผสานรวมให้ตรวจสอบ แต่พร้อมรับการตรวจสอบแล้ว (เช่น อัปโหลดเอกสารประกอบแล้ว)
UNDER_REVIEW คำขอเปิดใช้การผสานรวมอยู่ระหว่างรอการตรวจสอบโดยผู้ดูแลระบบ
NEED_INFO การผสานรวมต้องการข้อมูลเพิ่มเติมจากผู้ดูแลระบบ gTech ระหว่างการตรวจสอบ
ACTIVE การผสานรวมทำงานอยู่ในขณะนี้
DELETED ผู้ขายลบการผสานรวม
REJECTED การผสานรวมถูกปฏิเสธ

คำอธิบายประกอบเครื่องมือ

คำแนะนำที่ทำให้เกิดการทำลาย: ❌ | คำแนะนำที่ทำให้เกิดการดำเนินการซ้ำ: ❌ | คำแนะนำแบบอ่านอย่างเดียว: ❌ | คำแนะนำแบบโลกเปิด: ❌