| 정산주기 | D+7 영업일 기본 제공 (업종에 따라 달라질 수 있음) |
|---|
안녕하세요.
NHN KCP에서 애플페이를 신청 방법을 안내해 드립니다.
■NHN KCP 상점관리자에서 아래에 따라 연동신청을 해주세요.
경로1 : 상점관리자 > (우측상단)질문하기 > 추가서비스 > 결제수단:신용카드
경로2 : 상점관리자 > 고객센터 > 질문하기 > 추가서비스 > 결제수단:신용카드
위 경로로 접속하셔서 애플페이(단독형) 연동 신청 문의글을 남겨주시면,
KCP에서 확인 후 처리해 드립니다.
■애플페이 이용 조건 및 불가 가맹점은 다음과 같습니다.
1) 이용조건
- 아이폰 버전 상관없이 모바일에서만 사용 가능 (PC결제창 이용 불가)
- 할부 불가 일시불만 가능
- 현대카드만 이용 가능
- 원화결제만 가능
2) 불가 가맹점
- 현대카드 가맹번호 미적용 세트 or 현대카드 카드사 서브몰 심사 반려 가맹점
- 비인증 가맹점
- 환금성 가맹점
- 성인사이트
- 유사투자
- 게임
- 사행성
- 사전몰 불가 업종
감사합니다.
NHN KCP PAYCO 허브형 신청안내
1. 가입절차
1-1. 신규 KCP PG 고객 PAYCO 가입 절차
1-2. 기존 KCP PG 고객 PAYCO 가입 절차
통합결제창에 속한 PAYCO 간편결제가 아닌 결제방법에 PAYCO 결제가 따로 노출된 방식을 말합니다.
고객센터 > 질문하기
작성폼에 위와 같이 작성하시면 됩니다.
신청후 대략 1주일 정도가 지나면 서비스가 가능합니다.
NHN KCP에서는 전자금융사고 예방을 위해 거래취소 보안 강화를 가맹점 결제 서버 IP 등록 의무화하여 2018년 11월 21일 오후 2시부터 순차적으로 시행한다고 합니다.
결제 서버 IP 등록은 30개 까지 등록이 가능하며,
등록하지 않는다면, 주문취소에 제한을 받으며, 실결제 주문 취소는 NHN KCP 상점 관리자에서만 직접취소 할수 있습니다.
등록한 IP 에서는 해당 쇼핑몰 사이트에서 실결제 주문 취소가 가능합니다.
결제 서버 IP 등록 방법은
NHN KCP 상점관리자 -> 상점정보관리 메뉴 -> 결제서버 IP 설정 메뉴 에서 등록이 가능합니다.
아래 이미지와 같이 아이피를 등록할수 있습니다.
NHN KCP 결제 로그는 반드시 필요한 것은 아니지만 개발과정 또는 결제 오류 등을 확인하기 위해서 필요한 경우가 있습니다. 이럴 경우에 리눅스 환경에서 NHN KCP 로그 디렉토리 생성 방법입니다.
로그 디렉토리는 웹브라우저를 통해 접근이 불가능한 경로에 생성되어야 합니다.
* 이 내용과 관련된 코드는 영카트 5.1.9 버전에서 수정 반영됐습니다.
먼저 로그 생성을 위한 코드가 올바른지 확인해 보겠습니다.
shop/settle_kcp.inc.php 에서 $g_conf_log_dir 설정값을 확인해 봅니다.
[code]
$g_conf_home_dir = G5_SHOP_PATH.'/kcp';
$g_conf_key_dir = '';
if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN')
{
$g_conf_log_dir = G5_SHOP_PATH.'/kcp/log';
$g_conf_key_dir = G5_SHOP_PATH.'/kcp/bin/pub.key';
}
[/code]
코드가 위와 같다면 아래와 같이 수정합니다.
[code]
$g_conf_home_dir = G5_SHOP_PATH.'/kcp';
$g_conf_key_dir = '';
/*=======================================================================
KCP 결제처리 로그파일 생성을 위한 로그 디렉토리 절대 경로를 지정합니다.
로그 파일의 경로는 웹에서 접근할 수 없는 경로를 지정해 주십시오.
영카트5의 config.php 파일이 존재하는 경로가 /home/youngcart5/www 라면
로그 디렉토리는 /home/youngcart5/log 등으로 지정하셔야 합니다.
로그 디렉토리에 쓰기 권한이 있어야 로그 파일이 생성됩니다.
=======================================================================*/
$g_conf_log_dir = '/home100/kcp'; // 존재하지 않는 경로를 입력하여 로그 파일 생성되지 않도록 함.
if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN')
{
$g_conf_key_dir = G5_SHOP_PATH.'/kcp/bin/pub.key';
}
[/code]
위의 과정은 PC 쇼핑몰의 코드 수정입니다. 마찬가지로 모바일 쇼핑몰의 코드도 수정해야 합니다.
mobile/shop/settle_kcp.inc.php 파일의 코드를 확인합니다.
[code]
$g_conf_key_dir = '';
if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN')
{
$g_conf_log_dir = G5_SHOP_PATH.'/kcp/log';
$g_conf_key_dir = G5_SHOP_PATH.'/kcp/bin/pub.key';
}
[/code]
코드가 위와 같다면 아래의 코드로 수정합니다.
[code]
$g_conf_key_dir = '';
/*=======================================================================
KCP 결제처리 로그파일 생성을 위한 로그 디렉토리 절대 경로를 지정합니다.
로그 파일의 경로는 웹에서 접근할 수 없는 경로를 지정해 주십시오.
영카트5의 config.php 파일이 존재하는 경로가 /home/youngcart5/www 라면
로그 디렉토리는 /home/youngcart5/log 등으로 지정하셔야 합니다.
로그 디렉토리에 쓰기 권한이 있어야 로그 파일이 생성됩니다.
=======================================================================*/
$g_conf_log_dir = '/home100/kcp'; // 존재하지 않는 경로를 입력하여 로그 파일 생성되지 않도록 함.
if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN')
{
$g_conf_key_dir = G5_SHOP_PATH.'/kcp/bin/pub.key';
}
[/code]
위와 같이 코드를 수정하셨다면 log 디렉토리를 생성합니다.
이미지와 같이 영카트5가 /home/manual/www 디렉토리 안에 설치되어 있다고 가정합니다.
이때 log 디렉토리는 www 디렉토리의 하위 디렉토리여서는 안됩니다. www 안에 위치하는 경우
웹브라우저를 통해 접근이 가능하여 악의적인 목적을 가진 누군가에 의해 정보가 유출될 수 있습니다.
log 디렉토리는 웹으로 접근이 불가능한 경로여야 하며 아래와 같이 www 와 동일한 위치에 있거나
또는 /home/kcp/log 등과 같이 전혀 별개의 경로를 가져야 합니다.
log 디렉토리를 웹에서 접근이 불가능한 경로에 생성하셨다면 아래와 같이 쓰기 권한을 부여해 주셔야 합니다.
다음으로 shop/kcp/pp_ax_hub_lib.php 파일의 217 라인 근처의 코드를 확인합니다.
[code]
"enc_data=" . $this->m_encx_data . "," .
"enc_info=" . $this->m_encx_info . "," .
"trace_no=" . $trace_no . "," .
"cust_ip=" . $cust_ip . "," .
"log_level=" . $log_level . "," .
"opt=" . $opt . "" );
[/code]
코드가 위와 같다면 아래의 코드로 수정합니다.
[code]
"enc_data=" . $this->m_encx_data . "," .
"enc_info=" . $this->m_encx_info . "," .
"trace_no=" . $trace_no . "," .
"cust_ip=" . $cust_ip . "," .
"log_path=" . $log_dir . "," .
"log_level=" . $log_level . "," .
"opt=" . $opt . "" );
본인확인 사용시 제목과 같이 오류가 나온다면
아래 두개의 파일을 바이너리로 올린후 실행권한(755)로 설정한 후 테스트 해보세요.
plugin/kcpcert/bin/ct_cli
plugin/kcpcert/bin/ct_cli_x64
ftp 프로그램은 파일질라를 권해 드립니다.
페이코(Payco)는 NHN엔터테인먼트(이하 NHN엔터)에서 제공하는 간편결제 수단으로 NHN엔터를 통해서도 서비스가 되고 있지만, NHN KCP를 통해서도 서비스가 되고 있습니다.
저희 SIR에서 제공하는 페이코는 NHN KCP에서 제공하는 것만 사용하고 있습니다. (이하 NHN KCP 페이코)
이 NHN KCP 페이코는 단독적인 결제수단으로 사용할수 없으며 NHN KCP 전자결제를 쓰는 경우에만 사용할수 있습니다.
NHN KCP 전자결제를 사용한다면 NHN KCP 페이코는 별도의 프로그램(모듈) 설치없이 그대로 사용이 가능합니다.
NHN KCP 페이코를 사용하기 위해서는 별도의 신청이 필요 없으며 전자결제 신청시 기본으로 사용이 가능하게 설정해 드리고 있습니다. 그러나 신청기간이 약간 긴것이 단점입니다.
신규가입자의 경우 이번달 1일~말일까지 전자결제를 신청하신 경우 다음달 중순에 페이코(Payco)를 오픈해 드리고 있습니다. (급하신 경우 NHN KCP로 문의해 주세요)
기존사용자의 경우 신용카드 창에서 페이코(Payco)가 노출되지 않는다면 다음과 같은 방식으로 신청할수 있습니다. 처리 기간은 신규가입자와 동일합니다.
NHN KCP 관리자 페이지 > 고객센터 > 질문하기 > 기타문의 > 기타 각종문의에 페이코(Payco)를 사용하고 싶다고 글 남겨주시면 됩니다.
신청시 별도의 추가 비용은 없습니다.
간편결제 수수료는 전자결제 수수료와 동일하게 적용됩니다.
참고) NHN엔터 페이코와 NHN KCP 페이코의 차이점
포인트 등의 적립에 있어 차이가 있다고 합니다.
자세한 사항은 NHN KCP 고객센터로 문의해 주시기 바랍니다. (０２-２１０８-１０００)
요약)
1. SIR 에서는 NHN KCP 페이코만 지원합니다.
2. 신규가입자는 이번달 1일~말일 신청분을 다음달 중순에 오픈해 드립니다.
(별도로 신청할 필요 없음)
3. 기존가입자의 결제창에 페이코 결제가 나오지 않으면 NHN KCP 관리자 페이지에서 별도 신청해야 합니다.
(신청기간은 신규가입자와 동일)
4. 신청시 별도의 비용은 없습니다.
5. 전자결제 수수료와 같습니다.
https://admin8.kcp.co.kr/hp.HomePageAction.do?cmd=apply
1. 위 링크를 클릭하면 나오는 가입페이지에서 쇼핑몰솔루션 업체명을 선택하기 위해 
을 클릭합니다.
"9502 연동 모듈 호출 오류"는 NHN KCP 에서 제공하는 pp_cli 파일이 바이너리가 아니거나 파일에 실행권한이 없거나 $g_conf_home_dir 경로가 틀린 경우에 나타나는 오류입니다.
NHN KCP 모바일 결제 때 SOAP 모듈 및 OPENSSL 모듈이 모두 설치되어 있지만 "실패 되었습니다.[연동 오류 (PHP SOAP 모듈 설치 필요)]" 오류가 표시되는 경우에 오류 내용을 구체적으로 확인해볼 수 있는 방법입니다.
mobile/shop/kcp/order_approval.php 파일 하단의 코드를 수정하여 추가적인 오류 메세지를 출력하도록 합니다.
[code]
catch (SoapFault $ex )
{
printf( "%s,%s,%s,%s", "95XX", "", "", "연동 오류 (PHP SOAP 모듈 설치 필요)" );
}
[/code]
위 코드를 아래와 같이 수정합니다.
[code]
catch (SoapFault $ex )
{
printf( "%s,%s,%s,%s,%s", "95XX", "", "", "연동 오류 (PHP SOAP 모듈 설치 필요)", $ex );
}
[/code]
코드를 수정하신 후 아래 주소로 직접 접속해서 오류 내용을 확인합니다. example.com 은 쇼핑몰의 도메인으로 변경하셔야 합니다.
오류 내용을 확인 하신 후 NHN KCP 기술지원 부서에 해결책을 문의해 보시기 바랍니다.
만약 아래와 유사한 오류가 발생한다면 웹방화벽으로 인해 SOAP 통신이 불가능한 경우입니다. 이 때는 SOAP 통신 IP 및 port 를 개방해 주셔야 합니다. SOAP 통신 IP 등의 정보는 NHN KCP 기술지원 부서에 문의하셔서 확인할 수 있습니다.
95XX,,,연동 오류 (PHP SOAP 모듈 설치 필요),SoapFault exception: [HTTP] Could not connect to host in /home/example/www/mobile/shop/kcp/KCPComLibrary.php:182
웹에이전시나 프리랜서의 경우 고객님의 쇼핑몰을 PG(결제대행사)에 가입을 시키시면 가입비의 일부를 돌려 받을수 있습니다. 사업자만 가능합니다.
현재 NHN KCP와 KG이니시스에서만 리셀러 서비스를 하고 있습니다.
토스페이먼츠의 경우 리셀러 서비스가 없습니다.
아래 링크에서 자세하게 설명 드리고 있으니 참고해 주시기 바랍니다.
https://sir.kr/main/service/p_reseller.php
