MCP Tools Reference: paydeveloper.googleapis.com

도구: create_google_pay_integration

특정 판매자의 Google Pay 통합을 만듭니다. 이 작업을 수행하려면 사용자가 비즈니스 콘솔 서비스 약관과 Google Pay API 서비스 약관에 동의해야 합니다. 이러한 문제를 사전 예방적으로 확인할 필요는 없습니다. 동의하지 않은 경우 도구 호출이 실패하고 오류 메시지에는 동의해야 하는 특정 서비스 약관 URL이 포함됩니다. 이 경우 사용자에게 URL을 표시하여 수락을 요청하고 수락 후 다시 시도하도록 안내합니다. 도구를 호출하기 전에 사용자와 상호작용하려면 다음 순서를 따르세요. 1. 먼저 사용자에게 통합 항목을 요청합니다 (현재는 웹 통합만 지원됨). - 웹사이트 URL을 요청합니다. # - 통합 항목이 앱 통합인 경우 Android 앱 패키지 이름을 묻습니다. 2. 그런 다음 사용자에게 통합 유형을 묻습니다. - 지원되는 결제 서비스 제공업체 (PSP: https://developers.google.com/pay/api#participating-processors)를 사용하는 경우 게이트웨이를 선택하고, 그렇지 않은 경우 직접을 선택하라고 안내합니다. 3. 모든 통합 유형 (직접 또는 게이트웨이): - 사용자에게 Google Pay API와 통합된 구매 과정의 스크린샷 (최대 1MB)을 업로드하라고 안내합니다. 전체 프로덕션 액세스 권한이 부여되려면 먼저 구매 과정을 검토하고 승인받아야 합니다. 예: https://developers.google.com/pay/api/web/guides/brand-guidelines#put-it-all-together - 사용자에게 5개의 지원 스크린샷을 제공해 달라고 요청해야 합니다(MUST). 올바른 매핑을 위해 하나씩 요청하세요. 질문할 때는 사용자 친화적인 열거형 설명만 사용하세요. 4. 통합 유형이 직접인 경우: - 사용자에게 PDF 형식의 PCI 증명 문서를 제공해 달라고 요청해야 합니다(MUST). 질문할 때는 사용자 친화적인 열거형 설명만 사용하세요. 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 통합을 추가할 판매자의 판매자 ID입니다.
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)

출력 전용입니다. 통합 리소스가 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. 'Z' 이외의 오프셋도 허용됩니다. 예를 들면 "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" 또는 "2014-10-02T15:01:23+05:30"입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 통합 리소스가 마지막으로 업데이트된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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 통합의 통합 문서입니다.
통합 필드 item. 통합 항목입니다. 이 중 하나를 설정해야 합니다. item은 다음 중 하나여야 합니다.
webDomain

string

판매자의 웹 도메인입니다.
androidAppPackage

string

판매자의 Android 앱 패키지 이름입니다.

타임스탬프

JSON 표현 
{
  "seconds": string,
  "nanos": integer
}
필드
seconds

string (int64 format)

Unix epoch 1970-01-01T00:00:00Z 이후 UTC 시간의 초 단위로 표현합니다. -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

판매자 웹 도메인 또는 Android 앱의 Google Pay 통합 상태입니다.

열거형
INTEGRATION_STATE_UNSPECIFIED 통합 상태가 지정되지 않았습니다.
NOT_STARTED 이 상태는 Android 앱이 개발자 (Play 스토어)와 연결되어 있고 개발자가 앱의 통합 프로세스를 시작하지 않은 경우에 해당합니다.
INCOMPLETE 개발자가 아직 검토를 위해 통합을 제출하지 않았으며 통합이 완료되지 않았습니다 (예: 지원 문서가 누락됨).
READY_FOR_REVIEW 개발자가 아직 검토를 위해 통합을 제출하지 않았지만 검토할 준비가 되었습니다 (예: 지원 문서가 업로드됨).
UNDER_REVIEW 통합 사용 설정 요청이 관리자의 검토를 기다리는 중입니다.
NEED_INFO 검토 중에 gTech 관리자가 추가 정보를 제공해야 합니다.
ACTIVE 현재 통합이 활성 상태입니다.
DELETED 판매자가 통합을 삭제했습니다.
REJECTED 통합이 거부됩니다.

IntegrationType

Google Pay 통합의 통합 유형입니다.

열거형
INTEGRATION_TYPE_UNSPECIFIED 통합 유형이 지정되지 않았습니다.
DIRECT_INTEGRATION 통합 유형은 직접 통합입니다.
PAYMENT_SERVICE_PROVIDER 통합 유형이 결제 서비스 제공업체입니다.

DocumentType

문서 유형입니다.

열거형
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 PDF 형식의 PCI 증명서

MimeType

문서의 MIME 유형입니다.

열거형
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

판매자 웹 도메인 또는 Android 앱의 Google Pay 통합 상태입니다.

열거형
INTEGRATION_STATE_UNSPECIFIED 통합 상태가 지정되지 않았습니다.
NOT_STARTED 이 상태는 Android 앱이 개발자 (Play 스토어)와 연결되어 있고 개발자가 앱의 통합 프로세스를 시작하지 않은 경우에 해당합니다.
INCOMPLETE 개발자가 아직 검토를 위해 통합을 제출하지 않았으며 통합이 완료되지 않았습니다 (예: 지원 문서가 누락됨).
READY_FOR_REVIEW 개발자가 아직 검토를 위해 통합을 제출하지 않았지만 검토할 준비가 되었습니다 (예: 지원 문서가 업로드됨).
UNDER_REVIEW 통합 사용 설정 요청이 관리자의 검토를 기다리는 중입니다.
NEED_INFO 검토 중에 gTech 관리자가 추가 정보를 제공해야 합니다.
ACTIVE 현재 통합이 활성 상태입니다.
DELETED 판매자가 통합을 삭제했습니다.
REJECTED 통합이 거부됩니다.

도구 주석

파괴적 힌트: ❌ | 동일한 힌트: ❌ | 읽기 전용 힌트: ❌ | 오픈 월드 힌트: ❌