결제 수단 선택
상점 무통장입금과 접수 전용 방식, 이니시스·NHN KCP 기존 TCP/IP·토스페이먼츠·나이스페이먼츠의 카드 결제를 지원합니다. 온라인 카드 결제는 계약한 PG의 상점 정보와 운영 승인 조건이 필요합니다. 테스트 키를 저장했다고 실제 판매 대금이 입금되는 것은 아닙니다.
- 상점 설정에서 사용할 수단을 정합니다.
- 상점 설정의 결제(/admin/shop/settings#settings-payment)에서 사용할 PG와 환경을 선택합니다. 공통 결제 키는 설정 → 결제에서도 관리합니다.
- PG가 발급한 상점 ID·키와 필요한 서버 IP·URL 조건을 확인합니다.
- 테스트 환경과 운영 환경을 명확히 구분해 저장합니다.
- 실제 판매 전 운영 계약 정보와 취소 권한, 복합과세 지원 여부를 확인합니다.
카드 결제의 완료 기준
고객이 결제창을 닫거나 성공 화면을 본 것만으로 주문을 결제 완료로 판단하지 않습니다. GNUCMS가 인증 결과를 검증하고 서버 승인을 받은 뒤 결제 원장과 주문 상태에 기록합니다. 승인 결과가 불명확하면 결제 오류 화면과 PG 거래 조회를 먼저 확인합니다.
같은 주문의 결제를 중복 요청하지 않습니다. 이미 PG 승인된 거래를 수동으로 상태만 결제 완료로 바꾸는 방식은 원장 불일치를 만들 수 있습니다.
KCP와 네트워크
KCP 기존 TCP/IP는 완성 배포 ZIP의 storage/payment/kcp_legacy/bin/에 포함된 Linux x86-64·Windows 모듈과 pub.key를 사용합니다. 소스 ZIP에는 이 모듈이 포함되지 않습니다. 기존 storage를 보존하는 업그레이드에서는 누락 파일을 수동 배치하고 Linux exec 또는 Windows proc_open과 외부 연결 허용을 확인합니다. 전체 취소만 지원하며 PG 원격 조회 대신 GNUCMS의 승인·취소 원장으로 상태를 확인합니다.
이니시스 요청 서버 IPv4와 실제 서버의 외부 IPv4가 다르면 허용 IP를 확인합니다. 여러 서버가 같은 설정 DB를 쓰는 경우 config의 서버별 IP 설정이 필요할 수 있습니다.
과세·면세와 오류 확인
상품의 과세·면세 정보를 주문에 보존해 복합과세 금액을 처리합니다. PG 계약이 이를 지원해야 합니다. 실제 상품에 적용할 세금 분류는 사업자가 확인해 선택합니다.
- 정산 → 결제 오류에서 대상 주문·거래·오류 원문을 확인합니다.
- PG 관리자에서 실제 승인·취소 여부를 조회합니다.
- 자동 복구나 보상 취소 결과가 있다면 그 이력까지 비교합니다.
- 불명확한 승인 상태에서는 같은 결제를 다시 받거나 환불을 중복 요청하지 않습니다.
문서 파일 갱신 26-10-21 16:27:42