Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

MCP Tools Reference: paydeveloper.googleapis.com

도구: `create_merchant`

인증된 계정으로 새 판매자를 만듭니다. 사용자에게 판매자 생성에 필요한 정보를 제공하도록 요청해야 합니다(MUST). 필수 입력란 중 하나는 판매자 카테고리 코드 (MCC)입니다. MCC 목록이 길기 때문에 일반적인 옵션의 하위 집합을 표시할 수 있지만, 더 많은 옵션이 제공되며 전체 목록을 요청할 수 있다고 사용자에게 알려야 합니다(예: 'X개 더 많은 옵션' 또는 유사한 힌트 표시)(MUST). 또한 사용자에게 이미 알고 있는 경우 4자리 MCC 코드 (예: 5499)를 직접 제공할 수 있다고 안내하고 사용하도록 권장합니다. 판매자 등록에 필요한 정보를 먼저 수집해 보기 전까지는 이 도구를 사용하지 마십시오. 가맹점 생성 후에는 반드시 사용자에게 비즈니스 콘솔 서비스 약관 URL을 제시하고, 해당 가맹점에 대한 모든 작업을 수행하기 전에 약관에 동의하도록 안내해야 합니다.

다음 코드 샘플은 curl를 사용하여 create_merchant 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_merchant", "arguments": { // Provide these details according to the MCP tool specification. } }, "jsonrpc": "2.0", "id": 1 }'

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_merchant",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

입력 스키마

CreateMerchant의 요청 메시지입니다.

CreateMerchantRequest

JSON 표현
{ "merchant": { object (`Merchant`) } }

필드

필드
`merchant`	`object (Merchant)` 필수 항목입니다. 만들 판매자의 기본 정보입니다.

merchant

object (Merchant)

필수 항목입니다. 만들 판매자의 기본 정보입니다.

판매자

JSON 표현

JSON 표현
{ "merchantId": string, "displayName": string, "regionCode": string, "mcc": enum (`Mcc`), "corporateWebsiteUrl": string, "customerSupportWebsiteUrl": string, "customerSupportEmail": string, "customerSupportPhone": string, "state": enum (`State`) }

{
  "merchantId": string,
  "displayName": string,
  "regionCode": string,
  "mcc": enum (Mcc),
  "corporateWebsiteUrl": string,
  "customerSupportWebsiteUrl": string,
  "customerSupportEmail": string,
  "customerSupportPhone": string,
  "state": enum (State)
}

필드
`merchantId`	`string` 출력 전용입니다. 판매자의 고유 식별자입니다.
`displayName`	`string` 필수 항목입니다. 판매자의 표시 이름입니다.
`regionCode`	`string` 필수 항목입니다. 판매자 비즈니스 위치의 지역 코드입니다. 형식은 유니코드 CLDR 지역 코드입니다(예: 'US'). 인도 ('IN')는 지원되지 않습니다.
`mcc`	`enum (Mcc)` 필수 항목입니다. 판매자의 판매자 카테고리 코드 (MCC)입니다.
`corporateWebsiteUrl`	`string` 필수 항목입니다. 판매자의 회사 웹사이트입니다.
`customerSupportWebsiteUrl`	`string` 필수 항목입니다. 판매자의 고객 지원 웹사이트입니다.
`customerSupportEmail`	`string` 필수 항목입니다. 판매자의 고객 지원 이메일입니다.
`customerSupportPhone`	`string` 필수 항목입니다. 판매자의 고객 지원팀 전화번호입니다.
`state`	`enum (State)` 출력 전용입니다. 판매자의 상태입니다.

Mcc

판매자의 판매자 카테고리 코드 (MCC)입니다.

열거형
`OTHERS`	기타
`MISC_FOOD_STORES`	기타 식품 매장 - 편의점 및 전문 시장
`MISC_APPAREL`	기타 의류 및 액세서리 매장
`ARTISTS_SUPPLY`	미술용품점 및 공예품점
`AUTOMOTIVE_PARTS`	자동차 부품, 액세서리 매장
`HEALTH_AND_BEAUTY`	건강/미용용품점
`BOOKS_PERIODICALS`	도서, 정기 간행물 및 신문
`CAMERA_STORES`	카메라 및 사진용품 매장
`COMPUTERS_EQUIPMENT`	컴퓨터, 컴퓨터 주변기기, 소프트웨어
`COMPUTER_SOFTWARE`	컴퓨터 소프트웨어 판매점
`ELECTRONICS_SALES`	전자제품 판매
`GIFT_SHOPS`	카드 매장, 선물, 신기한 물건, 기념품 매장
`EATING_PLACES`	음식점 및 레스토랑
`MISC_GENERAL_MERCHANDISE`	기타 일반 상품
`HOME_SUPPLY`	가정용품 창고형 매장
`COMPUTER_NETWORK_SERVICES`	컴퓨터 네트워크 서비스
`DIGITAL_GOODS_MEDIA`	디지털 상품: 도서, 영화, 음악
`DIGITAL_GOODS_GAMES`	디지털 상품: 게임
`DIGITAL_GOODS_APPLICATIONS`	디지털 상품: 애플리케이션 (게임 제외)
`POLITICAL_ORGANIZATIONS`	정치 조직
`CHARITABLE_ORGANIZATIONS`	자선 및 사회 서비스 조직
`DRUG_STORES`	약국 및 의약품
`REAL_ESTATE_RENTALS`	부동산 중개인 및 관리자 - 임대
`MISC_PERSONAL_SERVICES`	기타 달리 분류되지 않는 개인 서비스
`SPORTING_GOODS`	스포츠용품 판매점
`STATIONERY_OFFICE_SUPPLIES`	문구점, 사무용품점, 인쇄 및 필기 용지
`THEATRICAL_TICKET_AGENCIES`	공연 티켓 에이전시
`TIMESHARES`	타임쉐어
`TOURIST_ATTRACTIONS`	관광 명소 및 전시
`HOBBY_TOY_GAME_SHOPS`	취미, 장난감, 게임 상점
`PET_SHOPS`	반려동물 전문점, 반려동물 사료 및 용품점
`OTHER_LODGING`	기타 숙박 시설 - 호텔, 모텔, 리조트
`TELECOMMUNICATION_SERVICES`	통신 서비스
`TRANSPORTATION_SERVICES`	운송 서비스
`OTHER_AIRLINES`	기타 항공사
`TRAVEL_AGENCIES`	여행사 및 여행 운영업체
`GOVERNMENT_OWNED_LOTTERIES_US`	정부 소유 복권 (미국 리전 한정)
`GOVERNMENT_LICENSED_CASINOS_US`	정부 라이선스를 보유한 온라인 카지노 (온라인 도박) (미국 지역만 해당)
`BETTING`	베팅 (복권, 카지노 게임 칩, 장외 베팅 및 기타 베팅 포함)
`GOVERNMENT_OWNED_LOTTERIES_NON_US`	정부 소유 복권 (미국 외 리전)

