⌨
(주)케이에스넷
(주)케이에스넷 결제창 연동 가이드입니다.

(주)케이에스넷
JavaScript SDK (신규)) IMP.request_pay(param, callback)을 호출하여 KSNET 결제창을 호출할 수 있습니다. 결제결과는 PC의 경우 IMP.request_pay(param, callback) 호출 후 callback으로 수신되고 모바일의 경우 m_redirect_url로 리디렉션됩니다.
(주)케이에스넷 결제는 최신 SDK에서만 지원되는 기능입니다.
JS SDK
<script src="https://cdn.iamport.kr/v1/iamport.js"></script>
(주)케이에스넷을 연동하기 위해서는 위에 안내된 JS SDK를 이용하셔야 합니다
기존에 deprecated된 응답들은 모두 제거됐습니다. ⚠️
케이에스넷 연동시에 사용되는 신규 JS SDK는 기존 모듈에서 제공했던 CallBack 파라미터가 대부분 삭제되었습니다.(특히 dprecated 로 명시된 파라미터는 모두 삭제되었습니다.)
해당 JS SDK 사용시 Callback 으로 내려받을수 있는 데이터는 오직 아래 두가지 입니다.
imp_uid, merchant_uid
따라서 해당 SDK를 사용하실때는 IMP.request_pay로부터 응답된 객체(또는 쿼리 파라미터)에서 imp_uid를 가지고 아임포트 REST API(GET /payments/imp_uid)로 결제 상세 내역(승인 상태, 승인 결과 등등)을 조회하여 응답파라미터중 status 파라미터로 결제 상태를 파악하셔야 합니다.
<script src="https://cdn.iamport.kr/v1/iamport.js"></script>
위 JS SDK 를 이용하여 토스페이먼츠,케이에스넷 연동시 callback Data는
아래와 같이 두가지 형태로만 내려갑니다.
imp_uid
merchant_uid
위 PG사를 제외한 다른 PG사는 imp_success 파라미터가 기존처럼 내려가지만
해당 파리미터는 deprecated 된 값이기 때문에 해당 값에 의존성을 가진 프로그램 로직은 모두 삭제하시는
방향성을 잡아가셔야 하는점 유념하시기 바랍니다.
인증결제창 요청
비인증 결제창 요청
API 결제
Javascript SDK
IMP.request_pay({
pg: "ksnet.{PG 상점 아이디}", // 테스트인경우 ksnet.2999199999
pay_method: "card",
merchant_uid: "order_id_1667634130160", // 상점에서 채번하는 고유 주문 번호
name: "나이키 와플 트레이너 2 SD",
pay_method: "card",
escrow: false,
amount: "109000",
tax_free: 3000,
buyer_name: "홍길동",
buyer_email: "[email protected]",
buyer_tel: "02-1670-5176",
buyer_addr: "성수이로 20길 16",
buyer_postcode: "04783",
app_scheme: "portone://",
m_redirect_url: "https://helloworld.com/payments/result",
notice_url: "https://helloworld.com/api/v1/payments/notice",
confirm_url: "https://helloworld.com/api/v1/payments/confirm",
currency: "KRW",
digital: false,
period: {
from: "2022-12-01",
to: "2023-01-01",
},
custom_data: { userId: 30930 },
display: { card_quota: [0, 6] },
bypass: {
ksnet: {
sndQpayType: "0",
},
},
}, function (rsp) { // callback 로직
//* ...중략... *//
});
주요 파라미터 설명
pg
* stringPG사 구분코드
ksnet.{PG 상점 아이디}
pay_method
* string결제수단 구분코드
- card (신용카드)
- vbank (가상계좌)
- trans (계좌이체)
- phone (휴대폰소액결제)
- lpay (LPAY)
- ssgpay (SSGPAY)
- kakaopay (카카오페이)
- naverpay (네이버페이)
- payco (페이코 허브형)
merchant_uid
* string가맹점 채번 주문 고유번 호
가맹점에서 매번 고유하게 채번되어야 합니다.
amount
string결제금액
지정하지 않은 경우 0원입니다.
tax_free
integer면세금액
지정하지 않은 경우 0원입니다.
포트원을 통해 KSNET를 사용하는 경우 과세 설정이