@portone/mcp-server 0.13.0

package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md

@@ -0,0 +1,150 @@
+---
+title: 빌링키 발급 / API 연동 유의사항
+description: (신)나이스페이먼츠 비인증 결제 연동 유의사항을 소개합니다.
+targetVersions:
+  - v1
+---
+
+## API 지원 기능
+
+- 빌링키 발급
+- 빌링키 결제
+- 키인 결제
+- 예약 결제
+- 결제 취소(가상계좌 환불 포함)
+- 에스크로 배송 정보 등록, 조회(수정 불가능)
+- 가상계좌 발급, 회수(수정 불가능)
+- 포트원 외부 결제 건 현금영수증 발급, 조회, 취소
+
+## 빌링키 삭제
+
+간편결제 (카카오페이, 네이버페이) 빌링키의 경우 삭제 요청 시 `reason` 파라미터에 빌링키를 삭제하려는 사유를 반드시 입력해야 합니다.
+
+## 비인증 결제
+
+(신) 나이스페이먼츠는 발급 된 빌링키로 재결제(`POST /subscribe/payemnts/again`),
+키인 결제(`POST /subscribe/payments/onetime`) 그리고 스케줄 결제(`POST /subscribe/payments/schedule`)를
+모두 지원하며 기본 파라미터 외에 아래 3개의 파라미터를 추가로 지원합니다.
+
+**간편결제 (카카오페이, 네이버페이) 빌링키로 결제 시에는 할부결제가 불가능하기 때문에 `card_quota` 파라미터 없이 요청해야 합니다.**
+
+|파라미터                     |데이터 타입           |의미                                                                                               |
+|-----------------------------|----------------------|---------------------------------------------------------------------------------------------------|
+|vat\_amount                  |double                |총 결제 금액 중 부가세 금액. 부가세 직접 입력 방식을 위해 사용. 단, 나이스페이먼츠와 사전 협의 필요|
+|intereset\_free\_by\_merchant|boolean(기본값: false)|상점 부담 무이자 할부 적용 여부. 단, 나이스페이먼츠와 사전 협의 필요                               |
+|use\_card\_point             |boolean(기본값: false)|카드사 포인트 사용 여부. 단, 나이스페이먼츠와 사전 협의 필요                                       |
+
+## 가상계좌
+
+### 가상계좌 API 발급시 `business_registration_number` 파라미터 추가 지원
+
+|파라미터                      |데이터 타입|의미                   |
+|------------------------------|-----------|-----------------------|
+|business\_registration\_number|string     |구매자 사업자 등록 번호|
+
+(신) 나이스페이먼츠의 경우 API를 통한 가상 계좌 발급 시, 향후 해당 거래 건을 에스크로 배송 정보로 등록할 때
+사용될 구매자의 사업자 번호를 `business_registration_number` 파라미터로 입력받고 있습니다.
+
+### API로 가상계좌 채번은 가능하나 발급된 가상계좌 정보는 수정 불가능
+
+(신) 나이스페이먼츠는 `POST /vbanks` API로 가상 계좌를 채번 할 수 있지만 `PUT /vbanks` API로
+**이미 채번 된 가상계좌 정보(입금 기한, 입금 금액)를 수정할 수 없습니다.**
+
+## 에스크로 결제
+
+### 배송 정보 등록시 `send_email` 파라미터 추가 지원
+
+|파라미터   |데이터 타입|의미                                                                                     |
+|-----------|-----------|-----------------------------------------------------------------------------------------|
+|send\_email|boolean    |에스크로 구매 확정시 결제 창에 입력했던 이메일로 해당 사실을 전송할지 여부 (기본값: true)|
+
+(신) 나이스페이먼츠의 경우 에스크로 결제건에 대해 배송 정보 등록 API 호출 시 `send_email` 파라미터를
+이용하여 구매 확정됐을 때 결제창에 입력한 이메일로 구매 확정 내용을 전송할지 여부를 제어할 수 있습니다.
+기본 값은 true(구매 확정 여부 이메일 전송)이며 false로 입력 시 구매가 확정되어도 이메일로 안내되지 않습니다.
+
+### 배송 정보 수정 불가
+
+(신) 나이스페이먼츠는 `POST /escrow/logis/{imp_uid}` API로 에스크로 배송 정보 등록은 가능하지만
+`PUT /escrow/logis/{imp_uid}` API로 **수정은 불가능**합니다.
+
+## 현금영수증
+
+### 결제창에서 발급 받지 못한 현금영수증은 API로 발급 불가능
+
+(신) 나이스페이먼츠의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서
+현금영수증을 발급 요청할 수 있습니다. 이때 결제 승인 단계에서 현금영수증을 발급 요청하지 못한 경우,
+현금영수증 발급 API(`POST /receipts/{imp_uid}`)를 사용한다고 하더라도 발급이 되지 않으니 참고 부탁드립니다.
+
+### API로 현금영수증 발급 시, 현금영수증 카드 사용 불가능
+
+API로 현금영수증 발급(`POST /receipts/{imp_uid}`)시 발급 받을 현금영수증 정보(현금영수증 발급 유형,
+현금영수증 발행 식별 정보, 현금영수증 발행 식별 정보 유형)를 전달해야 합니다.
+단, (신) 나이스페이먼츠의 경우 **현금영수증 카드 번호로 현금영수증 발급이 불가능**하오니 참고 부탁드립니다.
+
+<details>
+
+<summary>\[가능] 사업자 등록번호로 지출증빙용 현금영수증 발급</summary>
+
+```http
+POST /receipts/{imp_uid}
+
+{
+  // ...중략
+  "type": "company", // 현금영수증 발급 유형: 지출증빙
+  "identifier": "1178178260", // 현금영수증 발행 식별 정보: 사업자 등록번호
+  "identifier_type": "business" // 현금영수증 발행 식별 정보 유형: 사업자 등록번호
+}
+```
+
+</details>
+
+<details>
+
+<summary>\[가능] 휴대폰 번호로 소득공제용 현금영수증 발급</summary>
+
+```http
+POST /receipts/{imp_uid}
+
+{
+  // ...중략
+  "type": "personal", // 현금영수증 발급 유형: 소득공제
+  "identifier": "01012345678", // 현금영수증 발행 식별 정보: 휴대폰 번호
+  "wdentifier_type": "phone" // 현금영수증 발행 식별 정보 유형: 휴대폰 번호
+}
+```
+
+</details>
+
+<details>
+
+<summary>\[가능] 주민등록번호로 소득공제용 현금영수증 발급</summary>
+
+```http
+POST /receipts/{imp_uid}
+
+{
+  // ...중략
+  "type": "personal", // 현금영수증 발급 유형: 소득공제
+  "identifier": "9010102012345", // 현금영수증 발행 식별 정보: 주민등록번호
+  "identifier_type": "person" // 현금영수증 발행 식별 정보 유형: 주민등록번호
+}
+```
+
+</details>
+
+<details>
+
+<summary>\[불가능] 현금영수증 카드번호로 소득공제용 현금영수증 발급</summary>
+
+```http
+POST /receipts/{imp_uid}
+
+{
+  // ...중략
+  "type": "personal", // 현금영수증 발급 유형: 소득공제
+  "identifier": "123456789012", // 현금영수증 발행 식별 정보: 현금영수증 카드번호
+  "identifier_type": "taxcard" // 현금영수증 발행 식별 정보 유형: 현금영수증 카드번호
+}
+```
+
+</details>

