Skip to content

Commit

Permalink
v1 상점부담 무이자 파라미터 설명 추가
Browse files Browse the repository at this point in the history
- SDK > 결제요청 파라미터 와 V1 KSNET 연동 가이드에 상점 부담 무이자
파라미터 및 설정 방법에 대한 가이드 추가
  • Loading branch information
moonjihae committed Dec 2, 2024
1 parent 05fec82 commit 1c7a226
Show file tree
Hide file tree
Showing 2 changed files with 88 additions and 0 deletions.
50 changes: 50 additions & 0 deletions src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -177,6 +177,12 @@ KSNET 결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우

**카드 결제시, 카드 결제창에 앱카드만 선택 가능하도록 할지 여부 (기본값: **false**)**

**`useFreeInterestFromMall`** <mark style="color:orange;">**boolean**</mark>

**상점 부담 무이자 할부 사용 여부**

고객사가 부담하는 무이자 할부 여부를 설정 할 수 있습니다.

**`display`** <mark style="color:blue;">**object**</mark>

**결제창에 렌더링될 카드 할부 개월수 리스트 설정**
Expand Down Expand Up @@ -333,6 +339,22 @@ curl -H "Content-Type: application/json" \
}
```

상점 부담 무이자 할부의 경우 card.detail 파라미터를 사용하여 최대 할부개월수 설정이 가능합니다.
```json

Check failure on line 343 in src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx

View workflow job for this annotation

GitHub Actions / Lint code and MDX files

Unexpected `0` blank lines between nodes, expected `1` or more blank lines, add `1` blank line
{
"card": {
"detail": [
{ "card_code": "366", "max_month": 5}, // 특정 카드사 (신한카드) 상점 부담 무이자 최대 5개월 할부 설정

Check failure on line 347 in src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx

View workflow job for this annotation

GitHub Actions / Lint code and MDX files

Replace `·"366",·"max_month":·5` with `"366",·"max_month":·5·`
{ "card_code": "381", "max_month": 3} // 특정 카드사 (KB국민카드) 상점 부담 무이자 최대 3개월 할부 설정

Check failure on line 348 in src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx

View workflow job for this annotation

GitHub Actions / Lint code and MDX files

Replace `·"381",·"max_month":·3` with `"381",·"max_month":·3·`
]
}
}
```
<Hint style="info">

Check failure on line 353 in src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx

View workflow job for this annotation

GitHub Actions / Lint code and MDX files

Unexpected `0` blank lines between nodes, expected `1` or more blank lines, add `1` blank line
KB 앱카드 결제 시, card.useInstallment 파라미터 true 설정 시에만 할부 개월 수 설정이 가능합니다.
</Hint>
자세한 상점 부담 무이자 할부 설정 가이드는 [[API&SDK] - [브라우저 SDK] - [결제요청 파라미터] - \[상점 부담 무이자 할부 최대 개월수 설정하기](/sdk/ko/v1-sdk/javascript-sdk/payrq?v=v1#상점-부담-무이자-할부-최대-개월수-설정하기) 에서 확인 가능합니다.

Check failure on line 356 in src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx

View workflow job for this annotation

GitHub Actions / Lint code and MDX files

Unexpected `0` blank lines between nodes, expected `1` or more blank lines, add `1` blank line

Check failure on line 356 in src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx

View workflow job for this annotation

GitHub Actions / Lint code and MDX files

Unexpected reference to undefined definition, expected corresponding definition (`api&sdk`) for a link or escaped opening bracket (`\[`) for regular text

Check failure on line 356 in src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx

View workflow job for this annotation

GitHub Actions / Lint code and MDX files

Unexpected reference to undefined definition, expected corresponding definition (`브라우저 sdk`) for a link or escaped opening bracket (`\[`) for regular text

Check failure on line 356 in src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx

View workflow job for this annotation

GitHub Actions / Lint code and MDX files

Unexpected reference to undefined definition, expected corresponding definition (`결제요청 파라미터`) for a link or escaped opening bracket (`\[`) for regular text

**파라미터 설명**

<ParamTree>
Expand All @@ -348,6 +370,34 @@ curl -H "Content-Type: application/json" \
`[0]` : 일시불
`[2,3,4]` : 2,3,4 개월
</ParamTree>

`useFreeInterestFromMall` <mark style="color:orange;">**boolean**</mark>

**상점 부담 무이자 할부 사용 여부**

`card` <mark style="color:blue;">**object**</mark>

**카드 결제시, 카드 결제에 대한 세부 정보 설정**

<ParamTree>
- `useInstallment` <mark style="color:orange;">**boolean**</mark>

**할부 가능 여부**

- `detail` <mark style="color:blue;">**array**</mark>

**카드사 렌더링 정보**

<ParamTree>
- `card_code` <mark style="color:green;">**string**</mark>

**카드사 코드**

- `max_month` <mark style="color:purple;">**number**</mark>

**상점 부담 무이자 할부 최대 개월수**
</ParamTree>
</ParamTree>
</ParamTree>

<Hint style="info">
Expand Down
38 changes: 38 additions & 0 deletions src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -345,6 +345,12 @@ PG사별 지원되는 결제수단이 모두 상이합니다.

- 다날 가상계좌 결제수단 사용 시 필수 항목입니다.

### **`useFreeInterestFromMall`** <mark style="color:orange;">**boolean**</mark>

**상점 부담 무이자 할부 사용 여부**

고객사가 부담하는 무이자 할부 여부를 설정 할 수 있습니다.

## 부가기능

### 원하는 할부개월수만 활성화하기
Expand Down Expand Up @@ -412,3 +418,35 @@ const param = {

- **card\_code :** 금결원 카드사 코드 [<mark style="color:red;">**링크**</mark>](/opi/ko/support/code-info/card-code) 참조 (<mark style="color:green;">**string)**</mark>
- **enabled :** 해당 카드 활성화 여부 (<mark style="color:orange;">**boolean)**</mark>

### 상점 부담 무이자 할부 최대 개월수 설정하기

```json
{
"card": {
"detail": [
{ "card_code": "366", "max_month": 5}, // 특정 카드사 (신한카드) 상점 부담 무이자 최대 5개월 할부 설정

Check failure on line 428 in src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx

View workflow job for this annotation

GitHub Actions / Lint code and MDX files

Replace `·"366",·"max_month":·5` with `"366",·"max_month":·5·`
{ "card_code": "381", "max_month": 3} // 특정 카드사 (KB국민카드) 상점 부담 무이자 최대 3개월 할부 설정
]
},
"useFreeInterestFromMall" : true
}
```

**파라미터 설명**
- **useFreeInterestFromMall :** 상점 부담 무이자 할부 사용 여부 (<mark style="color:orange;">**boolean)**</mark>
- **card.detail.card_code :** 금결원 카드사 코드 [<mark style="color:red;">**링크**</mark>](/opi/ko/support/code-info/card-code) 참조 (<mark style="color:green;">**string)**</mark>
- **card.detail.max_month :** 상점 부담 무이자 할부 최대 개월수 (<mark style="color:purple;">**number)**</mark>

<Details>
<Details.Summary>지원되는 PG사</Details.Summary>

<Details.Content>
- 토스페이먼츠(신모듈)
- KSNET
- 나이스페이(신모듈)
- 웰컴페이먼츠
- KSNET 카드 다이렉트
- 이니시스
</Details.Content>
</Details>

0 comments on commit 1c7a226

Please sign in to comment.