(주)케이에스넷
(주)케이에스넷 결제창 연동 가이드입니다.
Last updated
Was this helpful?
(주)케이에스넷 결제창 연동 가이드입니다.
Last updated
Was this helpful?
Deprecated
이 문서는 더 이상 관리되지 않습니다.
를 이용해주세요.
(주)케이에스넷 결제는 최신 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 파라미터로 결제 상태를 파악하셔야 합니다.
주요 파라미터 설명
pg
* string
PG사 구분코드
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원입니다.
digital
boolean
디지털 상품 유형 여부
bypass.ksnet
KSNET 전용 파라미터
상단의 request_pay
예제를 참고하여 KSNET 전용 파라미터를 기입할 수 있습니다.
sndQpayType
string카드 결제 시 결제창에 간편 결제 수단 표시 여부
"0"
: 간편결제 수단 표시하지 않음
"1"
: 간편결제 수단 표시함
product_type
, buyer_name
파라미터는 KSPAY 필수 입력 대상입니다.
product_type
, pg
, buyer_name
파라미터는 KSPAY 필수 입력 대상입니다.
파라미터 설명
card_quota :
[]
: 일시불만 결제 가능
2,3,4,5,6
: 일시불을 포함한 2, 3, 4, 5, 6개월까지 할부개월 선택 가능\
할부개월수 3개월까지 활성화 예제
페이지의 내용을 참고하여 PG 설정을 진행합니다.
IMP.request_pay(param, callback)을 호출하여 KSNET 결제창을 호출할 수 있습니다. 결제결과는 PC의 경우 IMP.request_pay(param, callback) 호출 후 callback으로 수신되고 모바일의 경우 m_redirect_url로 리디렉션됩니다.
기존 JavaScript SDK를 사용 중이신 경우 문서를 참고하여 업데이트를 진행해주세요.
REST 을 호출하여 일회성 결제를 요청합니다. 요청 시 전달된 카드는 포트원에 등록되지 않습니다.
REST 를 호출하여 빌링키 발급을 요청합니다.
REST 을 호출하여 빌링키 발급과 최초 결제를 요청합니다.
빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 customer_uid
와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 customer_uid
를 이용해서 재결제() REST API를 다음과 같이 호출합니다.
결제 승인 완료 건에 대해 승인 취소(환불)를 할 수 있는 API입니다. REST 를 호출하여 승인 취소(환불)을 요청합니다.
포트원을 통한 거래건이지만 결제창에서 현금영수증 등록을 하지 못한 경우 API를 통해 현금영수증을 등록할 수 있습니다. REST 를 호출하여 현금영수증을 요청합니다.
포트원을 통한 거래건이 아닌 현금성 거래의 경우에도 API를 통해 현금영수증을 등록할 수 있습니다. REST 를 호출하여 현금영수증을 요청합니다.