• 목록

• 페이스북 공유
• 트위터 공유
• 

제목: 그누보드(영카트) 5.6.44 - NHN KCP REST API 연동 및 PG 승인정보 개선

출처: (주)에스아이알소프트 https://sir.kr/boards/g5_pds/7803

게시일: 2026.10.30

📌5.6.43→5.6.44 변경 비교

https://github.com/gnuboard/gnuboard5/compare/v5.6.43...v5.6.44

■ 릴리즈 노트

버전: 5.6.44

배포일: 2026-10-30

패치 기준: 5.6.43

DB업그레이드: 필수

20261029_001_kcp_payment_api

20261029_003_pg_approval_log

삭제 대상 파일:

adm/phpinfo.php

■ 개발자 노트

이번 버전은 KCP REST API를 선택할 수 있는 기능과 PG별 설정·승인정보 조회 개선을 포함합니다. 업데이트 후 관리자 DB 업그레이드를 실행해야 합니다. 기존 KCP 결제 모듈 방식은 그대로 사용할 수 있습니다.

#1 KCP REST API 지원

KCP와의 서버 통신에 HTTPS 기반 REST API를 선택할 수 있도록 했습니다. REST를 선택하면 모바일 거래등록, 결제 승인·취소, 에스크로 처리 및 현금영수증 개별 발급·취소가 해당 API를 이용합니다. 사용하려면 KCP 서비스 인증서와 개인키를 웹 공개 경로 밖에 설치하고 서버에 경로·비밀번호를 설정해야 합니다. 기존 상점이 자동으로 REST로 전환되지는 않습니다.

KCP REST API 선택 연동 방법은 안내 페이지를 참고해 주세요.

https://sir.kr/services/pg/kcp#kcp-integration

구버전 그누보드 이용 도중 KCP REST API만 선택적으로 패치하시는 경우 다음 커밋을 참고해 주세요. (5.6.43 기준)

feat: KCP REST 결제·현금영수증 연동과 쇼핑몰 설정 추가

https://github.com/gnuboard/gnuboard5/commit/56a492ef482218ae706c92c17898b9d04425cc85

fix: KCP exec 차단 경고 반복 방지 및 사용 불가 안내 명확화

https://github.com/gnuboard/gnuboard5/commit/e9d6c981dd05281f7b5fa076242b669481df2434

#2 PG 설정 화면 정리 및 승인 내역 조회 추가

여러 PG의 설정을 찾기 쉽도록 탭으로 정리하고 이니시스 기존 방식과 PRO를 구분했습니다. 승인 시 PG에서 받은 카드·할부 응답은 관리자 주문 상세의 ‘PG 승인 카드정보 (펼치기)’에서 확인할 수 있습니다. 기능 적용 전 주문에는 기록이 없을 수 있으며, 이는 결제 실패를 의미하지 않습니다.

#3 phpinfo 제거

서버의 PHP 설정과 환경정보 노출을 줄이기 위해 관리자 phpinfo 메뉴와 adm/phpinfo.php 페이지를 제거했습니다. 기존 설치에서는 업데이트 파일을 덮어쓰는 것만으로 해당 파일이 삭제되지 않으므로, 서버에 남아 있는 adm/phpinfo.php도 직접 삭제해야 합니다.

■ 패치 노트

KCP 기본/REST 연동 선택 및 REST 결제·현금영수증 처리 추가

PG별 설정 탭과 이니시스 연동 방식 구분

전체 지원 PG의 승인 카드정보 저장·조회 추가

이니시스 인증·승인 응답의 필수 값 검증 및 추가 필드 처리 보완

exec 차단 환경의 KCP 기본 모듈 사용 불가 안내 및 반복 경고 개선

관리자 phpinfo 메뉴·페이지 제거

■ 업데이트 안내

소스·DB·data와 개별 수정 파일을 백업한 뒤 결제와 관리자 작업을 잠시 중지합니다. 5.6.43 사용자는 패치 파일을 병합하고, 이전 버전은 누적 변경을 함께 확인합니다. config.php와 data 및 개별 수정 사항을 보존하세요. 기존 adm/phpinfo.php를 삭제하고 관리자 DB 업그레이드를 실행합니다. 필요한 ALTER·CREATE·INDEX 권한과 두 마이그레이션의 성공을 확인하세요. 브라우저 캐시를 갱신하고 설정·주문 상세·승인·취소를 확인한 뒤 서비스를 재개합니다.

REST 사용 시 운영 상점에서 발급한 인증서·개인키를 사용해야 하며, 테스트용 인증정보와 혼용하면 안 됩니다. PHP cURL·OpenSSL·JSON·iconv, TLS 1.2 이상 및 웹 루트 외부 파일에 대한 PHP 읽기 권한이 필요합니다. REST 선택은 쇼핑몰 결제 연동에 적용됩니다.

첨부파일

■ 첨부파일

gnuboard5.6.44.zip(12.9 MB)

gnuboard5.6.44.tar.gz(11.3 MB)

gnuboard5.6.44.patch.zip(250.4 KB)