diff --git a/src/content/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution.mdx b/src/content/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution.mdx index 195b527d1..36992a546 100644 --- a/src/content/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution.mdx +++ b/src/content/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution.mdx @@ -4,9 +4,8 @@ description: (신)나이스페이먼츠 비인증 결제 연동 유의사항을 --- import Details from "~/components/gitbook/Details.astro"; -import Figure from "~/components/Figure.astro"; -# API 지원 기능 +## API 지원 기능 - 빌링키 발급 - 빌링키 결제 @@ -17,144 +16,124 @@ import Figure from "~/components/Figure.astro"; - 가상계좌 발급, 회수(수정 불가능) - 포트원 외부 결제 건 현금영수증 발급, 조회, 취소 -# 빌링키 발급 +## 빌링키 발급 -(신) 나이스페이먼츠 빌링키 발급은 PG사 창을 통한 방식과 API 방식(POST /subscrie/customers/"customer_uid") 둘 다 지원합니다. +(신) 나이스페이먼츠 빌링키 발급은 API 방식(POST /subscrie/customers/"customer\_uid")만 지원합니다. -### 빌링키 발급 창 CSS 이슈 존재 +## 비인증 결제 -(신) 나이스페이먼츠 빌링키 발급 창 내 CSS 이슈로 인해 빌링키 발급 창이 다소 부자연스럽게 노출되고 있으나 포트원과는 무관한 이슈이오니 참고 부탁드립니다. +(신) 나이스페이먼츠는 발급 된 빌링키로 재결제(`POST /subscribe/payemnts/again`), +키인 결제(`POST /subscribe/payments/onetime`) 그리고 스케줄 결제(`POST /subscribe/payments/schedule`)를 +모두 지원하며 기본 파라미터 외에 아래 3개의 파라미터를 추가로 지원합니다. -
-

자세히 보기

- -import screenshot1 from "./_assets/caution/issue-billing-key-window.png"; - -
- -
- -### 빌링키 발급 취소 시 빌링키 발급 창 닫히지 않음 - -(신) 나이스페이먼츠 빌링키 발급 창 내 취소 버튼을 누르면 얼럿트 창이 뜨는데, 이때 확인 버튼을 눌러도 빌링키 발급 창이 닫히지 않습니다. 이는 포트원과는 무관하오니 연동 시 참고 부탁드립니다. - -
-

자세히 보기

