LITE PAY

LITE PAY 연동하기

LITE PAY는 HTTPS JSON API와 결제창 URL 이동만으로 결제를 연동할 수 있는 간편 연동 방식입니다.

PC와 Mobile 환경을 별도로 분기하지 않고 reg_type 값으로 결제창 유형을 선택할 수 있습니다.
결제창 인증이 완료되면 가맹점의 ret_URL로 인증 결과가 전달되고, 가맹점 서버에서 최종 승인 요청을 처리합니다.

LITE PAY 특징

PC·Mobile 통합 흐름

reg_type 값으로 PC와 Mobile 결제창을 선택하므로 환경별 구현 흐름이 단순합니다.

결제정보 검증

가맹점 DB에 저장한 금액·결제수단·주문번호를 승인 요청 시 함께 전달하여 위변조를 방지합니다.

1. 거래등록 하기

첫 번째로 주문·결제 정보를 NHN KCP 결제 서버에 등록합니다.
거래등록 시 reg_type 파라미터 값으로 PC(web)·Mobile(mobile) 결제창을 선택하면, 해당 환경에 맞는 pay_url(결제창 주소)이 리턴됩니다.
pay_url에 파라미터를 추가하거나 임의로 가공하면 결제창이 정상적으로 열리지 않을 수 있습니다.

거래등록 요청과 응답 파라미터는 API Reference > 거래등록(LITE PAY)을 확인하세요.

PC 결제창

reg_type을 web으로 요청하면 PC에 최적화된 결제창 URL이 리턴됩니다. 팝업이 아닌 전체 페이지 전환 방식으로 호출하세요.

모바일 결제창

reg_type을 mobile로 요청하면 모바일에 최적화된 URL이 리턴됩니다. 카드사 앱 연동을 위해 리다이렉트 방식으로 호출하세요.

2. 결제창 호출하기

거래등록에서 응답받은 pay_url을 통해 결제창을 실행합니다.
NHN KCP가 제공하는 결제창을 사용하므로 가맹점이 별도의 결제 UI를 개발할 필요가 없습니다.

pay_url은 반드시 페이지 전환(리다이렉트) 방식으로 호출하세요.
iframe이나 팝업 방식으로 호출하면 일부 카드사 앱 연동이나 브라우저 환경에 따라 결제가 원활하게 진행되지 않을 수 있습니다.

결제창 호출 파라미터

ordr_idxx필수string50

가맹점에서 관리하는 주문번호입니다. 중복되지 않는 유니크한 값으로 사용하고, 가맹점에서 반드시 저장합니다.
LITE PAY에서는 거래등록 요청 시 사용한 값을 변경하지 않고 그대로 전달합니다.ex) "ordr_idxx" : "TEST123456789"

shop_user_id필수string50

쇼핑몰에서 관리하는 회원 ID입니다. LITE PAY 결제창 호출 시 필수로 전달합니다.ex) "shop_user_id" : "nhnkcp"

AppUrlstring가변

가맹점 앱에서 결제를 진행할 때 외부 인증 앱 호출 후 다시 가맹점 앱으로 돌아오기 위해 사용하는 앱 스킴 정보입니다.
Mobile 결제창을 앱에서 연동할 때 필수이며, 결제창을 호출한 웹뷰가 유지되어야 합니다.
※ https가 아닌 앱스킴명:// 형식으로 입력하세요.ex) "AppUrl" : "testapp://"

buyr_namestring40

주문자 이름입니다.ex) "buyr_name" : "홍길동"

buyr_mailstring100

주문자 이메일입니다. 결제 결과 메일 발송 등에 사용됩니다.ex) "buyr_mail" : "test@example.com"

buyr_tel2string20

주문자 휴대폰 번호입니다. 하이픈(-)을 포함할 수 있습니다.ex) "buyr_tel2" : "01012345678"

site_namestring20

사이트명입니다.ex) "site_name" : "NHN KCP"

