KCP REST API 결제 모듈만 적용

현재 영카트 초기버전 5.4.5.1 를 사용중에 있습니다.
수정한 부분도 많아서 업글은 엄두도 못하고 있습니다.
최근 php취약 부분 해결을 위해서 호스팅사를 php8.4지원 서버로 옮기는 작중인데 오류나는 부분만 
수정작업중입니다.
카드결제도 정상적으로 되었는데 갑자기 exec 이 막히면서 카드결제 모듈 압그레이드를 할가 하는데요.
물론 exec 를 임시 허용해서 사용해도 되겠지만 가능하다면 근본원인을 해결하고자합니다.

전체 업그레이드 없이 KCP REST API 결제 모듈만 적용할 수 있는지, 가능하다면 
수정해야 할 파일 범위와 적용 방법을 알고 싶습니다.

버전이 너무 오래되어서 될지 모르겠네요.
선배님들의 해결할 수 있는 방법으로 고견 부탁드립니다.
 

답변 2개

5.4.5.1이면 전체 업그레이드 없이 KCP REST API 부분만 바꿔서 쓸 수 있습니다.
저도 얼마 전에 exec 차단으로 pp_cli 결제가 막힌 구버전 영카트(5.3대)를 업그레이드 없이 REST 방식으로 바꿔서 정상 결제되는 것까지 확인했습니다.

원인
영카트 구버전은 KCP 승인·취소를 shop/kcp/pp_ax_hub_lib.php에서 exec()로 pp_cli 바이너리를 실행해 처리합니다. 그래서 호스팅에서 exec를 막으면 결제가 안 됩니다. REST API는 PHP cURL로 KCP 서버(https://spl.kcp.co.kr, 테스트는 stg-spl.kcp.co.kr)에 JSON을 보내는 방식이라 exec도 pp_cli 바이너리도 필요 없습니다.

사전 준비
1. KCP 파트너관리자 → 기술관리센터 → 인증센터 → KCP-PG API에서 서비스 인증서와 개인키(PKCS8)를 발급받습니다. 사이트코드 기준으로 발급됩니다.
2. 서버에 PHP cURL, OpenSSL 확장이 있는지 확인합니다. 8.4 서버라면 대부분 들어 있습니다.
3. 테스트는 KCP 개발자센터의 테스트 인증서·개인키로 먼저 해볼 수 있습니다.

수정 범위 (버전·커스터마이징에 따라 파일명이 조금 다를 수 있으니 grep -rn "pp_cli\|mf_do_tx" . 로 찾아보시는 게 정확합니다)
- 결제 승인
  - shop/kcp/pp_ax_hub.php, 모바일 쪽 mobile/shop/kcp/pp_ax_hub.php
  - 결제창에서 넘어온 enc_data, enc_info와 인증서 정보를 /gw/enc/v1/payment로 보내 승인받도록 바꿉니다.
- 취소·부분취소·에스크로 배송등록
  - shop/kcp/pp_ax_hub_cancel.php(고객 취소·관리자 취소·주문 저장 실패 시 자동취소), 관리자 부분취소, 에스크로 배송등록 파일
  - 이쪽도 pp_cli를 쓰므로 같이 바꿔야 합니다. 취소 API(/gw/mod/v1/cancel)는 개인키로 만든 서명값(kcp_sign_data)이 필요합니다.
- 설정 파일
  - 인증서 경로와 개인키 비밀번호를 넣을 설정 파일을 하나 따로 두면 관리가 편합니다. 웹에서 접근되지 않는 위치에 두세요.
- 바꾸지 않아도 되는 부분
  - 결제창 화면(orderform)과 가상계좌 입금 통보(settle_kcp_common.php)는 exec를 쓰지 않아 그대로 둬도 됩니다.

팁
승인·취소 결과를 받은 뒤 기존 코드가 쓰던 변수($tno, $amount, $app_no, $res_cd 등)에 똑같이 넣어 주면, 그 아래 주문 저장 로직은 거의 손대지 않아도 됩니다. 커스터마이징을 많이 하셨다면 이 방식이 가장 안전합니다.

적용 순서
테스트 사이트코드로 카드 승인 → 전체취소 → 부분취소까지 확인한 뒤 운영 인증서로 바꾸시길 권합니다. 계좌이체·가상계좌·휴대폰 결제를 쓰신다면 수단별로 한 번씩 테스트해 보셔야 합니다.

직접 하시다가 막히면 댓글 남겨 주세요. 아는 범위에서 답변드리겠습니다.

전체 업그레이드 없이 KCP 부분만 옮기는 것은 가능합니다. 다만 파일 몇 개를 덮어쓴다고 끝나지 않습니다. exec를 쓰는 곳을 모두 찾아서 바꿔야 합니다.

1. 원인 확인
예전 KCP 모듈은 승인과 취소 때 shop/kcp/bin/pp_cli 실행 파일을 exec로 부릅니다. 먼저 서버에서 exec가 막혔는지, 그리고 소스 어디에서 exec를 쓰는지 확인하세요.

Copy
php -i | grep disable_functionsgrep -rn "exec(\|pp_cli" shop/ adm/shop_admin/ --include=*.php

CLI와 웹(FPM)은 php.ini가 다를 수 있습니다. 그래서 웹에서 phpinfo()로 한 번 더 확인하시는 게 정확합니다.

2. 바꿔야 할 범위
결제 승인(주문서 저장)만 바꾸면 안 됩니다. 아래 경로도 대부분 같은 pp_cli 라이브러리를 씁니다.
- 주문 저장 중 오류가 나서 승인을 되돌리는 취소
- 관리자 주문 취소, 부분 취소
- 개인결제
- 에스크로 배송 등록
위의 grep 결과에 나온 파일이 모두 수정 대상입니다. 하나라도 빠뜨리면 결제는 되는데 취소는 실패하는 상황이 생깁니다.

3. 적용 방법
- GitHub의 최신 그누보드5(영카트 통합) 소스를 받아서 shop/kcp/ 폴더와 KCP 관련 settle 파일을 현재 소스와 diff로 비교하세요.
- 새 코드는 exec 대신 PHP curl로 KCP API를 호출하는 구조입니다. 그래서 curl 확장과 서명용 openssl 확장이 있어야 합니다.
- 새 코드는 최신 버전의 공통 함수나 설정 상수를 쓸 수 있습니다. 옮긴 뒤 정의되지 않은 함수 오류가 나면 해당 함수만 함께 가져오시면 됩니다.
- REST 방식에서는 KCP 상점관리자에서 발급받는 인증서/개인키가 추가로 필요할 수 있습니다. 새 코드의 설정 부분을 보고 필요한 값을 확인하세요.

Copy
php -m | grep -i -E "curl|openssl"

4. 테스트
테스트 사이트코드로 아래를 꼭 각각 확인하세요.
- 카드 승인
- 승인 직후 DB 오류가 났을 때 자동 취소되는지 (일부러 오류를 내서 확인)
- 관리자 전체 취소와 부분 취소
- 가상계좌 입금 통보(common_return)

답변을 작성하려면 로그인이 필요합니다.