주

판매자의 상태입니다.

열거형
`STATE_UNSPECIFIED`	판매자 상태가 지정되지 않았습니다.
`VERIFIED`	판매자가 인증되고 승인되었습니다.
`IN_REVIEW`	판매자 프로필 수정사항이 검토 중입니다.
`REJECTED`	판매자 프로필 수정사항이 거부됩니다.
`INCOMPLETE_SIGNUP`	판매자 프로필이 불완전합니다.
`SANCTIONS_HIT`	판매자 프로필에 제재가 적용됩니다.
`READY_FOR_REVIEW`	판매자 프로필 작성이 완료되어 검토 준비가 되었습니다.
`DISABLED`	판매자 프로필이 사용 중지되었거나 비활성 상태입니다.

출력 스키마

CreateMerchant의 응답 메시지입니다.

CreateMerchantResponse

JSON 표현
{ "merchantId": string, "state": enum (`State`), "businessConsoleTosUrl": string }

필드

필드
`merchantId`	`string` 생성된 판매자의 판매자 ID입니다.
`state`	`enum (State)` 생성된 판매자의 상태입니다.
`businessConsoleTosUrl`	`string` 출력 전용입니다. 비즈니스 콘솔 이용약관 URL. 사용자가 판매자에 대한 작업을 수행하려면 먼저 비즈니스 콘솔 서비스 약관에 동의해야 합니다.

merchantId

string

생성된 판매자의 판매자 ID입니다.

state

enum (State)

생성된 판매자의 상태입니다.

businessConsoleTosUrl

string

출력 전용입니다. 비즈니스 콘솔 이용약관 URL. 사용자가 판매자에 대한 작업을 수행하려면 먼저 비즈니스 콘솔 서비스 약관에 동의해야 합니다.

주

판매자의 상태입니다.

열거형
`STATE_UNSPECIFIED`	판매자 상태가 지정되지 않았습니다.
`VERIFIED`	판매자가 인증되고 승인되었습니다.
`IN_REVIEW`	판매자 프로필 수정사항이 검토 중입니다.
`REJECTED`	판매자 프로필 수정사항이 거부됩니다.
`INCOMPLETE_SIGNUP`	판매자 프로필이 불완전합니다.
`SANCTIONS_HIT`	판매자 프로필에 제재가 적용됩니다.
`READY_FOR_REVIEW`	판매자 프로필 작성이 완료되어 검토 준비가 되었습니다.
`DISABLED`	판매자 프로필이 사용 중지되었거나 비활성 상태입니다.

도구 주석

도구 주석은 특정 도구의 기본 위험을 설명하기 위해 MCP 클라이언트로 전송됩니다. 대부분의 클라이언트는 이러한 힌트를 신뢰할 수 없는 것으로 취급하지만, 사용자에게 확인 메시지를 전송할 시점을 결정하는 데 사용할 수 있습니다.

제목 문자열과 함께 다음 불리언 힌트가 다음과 같이 정의됩니다.

readOnlyHint: true인 경우 도구가 환경을 수정하지 않습니다. 기본값: false.
destructiveHint: true인 경우 도구가 파괴적인 작업을 실행할 수 있습니다. false인 경우 도구는 추가 작업만 실행할 수 있습니다. 기본값은 true입니다.
idempotentHint: true인 경우 동일한 인수로 도구를 반복적으로 호출해도 환경에 추가적인 영향을 미치지 않습니다. 기본값: false.
openWorldHint: true인 경우 도구가 외부 엔티티의 '오픈 월드'와 상호작용할 수 있습니다. false인 경우 도구는 내부 항목과만 상호작용할 수 있습니다. 예를 들어 웹 검색 도구는 오픈 월드이지만 메모리 도구는 오픈 월드가 아닙니다.

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

MCP Tools Reference: paydeveloper.googleapis.com 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

도구: create_merchant