- -import screenshot2 from "./_assets/caution/issue-billing-key-window-with-alert.png"; - -
- -
- -# 비인증 결제 +|파라미터 |데이터 타입 |의미 | +|-----------------------------|----------------------|---------------------------------------------------------------------------------------------------| +|vat\_amount |double |총 결제 금액 중 부가세 금액. 부가세 직접 입력 방식을 위해 사용. 단, 나이스페이먼츠와 사전 협의 필요| +|intereset\_free\_by\_merchant|boolean(기본값: false)|상점 부담 무이자 할부 적용 여부. 단, 나이스페이먼츠와 사전 협의 필요 | +|use\_card\_point |boolean(기본값: false)|카드사 포인트 사용 여부. 단, 나이스페이먼츠와 사전 협의 필요 | -(신) 나이스페이먼츠는 발급 된 빌링키로 재결제(`POST /subscribe/payemnts/again`), 키인 결제(`POST /subscribe/payments/onetime`) 그리고 스케줄 결제(`POST /subscribe/payments/schedule`)를 모두 지원하며 기본 파라미터 외에 아래 3개의 파라미터를 추가로 지원합니다. - -| 파라미터 | 데이터 타입 | 의미 | -| -------------------------- | ---------------------- | ----------------------------------------------------------------------------------------------- | -| vat_amount | double | 총 결제 금액 중 부가세 금액. 부가세 직접 입력 방식을 위해 사용. 단, 나이스페이먼츠와 사전 협의 필요 | -| intereset_free_by_merchant | boolean(기본값: false) | 상점 부담 무이자 할부 적용 여부. 단, 나이스페이먼츠와 사전 협의 필요 | -| use_card_point | boolean(기본값: false) | 카드사 포인트 사용 여부. 단, 나이스페이먼츠와 사전 협의 필요 | - -# 가상계좌 +## 가상계좌 ### 가상계좌 API 발급시 `business_registration_number` 파라미터 추가 지원 -| 파라미터 | 데이터 타입 | 의미 | -| ---------------------------- | ----------- | ----------------------- | -| business_registration_number | string | 구매자 사업자 등록 번호 | +|파라미터 |데이터 타입|의미 | +|------------------------------|-----------|-----------------------| +|business\_registration\_number|string |구매자 사업자 등록 번호| -(신) 나이스페이먼츠의 경우 API를 통한 가상 계좌 발급 시, 향후 해당 거래 건을 에스크로 배송 정보로 등록할 때 사용될 구매자의 사업자 번호를 `business_registration_number` 파라미터로 입력받고 있습니다. +(신) 나이스페이먼츠의 경우 API를 통한 가상 계좌 발급 시, 향후 해당 거래 건을 에스크로 배송 정보로 등록할 때 +사용될 구매자의 사업자 번호를 `business_registration_number` 파라미터로 입력받고 있습니다. ### API로 가상계좌 채번은 가능하나 발급된 가상계좌 정보는 수정 불가능 -(신) 나이스페이먼츠는 `POST /vbanks` API로 가상 계좌를 채번 할 수 있지만 `PUT /vbanks` API로 **이미 채번 된 가상계좌 정보(입금 기한, 입금 금액)를 수정할 수 없습니다.** +(신) 나이스페이먼츠는 `POST /vbanks` API로 가상 계좌를 채번 할 수 있지만 `PUT /vbanks` API로 +**이미 채번 된 가상계좌 정보(입금 기한, 입금 금액)를 수정할 수 없습니다.** -# 에스크로 결제 +## 에스크로 결제 ### 배송 정보 등록시 `send_email` 파라미터 추가 지원 -| 파라미터 | 데이터 타입 | 의미 | -| ---------- | ----------- | ----------------------------------------------------------------------------------------- | -| send_email | boolean | 에스크로 구매 확정시 결제 창에 입력했던 이메일로 해당 사실을 전송할지 여부 (기본값: true) | +|파라미터 |데이터 타입|의미 | +|-----------|-----------|-----------------------------------------------------------------------------------------| +|send\_email|boolean |에스크로 구매 확정시 결제 창에 입력했던 이메일로 해당 사실을 전송할지 여부 (기본값: true)| -(신) 나이스페이먼츠의 경우 에스크로 결제건에 대해 배송 정보 등록 API 호출 시 `send_email` 파라미터를 이용하여 구매 확정됐을 때 결제창에 입력한 이메일로 구매 확정 내용을 전송할지 여부를 제어할 수 있습니다. 기본 값은 true(구매 확정 여부 이메일 전송)이며 false로 입력 시 구매가 확정되어도 이메일로 안내되지 않습니다. +(신) 나이스페이먼츠의 경우 에스크로 결제건에 대해 배송 정보 등록 API 호출 시 `send_email` 파라미터를 +이용하여 구매 확정됐을 때 결제창에 입력한 이메일로 구매 확정 내용을 전송할지 여부를 제어할 수 있습니다. +기본 값은 true(구매 확정 여부 이메일 전송)이며 false로 입력 시 구매가 확정되어도 이메일로 안내되지 않습니다. ### 배송 정보 수정 불가 (신) 나이스페이먼츠는 `POST /escrow/logis/{imp_uid}` API로 에스크로 배송 정보 등록은 가능하지만 `PUT /escrow/logis/{imp_uid}` API로 **수정은 불가능**합니다. -# 현금영수증 +## 현금영수증 ### 결제창에서 발급 받지 못한 현금영수증은 API로 발급 불가능 -(신) 나이스페이먼츠의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서 현금영수증을 발급 요청할 수 있습니다. 이때 결제 승인 단계에서 현금영수증을 발급 요청하지 못한 경우, 현금영수증 발급 API(`POST /receipts/"imp_uid"`)를 사용한다고 하더라도 발급이 되지 않으니 참고 부탁드립니다. +(신) 나이스페이먼츠의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서 +현금영수증을 발급 요청할 수 있습니다. 이때 결제 승인 단계에서 현금영수증을 발급 요청하지 못한 경우, +현금영수증 발급 API(`POST /receipts/"imp_uid"`)를 사용한다고 하더라도 발급이 되지 않으니 참고 부탁드립니다. ### API로 현금영수증 발급 시, 현금영수증 카드 사용 불가능 -API로 현금영수증 발급(`POST /receipts/{imp_uid}`)시 발급 받을 현금영수증 정보(현금영수증 발급 유형, 현금영수증 발행 식별 정보, 현금영수증 발행 식별 정보 유형)를 전달해야 합니다. 단, (신) 나이스페이먼츠의 경우 **현금영수증 카드 번호로 현금영수증 발급이 불가능**하오니 참고 부탁드립니다. +API로 현금영수증 발급(`POST /receipts/{imp_uid}`)시 발급 받을 현금영수증 정보(현금영수증 발급 유형, +현금영수증 발행 식별 정보, 현금영수증 발행 식별 정보 유형)를 전달해야 합니다. +단, (신) 나이스페이먼츠의 경우 **현금영수증 카드 번호로 현금영수증 발급이 불가능**하오니 참고 부탁드립니다.
-