good_cdstring20

상품코드입니다. 주문상품명으로 구분이 어려운 경우, 상품군을 따로 구분하여 처리할 수 있는 기능입니다.ex) "good_cd" : "00"

신용카드 전용 옵션 파라미터

quotaoptstring2

50,000원 이상 거래에 적용하는 할부 옵션입니다. 기본값은 12개월이며, 0~12 사이로 설정하면 결제창에 해당 개월 수까지 할부가 표기됩니다.ex) "quotaopt" : "05"

kcp_nointstring1

가맹점 부담 무이자 여부를 설정합니다.
"" : 가맹점관리자 설정에 따릅니다.
"Y" : kcp_noint_quota 값에 따라 무이자로 표시됩니다. (가맹점관리자에 설정되어 있어야 합니다.)
"N" : 가맹점관리자 값을 무시하고 일반 할부로 처리됩니다.ex) "kcp_noint" : "Y"

kcp_noint_quotastring256

가맹점이 부담하는 무이자를 카드사별로 설정합니다. 무이자를 적용할 카드코드와 할부 개월 수를 카드사별로 지정할 수 있습니다.ex) "kcp_noint_quota" : "CCBC-02:03:06, CCSS-03:06"

used_card_YNstring1

결제창에 노출할 카드사를 직접 지정할지 설정합니다.
이 값을 Y로 설정한 뒤 used_card에 노출할 신용카드 코드를 입력하면, 입력한 신용카드만 결제창에 노출됩니다.
※ PC 결제 시 used_card, used_card_YN을 모두 설정하고, Mobile 결제 시 used_card만 설정합니다.ex) "used_card_YN" : "Y"

used_cardstring256

고객이 결제창을 호출할 때 노출되는 카드사를 지정합니다.
※ PC 결제 시 used_card, used_card_YN을 모두 설정하고, Mobile 결제 시 used_card만 설정합니다.ex) "used_card" : ["CCDI", "CCSS", "CCLG"]

fix_inststring2

결제 금액이 50,000원 이상일 때 결제창에서 선택할 수 있는 할부 개월 수를 0~12 중 하나로 고정합니다.ex) "fix_inst" : "0"

휴대폰 추가 설정 파라미터

used_mobxstring가변

결제창에 노출할 통신사를 지정합니다. 원하는 통신사만 노출시킬 수 있습니다.
휴대폰 결제는 Guide > 휴대폰 결제를 확인하세요.ex) "used_mobx" : "SKT:KTF:LGT"

포인트 추가 설정 파라미터

van_code필수string4

포인트 결제사 코드입니다.
베네피아 : SCWB
OK캐시백 : SCSK
ex) "van_code" : "SCWB"

pt_memcorp_cd필수string4

베네피아 소속사 코드입니다. 베네피아 포인트 결제 시 필수로 전달합니다.ex) "pt_memcorp_cd" : "5555"

complex_pnt_ynstring1

포인트 결제 시 결제 금액의 일부를 신용카드 결제와 함께 사용할 수 있는지 설정합니다.
N으로 설정하면 포인트로만 결제가 진행됩니다.ex) "complex_pnt_yn" : "N"

상품권 추가 설정 파라미터

van_code필수string4

상품권 결제사 코드입니다.
해피머니 : SCHM
컬쳐랜드 : SCCL
도서상품권 : SCBL
ex) "van_code" : "SCHM"

추가옵션 파라미터

site_logostring256

결제창 왼쪽 상단에 가맹점 사이트의 로고를 노출합니다.
- 로고 파일은 GIF, JPG 파일만 지원합니다.
- 최대 크기는 150 X 50 미만입니다.
- 이미지 파일을 150 X 50 이상으로 설정하거나 이 파라미터를 생략하면 site_name 값이 표시됩니다.
※ site_logo 설정 시 결제창 호출이 느려질 수 있습니다.ex) "site_logo" : "https://test.kcp.co.kr/logo.jpg"

