Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

신나이스 결제창 빌링키발급 내용 삭제 #417

Merged
merged 1 commit into from
Apr 17, 2024
Merged

신나이스 결제창 빌링키발급 내용 삭제 #417

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
185 changes: 82 additions & 103 deletions src/content/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,8 @@ description: (신)나이스페이먼츠 비인증 결제 연동 유의사항을
---

import Details from "~/components/gitbook/Details.astro";
import Figure from "~/components/Figure.astro";

# API 지원 기능
## API 지원 기능

- 빌링키 발급
- 빌링키 결제
Expand All @@ -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개의 파라미터를 추가로 지원합니다.

<Details>
<p slot="summary">자세히 보기</p>

import screenshot1 from "./_assets/caution/issue-billing-key-window.png";

<Figure src={screenshot1} />

</Details>

### 빌링키 발급 취소 시 빌링키 발급 창 닫히지 않음

(신) 나이스페이먼츠 빌링키 발급 창 내 취소 버튼을 누르면 얼럿트 창이 뜨는데, 이때 확인 버튼을 눌러도 빌링키 발급 창이 닫히지 않습니다. 이는 포트원과는 무관하오니 연동 시 참고 부탁드립니다.

<Details>
<p slot="summary">자세히 보기</p>

import screenshot2 from "./_assets/caution/issue-billing-key-window-with-alert.png";

<Figure src={screenshot2} />

</Details>

# 비인증 결제
|파라미터 |데이터 타입 |의미 |
|-----------------------------|----------------------|---------------------------------------------------------------------------------------------------|
|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}`)시 발급 받을 현금영수증 정보(현금영수증 발급 유형,
현금영수증 발행 식별 정보, 현금영수증 발행 식별 정보 유형)를 전달해야 합니다.
단, (신) 나이스페이먼츠의 경우 **현금영수증 카드 번호로 현금영수증 발급이 불가능**하오니 참고 부탁드립니다.

<Details>
<p slot="summary">[가능] 사업자 등록번호로 지출증빙용 현금영수증 발급</p>

```javascript
// POST /receipts/{imp_uid}

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

<p slot="summary">\[가능] 사업자 등록번호로 지출증빙용 현금영수증 발급</p>

```json
// POST /receipts/{imp_uid}

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

<Details>
<p slot="summary">[가능] 휴대폰 번호로 소득공제용 현금영수증 발급</p>

```javascript
// POST /receipts/{imp_uid}

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

<p slot="summary">\[가능] 휴대폰 번호로 소득공제용 현금영수증 발급</p>

```json
// POST /receipts/{imp_uid}

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

<Details>
<p slot="summary">[가능] 주민등록번호로 소득공제용 현금영수증 발급</p>

```javascript
// POST /receipts/{imp_uid}

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

<p slot="summary">\[가능] 주민등록번호로 소득공제용 현금영수증 발급</p>

```json
// POST /receipts/{imp_uid}

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

<Details>
<p slot="summary">[불가능] 현금영수증 카드번호로 소득공제용 현금영수증 발급</p>

```javascript
// POST /receipts/{imp_uid}

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

<p slot="summary">\[불가능] 현금영수증 카드번호로 소득공제용 현금영수증 발급</p>

```json
// POST /receipts/{imp_uid}

{
// ...중략
type: "personal", // 현금영수증 발급 유형: 소득공제
identifier: "123456789012", // 현금영수증 발행 식별 정보: 현금영수증 카드번호
identifier_type: "taxcard" // 현금영수증 발행 식별 정보 유형: 현금영수증 카드번호
}
```
</Details>
2 changes: 1 addition & 1 deletion src/content/docs/ko/tip/pg.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 | - |
Expand Down