NHN KCP 전자결제 (PG)

안녕하세요.

NHN KCP에서 애플페이를 신청 방법을 안내해 드립니다.

■NHN KCP 상점관리자에서 아래에 따라 연동신청을 해주세요.

경로1 : 상점관리자 > (우측상단)질문하기 > 추가서비스 > 결제수단:신용카드
경로2 : 상점관리자 > 고객센터 > 질문하기 > 추가서비스 > 결제수단:신용카드

위 경로로 접속하셔서 애플페이(단독형) 연동 신청 문의글을 남겨주시면,
KCP에서 확인 후 처리해 드립니다.

■애플페이 이용 조건 및 불가 가맹점은 다음과 같습니다.

1) 이용조건
- 아이폰 버전 상관없이 모바일에서만 사용 가능 (PC결제창 이용 불가)
- 할부 불가 일시불만 가능
- 현대카드만 이용 가능
- 원화결제만 가능

2) 불가 가맹점
- 현대카드 가맹번호 미적용 세트 or 현대카드 카드사 서브몰 심사 반려 가맹점
- 비인증 가맹점
- 환금성 가맹점
- 성인사이트
- 유사투자
- 게임
- 사행성
- 사전몰 불가 업종

감사합니다.

NHN KCP PAYCO 허브형 신청안내

1. 가입절차

1-1. 신규 KCP PG 고객 PAYCO 가입 절차

• 신청 절차
  KCP 전자결제 신청 -> KCP 상점관리자 페이지에서 페이코 신청하기
   
• 신청 경로
  KCP 상점관리자 > 고객센터 > 질문하기 > 추가서비스 > 쇼핑몰URL 추가 > “PAYCO 허브형 신청”으로 문의내용 작성 (페이코 연동시 별도 KCP 사이트 코드가 발급된 상태에서 추가 설정이 가능함)

1-2. 기존 KCP PG 고객 PAYCO 가입 절차

• 신청경로
  KCP 상점관리자 > 고객센터 > 질문하기 > 추가서비스 > 쇼핑몰URL 추가 > “PAYCO 허브형 신청”으로 문의내용 작성

2. PAYCO 허브형이란?

통합결제창에 속한 PAYCO 간편결제가 아닌 결제방법에 PAYCO 결제가 따로 노출된 방식을 말합니다.

예시)
KCP 상점관리자(admin.kcp.co.kr) 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. 위 링크를 클릭하면 나오는 가입페이지에서 쇼핑몰솔루션 업체명을 선택하기 위해 을 클릭합니다.

1. 영카트5 메뉴중 "NHN KCP 카드결제 신청하기"를 클릭하여 신청서를 작성합니다.
   http://sir.kr/main/provider/p_pg.php
   
   
2. 신청서가 작성되면 실시간으로 NHN KCP 에 접수되며, 오전에 신청하셨다면 NHN KCP 가 담당자가 당일에 연락을 드리거나 늦어도 2영업일 이내에 연락을 드립니다.
   
   
3. NHN KCP 담당자가 계약에 필요한 서류등을 안내해 드릴겁니다.
   이때 결제와 관련하여 궁금하신 사항을 물어보시면 됩니다.
   
   
4. NHN KCP 에서 SR 로 시작하는 영대문자,숫자 5자리 SITE CODE 와 25자리 SITE KEY 를 메일로 보내 드립니다.
   
   
   
   

   
   
5. SITE CODE 중 SR 을 제외한 나머지 3자리를 쇼핑몰설정 > 결제설정 > NHN KCP SITE CODE 에 복사, 
   SITE KEY 25자리를 NHN KCP SITE KEY 에 복사합니다.
   (NHN KCP 의 메일에 첨부된 연동매뉴얼은 이미 영카트5에 적용된 내용이므로 결제모듈을 별도로 수정하시면 안됩니다.)
   
   
6. 결제설정에서 결제방법등을 선택합니다.
   신용카드, 계좌이체, 가상계좌, 휴대폰 결제사용에 사용이라고 체크하시면 됩니다.
   에스크로로 사용할건지? 신용카드 결제테스트를 할건지? 도 체크하셔야 합니다.
   
   
7. 결제테스트를 실결제로 선택하셨다면 신용카드 결제테스트 후 NHN KCP 관리자 페이지에서 해당 결제의 승인을 취소하시면 됩니다.
   
   
8. 만약, 결제중 "9502" 오류가 발생한다면 아래 링크의 내용을 참고해 주십시오.
   http://sir.kr/bbs/board.php?bo_table=faq&wr_id=2