eng_flagstring1

결제창을 한글 또는 영문으로 변환합니다. LITE PAY에서는 신용카드·계좌이체·휴대폰 결제에 적용됩니다.ex) "eng_flag" : "Y"

skin_indxstring2

결제창 스킨을 변경합니다. 1~12까지 설정할 수 있습니다.ex) "skin_indx" : "1"

good_exprstring1

상품 제공기간을 설정합니다.
"", "0" : 일반결제
"1" : 제공기간
※ 기본값은 일반결제입니다.ex) "good_expr" : "0"

comm_tax_mnynumber12

공급가액입니다. (공급가액 = good_mny / 1.1)
※ 복합과세 전용 사이트코드로 계약한 가맹점에만 해당합니다.ex) "comm_tax_mny" : "909"

comm_free_mnynumber12

비과세액입니다.
※ 복합과세 전용 사이트코드로 계약한 가맹점에만 해당합니다.ex) "comm_free_mny" : "0"

comm_vat_mnynumber12

부가가치세입니다. (부가가치세 = good_mny − 과세 공급가액 − 비과세액)
※ 복합과세 전용 사이트코드로 계약한 가맹점에만 해당합니다.ex) "comm_vat_mny" : "91"

param_opt_1string1000

Mobile 결제창에서 추가 파라미터가 필요할 때 사용하는 가맹점 추가 파라미터입니다.ex) "param_opt_1" : "test"

param_opt_2string1000

Mobile 결제창에서 추가 파라미터가 필요할 때 사용하는 가맹점 추가 파라미터입니다.ex) "param_opt_2" : "test"

param_opt_3string1000

Mobile 결제창에서 추가 파라미터가 필요할 때 사용하는 가맹점 추가 파라미터입니다.ex) "param_opt_3" : "test"

3. 결제창 인증 결과

결제창에서 인증이 성공할 경우 ret_URL로 인증 결과가 응답되고, 인증 실패의 경우 fail_url로 처리됩니다.
인증 결과로는 결제창의 인증 데이터를 암호화한 enc_data, enc_info가 전달됩니다.

결제창 인증 결과 파라미터

res_cdstring4

결과 코드입니다. 인증이 정상 처리되면 '0000'이 리턴됩니다.ex) "res_cd" : "0000"

res_msgstring100

결과 메시지입니다.ex) "res_msg" : "정상처리"

enc_datastring가변

결제창 인증 결과 암호화 정보입니다.
※ 임의로 변경할 수 없으며 결제창에서 내려 주는 값을 그대로 사용합니다.ex) "enc_data" : "1eOSNbDDMQCVqCHVNZGN..."

enc_infostring가변

결제창 인증 결과 암호화 정보입니다.
※ 임의로 변경할 수 없으며 결제창에서 내려 주는 값을 그대로 사용합니다.ex) "enc_info" : "4dgxMICIupJdwMheYKVQI..."

tran_cdstring8

요청 코드입니다. (수정 불가)ex) "tran_cd" : "00100000"

4. 결제 승인 요청하기

전달받은 인증 결과 데이터(enc_data·enc_info)를 API 통신으로 결제 승인 요청하는 단계입니다.
승인 요청 전에는 결제창에서 받은 인증 결과와 실제 승인 요청 값이 일치하는지 확인하기 위해
결제 금액(ordr_mony)·주문번호(ordr_no)·결제수단(pay_type)을 함께 전달하여 결제정보를 검증하세요.

결제정보 검증 기능은 결제정보 검증을 확인하세요.

결제 승인 요청과 응답 파라미터는 API Reference > 결제승인을 확인하세요.

5. 결제 승인 응답

결제 승인에 성공하면 res_cd에 0000이 리턴되고, 결제수단별 응답 파라미터에 값이 채워져 함께 리턴됩니다.
응답 데이터를 확인해 결제수단별 결과 값을 가맹점 서버에 저장·관리하세요.