diff --git a/src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx b/src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx index fe067ef7d..b46c2e46b 100644 --- a/src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx +++ b/src/routes/(root)/opi/ko/integration/pg/v1/ksnet/readme.mdx @@ -177,6 +177,12 @@ KSNET 결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우 **카드 결제시, 카드 결제창에 앱카드만 선택 가능하도록 할지 여부 (기본값: **false**)** + **`useFreeInterestFromMall`** **boolean** + + **상점 부담 무이자 할부 사용 여부** + + 고객사가 부담하는 무이자 할부 여부를 설정 할 수 있습니다. + **`display`** **object** **결제창에 렌더링될 카드 할부 개월수 리스트 설정** @@ -333,6 +339,22 @@ curl -H "Content-Type: application/json" \ } ``` +상점 부담 무이자 할부의 경우 card.detail 파라미터를 사용하여 최대 할부개월수 설정이 가능합니다. +```json +{ + "card": { + "detail": [ + { "card_code": "366", "max_month": 5}, // 특정 카드사 (신한카드) 상점 부담 무이자 최대 5개월 할부 설정 + { "card_code": "381", "max_month": 3} // 특정 카드사 (KB국민카드) 상점 부담 무이자 최대 3개월 할부 설정 + ] + } +} +``` + + KB 앱카드 결제 시, card.useInstallment 파라미터 true 설정 시에만 할부 개월 수 설정이 가능합니다. + +자세한 상점 부담 무이자 할부 설정 가이드는 [[API&SDK] - [브라우저 SDK] - [결제요청 파라미터] - \[상점 부담 무이자 할부 최대 개월수 설정하기](/sdk/ko/v1-sdk/javascript-sdk/payrq?v=v1#상점-부담-무이자-할부-최대-개월수-설정하기) 에서 확인 가능합니다. + **파라미터 설명** @@ -348,6 +370,34 @@ curl -H "Content-Type: application/json" \ `[0]` : 일시불 `[2,3,4]` : 2,3,4 개월 + + `useFreeInterestFromMall` **boolean** + + **상점 부담 무이자 할부 사용 여부** + + `card` **object** + + **카드 결제시, 카드 결제에 대한 세부 정보 설정** + + + - `useInstallment` **boolean** + + **할부 가능 여부** + + - `detail` **array** + + **카드사 렌더링 정보** + + + - `card_code` **string** + + **카드사 코드** + + - `max_month` **number** + + **상점 부담 무이자 할부 최대 개월수** + + diff --git a/src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx b/src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx index afc3fc232..b6e250e73 100644 --- a/src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx +++ b/src/routes/(root)/sdk/ko/v1-sdk/javascript-sdk/payrq.mdx @@ -345,6 +345,12 @@ PG사별 지원되는 결제수단이 모두 상이합니다. - 다날 가상계좌 결제수단 사용 시 필수 항목입니다. +### **`useFreeInterestFromMall`** **boolean** + +**상점 부담 무이자 할부 사용 여부** + +고객사가 부담하는 무이자 할부 여부를 설정 할 수 있습니다. + ## 부가기능 ### 원하는 할부개월수만 활성화하기 @@ -412,3 +418,35 @@ const param = { - **card\_code :** 금결원 카드사 코드 [**링크**](/opi/ko/support/code-info/card-code) 참조 (**string)** - **enabled :** 해당 카드 활성화 여부 (**boolean)** + +### 상점 부담 무이자 할부 최대 개월수 설정하기 + +```json +{ + "card": { + "detail": [ + { "card_code": "366", "max_month": 5}, // 특정 카드사 (신한카드) 상점 부담 무이자 최대 5개월 할부 설정 + { "card_code": "381", "max_month": 3} // 특정 카드사 (KB국민카드) 상점 부담 무이자 최대 3개월 할부 설정 + ] + }, + "useFreeInterestFromMall" : true +} +``` + +**파라미터 설명** +- **useFreeInterestFromMall :** 상점 부담 무이자 할부 사용 여부 (**boolean)** +- **card.detail.card_code :** 금결원 카드사 코드 [**링크**](/opi/ko/support/code-info/card-code) 참조 (**string)** +- **card.detail.max_month :** 상점 부담 무이자 할부 최대 개월수 (**number)** + +
+ 지원되는 PG사 + + + - 토스페이먼츠(신모듈) + - KSNET + - 나이스페이(신모듈) + - 웰컴페이먼츠 + - KSNET 카드 다이렉트 + - 이니시스 + +