"9502 연동 모듈 호출 오류"는 NHN KCP 에서 제공하는 pp_cli 파일이 바이너리가 아니거나 파일에 실행권한이 없거나 $g_conf_home_dir 경로가 틀린 경우에 나타나는 오류입니다.

shop/kcp/bin 폴더에 있는 pp_cli 파일은 바이너리 모드에 실행 권한이 있어야 합니다.

(영카트4의 경우 shop/kcp/payplus/bin/ 폴더의 pp_cli)

여기서 $g_conf_home_dir 의 경로가 틀린 경우는 프로그램을 수정하지 않았다면 일어날 가능성이 없으므로 따로 설명드리지 않겠습니다. 

shell 에서 리눅스 명령어를 이용하여 확인하기

위와 같이 ./pp_cli 에 -h 옵션을 주고 실행하면 "res_cd=S102 res_msg=연동 모듈 호출 오류" 라고 나오는데 이게 정상인 상태입니다.

서버가 UTF-8 인 경우에는 res_msg 가 깨져서 나오므로 "res_cd=S102" 라고 나오는지만 확인하시면 됩니다.

Segmentation fault (세그멘테이션 오류) 라고 나오는 경우에는 pp_cli 파일이 잘못된 경우이므로 삭제한후 다시 업로드 해주시기 바랍니다.

파일질라 FTP 프로그램을 이용하여 확인하기

pp_cli 파일 선택후 "파일 권한" 이라는 메뉴가 있습니다. 클릭하면 "파일 속성 바꾸기" 창이 뜨고 여기에서 숫자값 755 를 입력하시거나 화면에서와 같이 체크 해주시면 됩니다. 이렇게 설정한후 웹상에서 실제 결제를 해보시기 바랍니다. 

그래도 9502 오류가 나온다면 메뉴의 전송 > 전송 유형을 바이너리로 선택한후 pp_cli 을 다시 업로드 합니다. 그리고 위에서 처럼 파일의 퍼미션을 변경해 보시기 바랍니다.

알 FTP 프로그램을 이용하여 확인하기

pp_cli 파일 선택후 "권한 설정" 메뉴에서 파일의 퍼미션을 변경하면 됩니다. 이렇게 설정한후 웹상에서 실제 결제를 해보시기 바랍니다. 

그래도 9502 오류가 나온다면 메뉴의 옵션 > 환경설정 > 일반에서 파일 전송 타입을 바이너리로 선택한후 pp_cli 을 다시 업로드 합니다. 그리고 위에서 처럼 파일의 퍼미션을 변경해 보시기 바랍니다.

그래도 9502 오류가 발생한다면

1. 환경설정의 phpinfo() 를 확인하여 safe_mode 가 Off 로 되어 있는지 확인합니다. safe_mode 가 On 인 경우에는 정상 작동하지 않습니다.
   
   
2. 방화벽이나 DNS 의 미설치로 인하여 9502 오류가 발생하는 경우가 있는데 shop/kcp/pp_ax_hub.php 의 $g_conf_gw_url  = "paygw.kcp.co.kr"; 를 $g_conf_gw_url  = "203.238.36.136"; 과 같이 수정해 주시기 바랍니다.
   
   
3. ld-linux.so.2 가 설치되지 않았을 경우에도 오류가 발생할수 있습니다.
   
   
4. 안녕리눅스의 경우 safe_mode_exec_dir 의 기본값이 /var/lib/php/bin 입니다. kcp 에서 pp_cli 를 사용하기 위해서 /var/lib/php/bin/에 pp_cli 를 소프트 링크를 걸어서 사용해야 한다고 하더군요. 그래서 /var/lib/php/bin 에 ln -sf /home/account/public_html/shop/kcp/bin/pp_cli ./pp_cli 와 같이 링크를 거니 정상 작동을 합니다.
   
   
5. 윈도우에서 9502 오류가 발생하는 경우에는 system32에 있는 cmd.exe 파일에 인터넷 게스트 계정을 주시고 읽기, 실행 권한을 주시기 바랍니다.

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 은 쇼핑몰의 도메인으로 변경하셔야 합니다.

http://example.com/mobile/shop/kcp/order_approval.php?site_cd=T0000&ordr_idxx=2016072915214888&good_mny=10000&pay_method=VCNT&escw_used=Y&Ret_URL=http://example.com/mobile/shop/kcp/order_approval_form.php&good_name=%ED%85%8C%EC%8A%A4%ED%8A%B8 

오류 내용을 확인 하신 후 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