package/assets/docs/opi/ko/integration/pg/v1/nice-v2/payment-caution.md

@@ -0,0 +1,429 @@
+---
+title: 일반결제 연동 유의사항
+description: 나이스페이먼츠(신모듈) 일반결제 연동 유의사항을 소개합니다.
+targetVersions:
+  - v1
+---
+
+## 결제창 호출 실패 사유 알 수 없음
+
+상점 아이디 설정 이슈, 파라미터 설정 오류 등으로 결제창 호출이 불가능한 경우
+PG사로부터 정확한 사유를 전달받지 못하기 때문에 다음과 같이
+“알 수 없는 이유로 결제가 중단되었습니다. 나이스페이로 문의(1661-0808)하세요.” 에러를 리턴합니다.
+이 메시지를 받으신 경우 결제창 호출 시 사용한 파라미터 전문과 함께 포트원으로 문의해 주시길 바랍니다.
+
+## 카드 결제
+
+|기능                                 |사용 가능 여부                                                                                |
+|-------------------------------------|----------------------------------------------------------------------------------------------|
+|상점 부담 무이자 할부                |가능                                                                                          |
+|다이렉트 호출                        |<span style="color:red"> **단독 사용 불가능** </span> (고정 할부 개월수가 함께 전달 되어야 함)|
+|다이렉트 호출 + 고정 할부 개월수     |가능                                                                                          |
+|다이렉트 호출 + 리스트 할부 개월수   |<span style="color:red"> **불가능** </span>                                                   |
+|비 다이렉트 호출 + 고정 할부 개월수  |**PC만 가능**                                                                                 |
+|비 다이렉트 호출 + 리스트 할부 개월수|**PC만 가능**                                                                                 |
+
+### 토스뱅크 카드사 다이렉트 호출 미지원
+
+나이스페이먼츠(신모듈)의 경우 토스뱅크 카드(card.direct.code = "092") 다이렉트 호출이 불가능합니다.
+
+### 카드사 다이렉트 호출시 고정 할부 개월수 필수 입력
+
+나이스페이먼츠(신모듈)는 **카드사 다이렉트 호출시
+고정 할부 개월수를 <span style="color:red"> 필수 </span>로 입력**해야 합니다.
+결제 금액이 할부 지원 금액 미만(일반적으로 50,000원 이상 결제 시 할부 기능을 지원하나
+카드사에 따라 다를 수 있습니다.)인 경우 **할부 개월수를 0(일시불)으로 전달**해야 합니다.
+
+<details>
+
+<summary>BC 카드 다이렉트 호출 + 5개월 고정 할부</summary>
+
+```ts
+IMP.request_pay(
+  {
+    // ...중략
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    pay_method: "card",
+    card: {
+      direct: {
+        // 다이렉트 호출할 카드사 코드와 고정 할부 개월수를 모두 지정해야 함
+        code: "361", // BC카드
+        quota: 5, // 5개월 할부
+      },
+    },
+  },
+  // 콜백함수
+);
+```
+
+</details>
+
+<details>
+
+<summary>삼성 카드 다이렉트 호출 + 일시불</summary>
+
+```ts
+IMP.request_pay(
+  {
+    // ...중략
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    pay_method: "card",
+    card: {
+      direct: {
+        // 다이렉트 호출 할 카드사 코드와 고정 할부 개월수를 모두 지정해야 함
+        code: "365", // 삼성카드
+        quota: 0, // 일시불
+      },
+    },
+  },
+  // 콜백함수
+);
+```
+
+</details>
+
+### 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정 가능
+
+나이스페이먼츠(신모듈)의 경우 일반 카드 결제 시(간편결제 제외) 할부 옵션(고정 할부 개월수)사용이 가능하나
+**모바일 환경**에서는 **카드사 다이렉트 호출할 때만 할부 옵션 사용이 가능합니다.** 만약 모바일 환경에서 다이렉트 호출 코드 없이
+할부 옵션을 전달하는 경우 무시됩니다.
+
+<details>
+
+<summary>모바일 환경에서 리스트 할부 개월수만 전달 → 전달한 파라미터가 무시되고 모든 할부 개월수 렌더링</summary>
+
+```ts
+IMP.request_pay(
+  {
+    // ...중략
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    pay_method: "card",
+    display: { card_quota: [2, 3, 4, 5, 6] }, // 2 ~ 6 개월 리스트 할부 개월수 적용 시도
+  },
+  // 콜백함수
+);
+```
+
+(관련 이미지 첨부)
+
+</details>
+
+<details>
+
+<summary>모바일 환경에서 3개월 고정 할부 개월수만 전달 → 전달한 파라미터가 무시되고 모든 할부 개월수 렌더링</summary>
+
+```ts
+// ...중략
+IMP.request_pay(
+  {
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    pay_method: "card",
+    display: { card_quota: [3] }, // 3개월 고정 할부 개월수 적용 시도
+  },
+  // 콜백함수
+);
+```
+
+(관련 이미지 첨부)
+
+</details>
+
+## 가상계좌
+
+### 가상계좌 입금 기한(`vbank_due`) 필수 입력
+
+나이스페이먼츠(신모듈) 가상 계좌 발급 시, 입금 기한은 필수 입력해야 하며 아래 4가지 형식만 유효합니다.
+입금 기한을 입력하지 않거나, 유효하지 않은 형식을 입력할 경우 가상계좌 발급 결제창이 호출되지 않고 "결제 창 호출에 실패하였습니다.
+나이스페이 V2 가상계좌 발급시 유효한 입금 기한을 필수로 입력해야 합니다." 라는 에러 메세지가 리턴되오니 유의하시기 바랍니다.
+
+- YYYY-MM-DD HH:mm:ss
+- YYYYMMDDHHmmss
+- YYYY-MM-DD
+- YYYYMMDD
+
+## 계좌이체
+
+### 계좌이체 다이렉트 호출시 은행 코드 지정 불가능
+
+나이스페이먼츠(신모듈) 계좌이체 다이렉트 호출은 은행 코드를 지정하지 않고 바로 뱅크페이 결제창이 띄워지는 구조입니다.
+
+### 계좌이체 다이렉트 호출시 현금영수증 정보는 필수 입력
+
+계좌이체 거래는 계좌에서 현금성 결제로 현금영수증 발급이 가능하므로 현금영수증 정보를 필수로 입력해야 합니다.
+만약 입력하지 않을 경우 나이스페이먼츠(신모듈) 계좌이체 다이렉트 호출 시 **현금영수증 발급 유형은 필수 입력**입니다.
+라는 에러 메시지가 뜨면서 결제창이 호출되지 않으니 유의하시기 바랍니다.
+
+### 계좌이체 에스크로 결제시에는 다이렉트 호출 불가능
+
+나이스페이먼츠 정책상 계좌이체 + 에스크로 결제시에는 다이렉트 호출이 불가능합니다.
+아래와 같이 계좌이체 + 에스크로 + 다이렉트 호출을 위한 파라미터를 설정할 경우
+"나이스페이 V2 계좌이체 에스크로 결제시 다이렉트 호출은 불가능합니다."라는 에러 메시지가 뜨면서
+결제창이 호출되지 않으니 유의하시기 바랍니다.
+
+### 계좌이체 에스크로 결제시 결제창에 올바른 이메일을 입력해야 함
+
+존재하지 않는 이메일을 입력할 경우 **이메일 주소 오류**라는 에러 메시지와 함께 승인에 실패합니다.
+또한 실제로 존재하는 이메일 도메인이더라도 나이스페이먼츠 정책상 유효하지 않다고 취급하는
+이메일 주소(예: .finance로 끝나는 이메일 주소)를 입력한 경우 승인은 정상적으로 되지만
+**이후 API로 에스크로 등록시 에스크로 구매 확정 이메일이 전송되지 않습니다.**
+
+<details>
+
+<summary>자세히 보기</summary>
+
+```ts
+IMP.request_pay(
+  {
+    // ...중략
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    pay_method: "trans", // 계좌이체 결제
+    escrow: true, // 에스크로 결제
+  },
+  // 콜백함수
+);
+```
+
+(관련 이미지 첨부)
+
+</details>
+
+## 휴대폰 소액결제
+
+### 실물/컨텐츠 여부(`digital`) 필수 입력
+
+휴대폰 소액결제시 실물/컨텐츠 여부(digital) 파라미터는 필수 입력입니다.
+입력하지 않는 경우 "나이스페이 V2 휴대폰 소액결제시 상품 유형 파라미터는 필수 입력입니다." 라는
+에러 메시지가 뜨면서 결제창이 호출되지 않으니 유의하시기 바랍니다.
+
+|digital|의미  |
+|-------|------|
+|true   |컨텐츠|
+|false  |실물  |
+
+또한 상점 아이디 설정과 실물/컨텐츠 여부가 불일치할 경우 "CPID 설정 오류"라는 메시지가 리턴되며
+결제창 호출에 실패하니 유의하시기 바랍니다.
+
+## 상품권 결제
+
+### 컬쳐랜드(`cultureland`)만 지원
+
+나이스페이먼츠(신모듈)은 상품권 결제시 컬쳐랜드만 지원하며 북앤라이프, 스마트문상 등은 지원하지 않습니다.
+
+### MallUserID(`bypass.nice_v2.MallUserID`)는 필수 입력
+
+나이스페이먼츠(신모듈) 상품권 결제시 고객사 구매자 ID를 의미하는 MalluserID는 필수 입력이며, bypass 파라미터로 전달할 수 있습니다.
+
+### 승인 완료시 나이스페이먼츠로부터 승인번호(`apply_num`)가 전달되지 않음
+
+나이스페이먼츠(신모듈)은 상품권 결제시에는 승인 번호를 전달하지 않아 승인번호 확인이 어렵습니다.
+따라서 결제 내역 조회시 승인 번호는 null로 리턴됩니다.
+
+<details>
+
+<summary>결제내역 조회 API 호출 결과</summary>
+
+```http
+GET /payments/{imp_uid}
+
+{
+  // ...중략
+  "status": "paid",
+  "pay_method": "cultureland",
+  "pg": "nice_v2",
+  "apply_num": null
+}
+```
+
+</details>
+
+## 카카오페이
+
+|기능                                 |사용 가능 여부                                                                                         |
+|-------------------------------------|-------------------------------------------------------------------------------------------------------|
+|상점 부담 무이자 할부                |<span style="color:red"> **불가능** </span>                                                            |
+|다이렉트 호출                        |BC, 국민, 삼성, 신한, 현대, 롯데, 씨티, NH농협 그리고 하나 카드만 가능                                 |
+|다이렉트 호출 + 고정 할부 개월수     |BC, 국민, 삼성, 신한, 현대, 롯데, 씨티, NH농협 그리고 하나 카드만 가능                                 |
+|다이렉트 호출 + 리스트 할부 개월수   |<span style="color:red"> **불가능** </span>                                                            |
+|비 다이렉트 호출 + 고정 할부 개월수  |<span style="color:red"> **단독 사용 불가능** </span> (다이렉트 호출 할 카드사 코드를 함께 전달해야 함)|
+|비 다이렉트 호출 + 리스트 할부 개월수|<span style="color:red"> **불가능** </span>                                                            |
+
+## 네이버페이
+
+|기능                                 |사용 가능 여부                                                                                         |
+|-------------------------------------|-------------------------------------------------------------------------------------------------------|
+|상점 부담 무이자 할부                |<span style="color:red"> **불가능** </span>                                                            |
+|다이렉트 호출                        |BC, 국민, 삼성, 신한, 현대, 롯데, 씨티, NH농협 그리고 하나 카드만 가능                                 |
+|다이렉트 호출 + 고정 할부 개월수     |BC, 국민, 삼성, 신한, 현대, 롯데, 씨티, NH농협 그리고 하나 카드만 가능                                 |
+|다이렉트 호출 + 리스트 할부 개월수   |가능(단, **일시불이 항상 포함** 됨)                                                                    |
+|비 다이렉트 호출 + 고정 할부 개월수  |<span style="color:red"> **단독 사용 불가능** </span> (다이렉트 호출 할 카드사 코드를 함께 전달해야 함)|
+|비 다이렉트 호출 + 리스트 할부 개월수|가능(단, **일시불이 항상 포함** 됨)                                                                    |
+
+### 결제 수단 지정 시 카드 또는 포인트 지정 필요
+
+나이스페이먼츠(신모듈)를 통한 네이버페이 결제 시 카드 또는 포인트 결제를 지정하여 호출해야합니다.
+결제 수단(`pay_method`) 파라미터에 `naverpay` 입력은 불가능하며 `naverpay_card`(카드)
+또는 `naverpay_point`(포인트/머니) 둘 중 하나로 입력해야 정상적으로 결제창이 호출되오니 유의하시기 바랍니다.
+
+### 네이버페이 머니와 포인트 복합 결제시, 포인트가 먼저 사용 됨
+
+네이버페이 포인트 결제시 네이버페이 머니, 포인트 또는 복합(머니와 포인트 함께 사용) 방식으로 결제가 가능하며,
+만약 복합 방식으로 결제할 경우 포인트 금액이 먼저 차감됩니다.
+
+### 네이버페이 포인트 결제시 현금영수증 정보 필수 입력
+
+네이버페이 포인트 결제 시 현금영수증 발급이 가능하며 **현금영수증 정보를 필수로 입력**해야 합니다.
+만약 입력하지 않을 경우 "나이스페이 V2 네이버페이 포인트 결제시 현금영수증 발급 유형은 필수 입력입니다."라는
+에러 메시지가 뜨면서 결제창이 호출되지 않으니 유의하시기 바랍니다.
+단, **네이버페이 머니로 결제할 경우에만 현금영수증이 발급**됩니다.
+결제 금액 모두 네이버페이 포인트로 결제하는 경우에는 결제창 호출시 현금영수증 정보를 전달하더라도 발급되지 않습니다.
+
+## 페이코
+
+|기능                                 |사용 가능 여부                             |
+|-------------------------------------|-------------------------------------------|
+|상점 부담 무이자 할부                |가능                                       |
+|다이렉트 호출                        |가능                                       |
+|다이렉트 호출 + 고정 할부 개월수     |가능                                       |
+|다이렉트 호출 + 리스트 할부 개월수   |가능                                       |
+|비 다이렉트 호출 + 고정 할부 개월수  |<span style="color:red"> **불가능** </span>|
+|비 다이렉트 호출 + 리스트 할부 개월수|가능                                       |
+
+## 삼성페이/11Pay (구.SKPay)/SSGPAY
+
+|기능                                 |사용 가능 여부                             |
+|-------------------------------------|-------------------------------------------|
+|상점 부담 무이자 할부                |가능                                       |
+|다이렉트 호출                        |<span style="color:red"> **불가능** </span>|
+|다이렉트 호출 + 고정 할부 개월수     |<span style="color:red"> **불가능** </span>|
+|다이렉트 호출 + 리스트 할부 개월수   |<span style="color:red"> **불가능** </span>|
+|비 다이렉트 호출 + 고정 할부 개월수  |<span style="color:red"> **불가능** </span>|
+|비 다이렉트 호출 + 리스트 할부 개월수|<span style="color:red"> **불가능** </span>|
+
+## 애플페이/LPAY
+
+|기능                                 |사용 가능 여부                             |
+|-------------------------------------|-------------------------------------------|
+|상점 부담 무이자 할부                |<span style="color:red"> **불가능** </span>|
+|다이렉트 호출                        |<span style="color:red"> **불가능** </span>|
+|다이렉트 호출 + 고정 할부 개월수     |<span style="color:red"> **불가능** </span>|
+|다이렉트 호출 + 리스트 할부 개월수   |<span style="color:red"> **불가능** </span>|
+|비 다이렉트 호출 + 고정 할부 개월수  |<span style="color:red"> **불가능** </span>|
+|비 다이렉트 호출 + 리스트 할부 개월수|<span style="color:red"> **불가능** </span>|
+
+## SSG 은행계좌 결제
+
+### SSGPAY 은행 계좌 결제 시 주문 번호에 특수 문자를 사용 불가능
+
+SSGPAY 정책상 은행 계좌 결제시에는 **주문 번호(`merchant_uid`)에 특수 문자가 허용되지 않습니다.**
+주문 번호에 특수문자 입력 시 "나이스페이 V2 SSGPAY 은행 계좌 결제시 주문 번호에 특수문자는 허용되지 않습니다."와 같은
+에러 메시지가 리턴되면서 결제창이 호출되지 않으니 참고 부탁드립니다.
+
+### SSGPAY 은행 계좌 결제시 현금영수증 정보는 필수 입력
+
+SSGPAY 은행 계좌 거래는 현금성 결제로 현금영수증 발급이 가능하므로 **현금영수증 정보는 필수 입력**입니다.
+만약 입력하지 않을 경우 "나이스페이 V2 SSGPAY 은행 계좌 결제시 현금영수증 발급 유형은 필수 입력입니다."라는
+에러 메시지가 뜨면서 결제창이 호출되지 않으니 유의하시기 바랍니다.
+
+<details>
+
+<summary>파라미터 예시</summary>
+
+```ts
+IMP.request_pay({
+  // ...중략
+  channelKey: "{콘솔 내 연동 정보의 채널키}",
+  pay_method: "ssgpay_bank",
+  bypass: {
+    cashReceiptType: "corporate", // 현금영수증 발급 유형(corporate: 지출증빙, personal: 소득공제)
+    customerIdentifier: "1178178260", // 현금영수증 발행 식별 정보(사업자 등록번호 또는 휴대폰 번호)
+  },
+});
+```
+
+</details>
+
+### SSGPAY 은행 계좌 결제시 현금영수증 발급 정보를 확인할 수 없음
+
+SSGPAY 은행 계좌 결제 시 현금영수증 발급 정보를 입력하여 정상적으로 발급되더라도
+승인 완료(status: paid)시 나이스페이먼츠에서 현금영수증 발급 정보를 전달하지 않아
+포트원 API로 결제/현금영수증 발급 내역 조회 또는 포트원 콘솔에서 현금영수증 내역을 확인할 수 없습니다.
+단, 나이스페이먼츠 어드민에서는 확인이 가능합니다.
+
+<details>
+
+<summary>결제내역 조회 API 호출 결과</summary>
+
+```http
+GET /payments/{imp_uid}
+
+{
+  // ...중략
+  "pay_method": "trans",
+  "emb_pg_provider": "ssgpay",
+  "pg": "nice_v2",
+  "status": "paid",
+  "cash_receipt_issued": false // 실제로는 현금영수증이 발급됐으나 포트원에 정보가 없으므로 false로 내려감
+}
+```
+
+</details>
+
+<details>
+
+<summary>현금영수증 발급 내역 조회 API 호출 결과</summary>
+
+```http
+GET /receipts/{imp_uid}
+
+{
+  "code": -1,
+  "message": "해당 아임포트 고유 번호({아임포트 번호})로 현금영수증을 발급 한 내역이 존재하지 않습니다.",
+  "data": null
+}
+```
+
+</details>
+
+<details>
+
+<summary>V1 콘솔 현금영수증 발급 내역</summary>
+
+(관련 이미지 첨부)
+
+</details>
+
+## 현금영수증
+
+### 현금영수증 발급 유형 지원 여부
+
+현금영수증 발급 유형(`cashReceiptType`)이 소득 공제(`personal`)인 경우,
+현금영수증 발급 유형(`customerIdentifier`)은 휴대폰 번호만 가능하며 주민등록번호 입력시 "현금영수증 식별 번호가 올바르지 않습니다."라는
+에러 메시지가 리턴되며 결제창이 호출되지 않으니 유의하시기 바랍니다.
+
+**계좌이체 다이렉트 호출, 네이버페이 포인트 결제, SSGPAY 은행 계좌 결제시 현금영수증 정보는 필수 입력**입니다.
+
+<details>
+
+<summary>파라미터 예시</summary>
+
+```ts
+IMP.request_pay(
+  {
+    // ...중략
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    pay_method: "naverpay_point", // 네이버페이 포인트 결제
+    bypass: {
+      cashReceiptType: "personal", // 소득공제
+      customerIdentifier: "01012345678", // 핸드폰 번호 입력(주민등록번호 불가능)
+    },
+  },
+  // 콜백함수
+);
+```
+
+</details>
+
+### 가상계좌, 계좌이체 결제 시 현금영수증 파라미터 사용이 불가능한 경우
+
+결제창을 통한 가상계좌 발급 또는 계좌이체 비 다이렉트 호출 시에는 현금영수증 정보를
+파라미터로 전달할 수 없기(전달해도 결제창에 자동 입력되지 않음)때문에 구매자가 결제창에 직접 현금영수증 정보를 입력해야 합니다.