@portone/mcp-server 0.13.0

package/assets/docs/opi/ko/integration/pg/v1/daou/undefined.md

@@ -0,0 +1,214 @@
+---
+title: 키움페이 유의사항
+description: 결제 연동시 유의사항을 안내합니다.
+targetVersions:
+  - v1
+---
+
+## 키움페이 결제 특이사항
+
+<details>
+
+<summary>주문명, 주문자명은 EUC-KR에서 표현 가능한 문자가 사용해야함</summary>
+
+키움페이의 경우 EUC-KR 인코딩을 사용합니다. 따라서 주문자명(buyer\_name), 주문명(name) 등의
+파라미터에 EUC-KR에서 표현 가능한 문자를 입력해야 합니다.
+
+</details>
+
+<details>
+
+<summary>PC 결제는 `success`, 모바일 결제는 `imp_success` 전달</summary>
+
+PC와 모바일에서 결제창이 각기 다른 방식으로 호출되기 때문에, 결제 후속 프로세스에도 차이가 있습니다.
+PC 결제의 경우 키움페이 결제창이 iframe 방식으로 호출되기 때문에 결제 프로세스 완료 후 콜백 함수
+(`IMP.request_pay` 함수 호출시 전달한 두 번째 파라미터)가 호출되지만, 모바일 결제의 경우 키움페이 결제창이 키움페이 URL로
+리디렉션되기 때문에 결제 프로세스 완료 후 지정된 URL(`m_redirect_url`)로 302 리디렉션 됩니다.
+이때 결제 실패/성공 여부를 의미하는 파라미터가 전달되는데, PC 결제시에는 `success`, 모바일 결제시에는 `imp_success`로
+파라미터 명이 다르오니 유의하시기 바랍니다. 아래 예시를 참고해 주세요.
+
+- \[PC결제] iframe → 콜백 함수 호출 → 콜백 함수로 전달되는 response 객체에 `success` 키 값으로 전달
+
+  ```tsx
+  IMP.request_pay(
+    {
+      // 중략
+    },
+    function (response) {
+      const { success } = response; // 결제 성공 또는 실패 여부
+      if (success) {
+        // 결제 성공 시 프로세스
+      } else {
+        // 결제 실패 시 프로세스
+      }
+    },
+  );
+  ```
+
+- \[모바일 결제] 리디렉션 → m\_redirect\_url로 302 리디렉션 → `imp_success` 쿼리 파라미터 전달
+
+  ```text
+  /**
+   * m_redirect_url을 https://myservice.com/payments/complete로 설정한 후
+   * 결제 프로세스 종료 됐을때 302 리디렉션 되는 URL 예시
+   */
+  https://myservice.com/payments/complete?**imp_success=true**&imp_uid=imp1234567890&merchant_uid=mid_123467890
+  ```
+
+**`imp_success`와 `success`는 deprecated** 되었습니다.
+
+`imp_success` 파라미터와 `success` 파라미터는 **deprecated** 되었기 때문에 해당 파라미터를 기반으로
+결제 실패/성공 여부를 판단하시는걸 지양해주세요.
+
+해당 파라미터는 단순히 포트원에서 고객사 클라이언트로 응답되는 시기의 결제 실패/성공 여부를 내려주기 때문에
+이 값은 키움페이에서 포트원으로 결제 결과를 통지하고 포트원의 DB 업데이트가 완료된 시점인 경우에만
+정확합니다.
+
+그런데 **키움페이 → 포트원으로의 결제 결과 전달 → 포트원 DB 업데이트 및 포트원 → 고객사 클라이언트로의 응답이 비동기로 동작**하기 때문에
+**실제로는 결제가 정상적으로 완료된 경우에도 포트원 DB에 업데이트 시점에 따라 고객사 클라이언트로 응답되는
+`imp_success` 또는 `success` 파라미터가 `false`일 수** 있습니다.
+
+따라서 포트원 → 고객사 클라이언트로 응답되는 결과 데이터 중 포트원 거래 번호(`imp_uid`)와 고객사 주문 번호(`merchant_uid`)를 이용하여
+포트원 결제내역 조회 API([GET /payments/{imp\_uid}](https://developers.portone.io/api/rest-v1/payment#get%20%2Fpayments%2F%7Bimp_uid%7D))를 호출한 후
+결제 상태(`status`)를 보고 결제 실패(`failed`)/성공(`paid`) 여부를 판단하시길 권장드립니다.
+
+</details>
+
+<details>
+
+<summary>사파리 브라우저 - 하나카드 / NH앱캐시 결제시 유의사항</summary>
+
+사파리 브라우저에서 하나카드 / NH앱캐시(계좌이체) 결제 시 아래와 같이
+`세션 유효기간이 초과되어 카드사와 연결이 종료되었습니다`와 같은 메시지가 렌더링되며 결제 진행이 불가능한 경우가 발생할 수 있습니다.
+
+[참고이미지](<https://developers.portone.io/gitbook-assets/ko/image (116).png>)
+
+이러한 현상이 발생한 경우, 사파리 환경설정에서 아래와 같이 `크로스 사이트 추적 방지` 해제 및 `모든 쿠키 차단`이 모두 해제하신 후 다시 시도하시길 바랍니다.
+
+[참고이미지](<https://developers.portone.io/gitbook-assets/ko/image (159).png>)
+
+</details>
+
+<details>
+
+<summary>사파리/파이어폭스 브라우저 - BC카드 결제시 유의사항</summary>
+
+사파리와 파이어폭스에서 키움페이 결제창을 호출한 뒤 BC카드 선택 후 다음 버튼 클릭시 `지불에 실패하였습니다`라는 알림창이 뜨면서 결제 진행이
+불가능한 경우가 발생할 수 있습니다.
+
+[참고이미지](<https://developers.portone.io/gitbook-assets/ko/image (223).png>)
+
+이러한 현상이 발생한 경우, 사파리 환경설정에서 아래와 같이 `*.payjoa.co.kr` 도메인에 대해 팝업을 `허용`으로 설정해야 합니다.
+
+[참고이미지](<https://developers.portone.io/gitbook-assets/ko/image (256).png>)
+
+</details>
+
+<details>
+
+<summary>실시간 계좌이체 유의사항 </summary>
+
+키움페이의 경우 내부적으로 토스페이먼츠에서 제공하는 계좌이체를 사용하고 있어
+토스 퀵계좌결제로 연결됩니다.
+
+</details>
+
+<details>
+
+<summary>가상계좌 입금 완료시, 송금자 이름 정보만 저장됨</summary>
+
+키움페이는 (발급된)가상계좌에 입금 완료시, 송금자의 정보(은행명, 계좌번호, 송금인) 중 송금자 이름 정보만 저장됩니다.
+따라서 포트원 결제내역 조회([**GET /payments/{imp\_uid}**](https://developers.portone.io/api/rest-v1/payment#get%20%2Fpayments%2F%7Bimp_uid%7D))시
+송금자의 은행코드(`bank_code`)과 은행명(`bank_name`)은 모두 NULL로 내려가며,
+송금자 이름을 확인하기 위해서는 아래 예시와 같이 별도의 쿼리 파라미터(`extension`)를 `true`로 설정해주셔야 합니다.
+
+```http
+GET http://api.iamport.kr/payments/{포트원 번호}?**extension=true**
+```
+
+```json
+{
+  // ... 중략
+  "bank_code": null, // 송금자 은행 코드 알 수 없음
+  "bank_name": null, // 송금자 은행 이름 알 수 없음
+  "extension": {
+    // ... 중략
+    "REMITTER": "홍길동" // 송금자 이름
+  }
+}
+```
+
+</details>
+
+<details>
+
+<summary>가상계좌 결제 취소시, PG사와 특약 필요</summary>
+
+가상계좌 입금 완료 건에 대한 결제 취소(환불)는 가상계좌 발급 시 수수료가 부과되기 때문에 키움페이와
+특약을 계약한 후 사용할 수 있습니다. 특약을 계약하지 않는 경우 기본적으로 가상계좌 결제 건의 환불은 불가능합니다.
+
+</details>
+
+<details>
+
+<summary>가상계좌 결제 취소시, 실제 환불 금액 입금까지 7 영업일 이상 소요</summary>
+
+가상계좌 결제 취소(환불)을 진행하는 경우 키움페이 측에서 수기로 확인한 후 환불 처리가 진행되기 때문에
+환불 금액이 실제로 입금 될 때까지 7 영업일 이상 소요될 수 있습니다.
+
+</details>
+
+<details>
+
+<summary>과세/면세/복합과세를 하나의 CPID로 이용하시는 경우</summary>
+
+키움페이와 계약 진행 시 사용할 CPID 설정을 `건별구분`으로 발급 요청해 주셔야 합니다.
+건별구분으로 발급된 경우에만 하나의 CPID로 과세/면세/복합과세 거래 건을 모두 처리할 수 있습니다.
+
+</details>
+
+<details>
+
+<summary>복합과세 거래는 일부 결제수단에서만 가능</summary>
+
+결제창(`IMP.request_pay` 함수) 호출시 총 결제 금액(`amount`)중 면세 금액(`tax_free`)을 설정하여 복합과세 거래로 진행할 수 있습니다.
+단, 키움페이 시스템 상 면세 금액은 카드결제 혹은 간편결제 시에만 가능하고 계좌이체 / 가상계좌 결제 시에는 설정할 수 없어 전액 과세 처리 됩니다.
+
+- 복합과세 거래가 가능한 결제수단 (pay\_method)
+  - card
+  - kakaopay
+  - naverpay
+  - payco
+  - applepay
+  - samsung
+
+</details>
+
+<details>
+
+<summary>카카오페이, 페이코 거래 부분취소 시  취소금액 중 면세금액을 설정 불가</summary>
+
+카카오페이, 페이코 거래를 부분취소 하는 경우 취소금액 중 면세금액을 설정할 수 없습니다.
+따라서 카카오페이, 페이코 복합과세를 부분취소하는 경우 취소금액 중 면세금액은 취소 요청한 금액을 기준으로 기본 부가세율로 계산된 면세금액이 적용되어
+취소됩니다.
+
+</details>
+
+<details>
+
+<summary>에스크로 결제 시 구매자 전화번호 자동 입력 불가</summary>
+
+에스크로 결제시 결제 요청 시 입력된 구매자 전화번호가 결제창에 자동 완성되지 않습니다.
+
+[참고이미지](<https://developers.portone.io/gitbook-assets/ko/image (253).png>)
+
+</details>
+
+<details>
+
+<summary>비인증 결제 API 호출시 초당 호출 횟수 제한</summary>
+
+비인증 결제 API 호출시 **초당 50건 이하**로 호출 하는 것을 권장합니다.
+초당 50건 이상의 비인증 결제 API가 호출될 경우 오류가 발생할 수 있습니다.
+
+</details>

package/assets/docs/opi/ko/integration/pg/v1/eximbay.md

@@ -0,0 +1,242 @@
+---
+title: 엑심베이
+description: 엑심베이 결제 연동 방법을 안내합니다.
+targetVersions:
+  - v1
+---
+
+## 1. 엑심베이 채널 설정하기
+
+[결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
+
+(관련 이미지 첨부)
+
+## 2. 결제 요청하기
+
+[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk-old/readme) `IMP.request_pay(param, callback)`을 호출하여
+엑심베이 결제창을 호출할 수 있습니다. **결제결과**는 **PC / 모바일** 모두 **callback** 으로 전달됩니다.
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="인증결제창 요청">
+
+```ts title="Javascript SDK"
+IMP.request_pay(
+  {
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    pay_method: "card",
+    merchant_uid: "order_no_0001", // 상점에서 관리하는 주문 번호
+    name: "주문명:결제테스트",
+    amount: 14.2,
+    currency: "USD", // 기본값: USD
+    buyer_email: "test@portone.io",
+    buyer_name: "구매자이름",
+    buyer_tel: "010-1234-5678",
+    buyer_addr: "서울특별시 강남구 삼성동",
+    buyer_postcode: "123-456",
+    popup: false, // 팝업창 활성 비활성화 컨트롤
+  },
+  function (rsp) {
+    // callback 로직
+    /* ...중략... */
+  },
+);
+```
+
+**주요 파라미터 설명**
+
+- channelKey: string
+
+  **채널키**
+
+  결제를 진행할 채널을 지정합니다.
+
+  포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
+
+  (최신 JavaScript SDK 버전부터 사용 가능합니다.)
+
+- pg(deprecated)?: string
+
+  **PG사 구분코드**
+
+  `eximbay` 로 지정하면 됩니다.
+
+  <div class="hint" data-style="warning">
+
+  `pg` 파라미터는 지원 중단 예정입니다.
+
+  JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
+
+  </div>
+
+- pay\_method: string
+
+  **결제수단 구분코드**
+
+  - 신용카드: `card`
+  - 알리페이 / 알리페이 플러스: `alipay` (상점아이디 설정에 따라 알리페이 혹은 알리페이 플러스로 호출됩니다. )
+  - 해외카드: `card`
+  - 유니온페이: `unionpay`
+  - 텐페이: `tenpay`
+  - 일본 편의점결제(eContext): `econtext`
+  - 위챗페이: `wechat`
+  - 몰페이: `molpay`
+
+- merchant\_uid: string
+
+  **고객사 고유주문번호**
+
+  매번 고유하게 채번되어야 합니다.
+
+- buyer: string
+
+  **구매자명**
+
+- buyer\_tel: string
+
+  **구매자 연락처**
+
+- amount: number
+
+  **결제금액**
+
+  **string** 이 아닌점에 유의하세요
+
+- currency?: string
+
+  **결제통화코드**
+
+  - KRW
+  - USD
+  - EUR
+  - GBP
+  - JPY
+  - THB
+  - SGD
+  - RUB
+  - HKD
+  - CAD
+  - AUD
+  - CNY
+  - TWD
+  - MYR
+  - VND
+  - PHP
+  - MNT
+  - NZD
+  - AED
+  - MOP
+  - BRL
+  - KZT
+  - NOK
+  - SAR
+  - TRY
+
+- language?: string
+
+  - 한국어 : ko
+  - 영어 : en
+  - 중국어 : zh
+  - 일본어 : jp
+
+</div>
+
+</div>
+
+<div class="hint" data-style="warning">
+
+**참고사항**
+
+포트원은 엑심베이 정기결제를 지원하지 않습니다.
+
+</div>
+
+<details>
+
+<summary>편의점 결제 테스트 방법</summary>
+
+**편의점결제 동작 방식**
+
+한국의 가상계좌와 같이 결제창 내에서는 등록을 한 다음에 고객에게 이메일 / 문자로 전달되는 화면을 편의점 카운터에서 지불하며 처리합니다.
+
+- 포트원 내부에서는 `pay_method: "vbank"` 로 기록됨
+- Econtext 등록이 완료되었다는 콜백함수 및 웹훅 전송 (`status: "ready"` 상태 / `vbank_num`은 `unknown`으로 고정)
+- Econtext 로부터 입금확인이 되면 포트원에서 엑심베이로부터 응답을 받아 `status: "paid"`로 변경 후 결제완료처리에 대한 웹훅 전송
+
+**편의점결제 테스트 진행순서**
+
+가상계좌와 같이 실제 고객이 입금한 결과를 테스트해야 하므로 아래와 같이 입금완료됨을 임의적으로 통지받아보실 수 있습니다.
+
+1. 엑심베이 테스트모드 ON상태에서 1번과 같이 결제창 진행
+
+2. 콜백 응답 중 `pg_tid` 값을 별도로 메모 (포트원 관리자콘솔 PG사승인번호 컬럼에서 확인 가능)
+
+3. <http://test.econ.ne.jp/site/tuchi_2/tuchi_menu_2.html>로 이동 후 계정 로그인
+   (아이디 : `ectest` / 비번 : `#eg0810#`)
+
+4. ShopID : `361301`, orderID : 2번에서 확보한 PG사승인번호 입력
+
+5. 하단에 있는 **`登録`** 버튼 클릭
+
+6. 다음 페이지에서 한 번 더 **`登録`** 클릭
+
+7. 10분 후 결제상태가 `status: "paid"`로 바뀌는지 확인 (이 때 입금에 대한 웹훅 발송됨)
+
+</details>
+
+## 3. 기타 파라미터
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="국내 결제창 호출">
+
+엑심베이**국내 결제창**을 사용하기 위해서는 아래와 같은 방법으로 파라미터 설정이 필요합니다.
+
+```json
+{
+  "bypass": {
+    "issuercountry": "KR"
+  }
+}
+```
+
+<div class="hint" data-style="success">
+
+**국내 결제창 카드 별 승인 통화**
+
+**해외카드**
+
+- VISA/MAster/JCB : KRW 승인 (자국통화승인 서비스 가능)
+- AMEX/UnionPay : USD 승인  (자국통화승인 서비스 불가)
+
+**국내카드(국내에서 발행 된 (8개) 카드사 모두 이용 가능)**
+
+- 결제(승인)/정산 통화 : KRW만 지원
+
+</div>
+
+**국내 결제창을 호출하는 경우**
+
+```ts
+IMP.request_pay({
+  channelKey: "{콘솔 내 연동 정보의 채널키}",
+  pay_method: "card",
+  merchant_uid: "order_no_0001",
+  name: "주문명:결제테스트",
+  amount: 14.2,
+  currency: "KRW",
+  buyer_email: "test@portone.io",
+  buyer_name: "구매자이름",
+  buyer_tel: "010-1234-5678",
+  buyer_addr: "서울특별시 강남구 삼성동",
+  buyer_postcode: "123-456",
+  popup: false,
+  bypass: {
+    issuercountry: "KR",
+  },
+});
+```
+
+</div>
+
+</div>

package/assets/docs/opi/ko/integration/pg/v1/hyphen.md

@@ -0,0 +1,196 @@
+---
+title: 하이픈
+description: 하이픈 결제 연동 방법을 안내합니다.
+targetVersions:
+  - v1
+versionVariants:
+  v2: /opi/ko/integration/pg/v2/hyphen
+---
+
+## 채널 설정하기
+
+- [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기)의 내용을 참고하여 PG 설정을 진행합니다.
+
+## 가능한 결제 수단
+
+- 간편 결제
+
+  하이픈은 계좌 간편 결제를 전용으로 지원하는 PG사로, 등록한 계좌를 이용한 결제만 가능하며 다른 결제 수단은 지원하지 않습니다.
+
+  따라서 `pay_method` 파라미터를 아래와 같이 설정해야 합니다.
+
+  - 계좌이체 : `trans`
+
+### 계좌 간편 결제란?
+
+고객이 PG사에서 제공하는 결제 페이지에서 본인 명의의 계좌를 등록하고, 상품 구매 시 비밀번호 인증 등을 통해 등록된 계좌에서 출금하여 결제하는 서비스를 의미합니다.
+
+### 계좌 간편 결제의 장점
+
+계좌 간편 결제는 아래와 같은 장점을 제공합니다.
+
+1. **우수한 사용성**
+
+   보안 프로그램이나 추가 앱 설치 과정이 필요하지 않습니다.
+   또한 복잡한 계좌 입력이나 인증 과정 없이 최초 한 번만 계좌를 등록하고 이후에는 비밀번호를 통해 간편하게 인증할 수 있습니다.
+
+2. **낮은 수수료**
+
+   바로 계좌 결제는 오픈 뱅킹 기반의 계좌 이체 서비스로, 신용카드 결제에 비해 낮은 수수료로 해당 서비스를 이용할 수 있습니다.
+
+3. **빠른 정산 주기**
+
+   하이픈의 계좌 간편 결제 서비스는 통상 D+2일 주기로 정산을 해드리고 있습니다. 빠른 정산을 통해 현금 흐름을 효율적으로 관리할 수 있습니다.
+
+## SDK 결제 요청하기
+
+하이픈 결제는 최신 SDK에서만 지원됩니다.
+
+```html title="JS SDK"
+<script src="https://cdn.iamport.kr/v1/iamport.js"></script>
+```
+
+[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
+결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
+**callback**으로 수신되고
+모바일의 경우 **m\_redirect\_url** 로 리디렉션됩니다.
+
+하이픈 기준으로 작성한 예시 코드는 아래와 같습니다.
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="SDK 결제 요청">
+
+```ts
+IMP.request_pay(
+  {
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    pay_method: "trans",
+    merchant_uid: "orderMonthly0001", // 상점에서 관리하는 주문 번호
+    name: "테스트결제",
+    buyer_email: "test@portone.io",
+    buyer_name: "포트원",
+    buyer_tel: "02-1234-1234",
+    m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}",
+    amount: 1004,
+    storeDetails: {
+      businessName: "상호명",
+    },
+    bypass: {
+      hyphen: {
+        designCd: "#C1272C",
+      },
+    },
+  },
+  function (rsp) {
+    // callback 로직
+  },
+);
+```
+
+</div>
+
+</div>
+
+### 주요 파라미터
+
+- channelKey: string
+
+  **채널키**
+
+  결제를 진행할 채널을 지정합니다.
+
+  포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
+
+  (최신 JavaScript SDK 버전부터 사용 가능합니다.)
+
+- pg?: string
+
+  **PG사 구분코드**
+
+  `hyphen.{MID}` 형태로 지정하여 사용해야 합니다.
+
+  <div class="hint" data-style="warning">
+
+  `pg` 파라미터는 지원 중단 예정입니다.
+
+  JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
+
+  </div>
+
+- pay\_method: string
+
+  **결제수단 구분코드**
+
+  하이픈의 경우 `trans`만 지원됩니다.
+
+- merchant\_uid: string
+
+  **고객사 주문 고유 번호**
+
+  고객사에서 채번하는 주문 고유 번호로 매번 고유하게 채번되어야 합니다.
+  이미 승인 완료된 `merchant_uid`로 결제를 시도하는 경우 에러가 발생합니다.
+
+- name: string
+
+  **주문명**
+
+  주문명으로 고객사에서 자유롭게 입력합니다.
+
+- amount: number
+
+  **결제 금액**
+
+  결제 금액으로 number 형식만 허용됩니다.
+
+- buyer\_name: string
+
+  **구매자 이름**
+
+  하이픈의 경우 필수로 입력해야 합니다.
+
+- storeDetails?: object
+
+  **상점 정보**
+
+  - businessName?: string
+
+    **상호명**
+
+    - 결제창에 표시될 상호명입니다. 입력하지 않으면 포트원 대표상점명으로 표시됩니다.
+
+- bypass?: oneof object
+
+  **PG사 결제창 호출 시 PG사로 그대로 bypass할 파라미터들의 모음**
+
+  - hyphen?: object
+
+    **하이픈에서 제공하는 파라미터 모음**
+
+    - designCd?: string
+
+      **결제창 디자인 색상 코드**
+
+      - `#`으로 시작하는 여섯자리 Hex 값을 입력합니다. (ex. `#C1272C`)
+
+### 유의사항
+
+<details>
+
+<summary>`merchant_uid` 허용 문자 및 길이 제한</summary>
+
+`merchant_uid` 에는 영문, 숫자, `_`(underscore) 만으로 이루어진 문자열만 입력할 수 있습니다.
+
+여기에 포함되지 않는 한글이나 `♤`, `♡`, `♧` 등의 특수 문자는 허용되지 않습니다.
+
+또한 `merchant_uid`의 최대 길이는 40자이므로, 해당 길이를 넘지 않는 값으로 결제를 요청해주세요.
+
+</details>
+
+<details>
+
+<summary>`name` 길이 제한</summary>
+
+`name`의 최대 길이는 40자입니다.
+
+</details>