결제 수단과 PG 설정

결제 수단 선택

상점 무통장입금과 접수 전용 방식, 이니시스·NHN KCP·토스페이먼츠·나이스페이먼츠의 카드 결제를 지원합니다. 온라인 카드 결제는 계약한 PG의 상점 정보와 운영 승인 조건이 필요합니다. 테스트 키를 저장했다고 실제 판매 대금이 입금되는 것은 아닙니다.

1. 상점 설정에서 사용할 수단을 정합니다.
2. 설정 → 결제(/admin/settings/payment)에서 사용할 PG와 환경을 선택합니다.
3. PG가 발급한 상점 ID·키와 필요한 서버 IP·URL 조건을 확인합니다.
4. 테스트 환경과 운영 환경을 명확히 구분해 저장합니다.
5. 실제 판매 전 운영 계약 정보와 취소 권한, 복합과세 지원 여부를 확인합니다.

카드 결제의 완료 기준

고객이 결제창을 닫거나 성공 화면을 본 것만으로 주문을 결제 완료로 판단하지 않습니다. GNUCMS가 인증 결과를 검증하고 서버 승인을 받은 뒤 결제 원장과 주문 상태에 기록합니다. 승인 결과가 불명확하면 결제 오류 화면과 PG 거래 조회를 먼저 확인합니다.

같은 주문의 결제를 중복 요청하지 않습니다. 이미 PG 승인된 거래를 수동으로 상태만 결제 완료로 바꾸는 방식은 원장 불일치를 만들 수 있습니다.

KCP와 네트워크

KCP는 배포본의 pp_cli와 pub.key를 런타임에 설치해 브라우저 인증 후 TCP/IP 승인·전체 취소를 연결합니다. Linux·Windows 지원 모듈이 배포본에 포함됩니다. 해당 호스팅에서 실행 파일과 필요한 외부 연결을 허용해야 사용할 수 있습니다.

이니시스 요청 서버 IPv4와 실제 서버의 외부 IPv4가 다르면 허용 IP를 확인합니다. 여러 서버가 같은 설정 DB를 쓰는 경우 config의 서버별 IP 설정이 필요할 수 있습니다.

과세·면세와 오류 확인

상품의 과세·면세 정보를 주문에 보존해 복합과세 금액을 처리합니다. PG 계약이 이를 지원해야 합니다. 실제 상품에 적용할 세금 분류는 사업자가 확인해 선택합니다.

1. 정산 → 결제 오류에서 대상 주문·거래·오류 원문을 확인합니다.
2. PG 관리자에서 실제 승인·취소 여부를 조회합니다.
3. 자동 복구나 보상 취소 결과가 있다면 그 이력까지 비교합니다.
4. 불명확한 승인 상태에서는 같은 결제를 다시 받거나 환불을 중복 요청하지 않습니다.