[가능] 사업자 등록번호로 지출증빙용 현금영수증 발급

- -```javascript -// POST /receipts/{imp_uid} - -{ - // ...중략 - type: "company", // 현금영수증 발급 유형: 지출증빙 - identifier: "1178178260", // 현금영수증 발행 식별 정보: 사업자 등록번호 - identifier_type: "business", // 현금영수증 발행 식별 정보 유형: 사업자 등록번호 -} -``` - +

\[가능] 사업자 등록번호로 지출증빙용 현금영수증 발급

+ + ```json + // POST /receipts/{imp_uid} + + { + // ...중략 + type: "company", // 현금영수증 발급 유형: 지출증빙 + identifier: "1178178260", // 현금영수증 발행 식별 정보: 사업자 등록번호 + identifier_type: "business" // 현금영수증 발행 식별 정보 유형: 사업자 등록번호 + } + ```
-

[가능] 휴대폰 번호로 소득공제용 현금영수증 발급

- -```javascript -// POST /receipts/{imp_uid} - -{ - // ...중략 - type: "personal", // 현금영수증 발급 유형: 소득공제 - identifier: "01012345678", // 현금영수증 발행 식별 정보: 휴대폰 번호 - identifier_type: "phone", // 현금영수증 발행 식별 정보 유형: 휴대폰 번호 -} -``` - +

\[가능] 휴대폰 번호로 소득공제용 현금영수증 발급

+ + ```json + // POST /receipts/{imp_uid} + + { + // ...중략 + type: "personal", // 현금영수증 발급 유형: 소득공제 + identifier: "01012345678", // 현금영수증 발행 식별 정보: 휴대폰 번호 + identifier_type: "phone" // 현금영수증 발행 식별 정보 유형: 휴대폰 번호 + } + ```
-

[가능] 주민등록번호로 소득공제용 현금영수증 발급

- -```javascript -// POST /receipts/{imp_uid} - -{ - // ...중략 - type: "personal", // 현금영수증 발급 유형: 소득공제 - identifier: "9010102012345", // 현금영수증 발행 식별 정보: 주민등록번호 - identifier_type: "person", // 현금영수증 발행 식별 정보 유형: 주민등록번호 -} -``` - +

\[가능] 주민등록번호로 소득공제용 현금영수증 발급

+ + ```json + // POST /receipts/{imp_uid} + + { + // ...중략 + type: "personal", // 현금영수증 발급 유형: 소득공제 + identifier: "9010102012345", // 현금영수증 발행 식별 정보: 주민등록번호 + identifier_type: "person" // 현금영수증 발행 식별 정보 유형: 주민등록번호 + } + ```
-

[불가능] 현금영수증 카드번호로 소득공제용 현금영수증 발급

- -```javascript -// POST /receipts/{imp_uid} - -{ - // ...중략 - type: "personal", // 현금영수증 발급 유형: 소득공제 - identifier: "123456789012", // 현금영수증 발행 식별 정보: 현금영수증 카드번호 - identifier_type: "taxcard", // 현금영수증 발행 식별 정보 유형: 현금영수증 카드번호 -} -``` - +

\[불가능] 현금영수증 카드번호로 소득공제용 현금영수증 발급

+ + ```json + // POST /receipts/{imp_uid} + + { + // ...중략 + type: "personal", // 현금영수증 발급 유형: 소득공제 + identifier: "123456789012", // 현금영수증 발행 식별 정보: 현금영수증 카드번호 + identifier_type: "taxcard" // 현금영수증 발행 식별 정보 유형: 현금영수증 카드번호 + } + ```
diff --git a/src/content/docs/ko/tip/pg.mdx b/src/content/docs/ko/tip/pg.mdx index 55e44c840..2126b596e 100644 --- a/src/content/docs/ko/tip/pg.mdx +++ b/src/content/docs/ko/tip/pg.mdx @@ -15,7 +15,7 @@ import Hint from "~/components/Hint.astro"; | 결제대행사 |코드값(pg provider)|결제창 방식|API 방식| 발급과 동시에 결제 기능 (결제창기준) | |:---------------------:|:-----------------:|:---------:|:------:|:--------------------------------------------------------------:| | 나이스페이먼츠(구모듈)| nice | X | O | - | -| 나이스페이먼츠(신모듈)| nice\_v2 | O | O | 불가능 | +| 나이스페이먼츠(신모듈)| nice\_v2 | X | O | - | | 토스페이먼츠(신모듈) | tosspayments | O | O | 불가능 | | KCP | kcp\_billing | O | X | 불가능 | | KCP | kcp | X | O | - |