연동 준비하기

PG API 연동을 시작하기 전에 알아야 할 준비사항과 기본 정보를 안내합니다.

환경별 키 정보

테스트베드와 상용 환경은 분리되어 있으며, 각각 별도의 상점 ID와 키를 사용합니다. 테스트베드는 공용 테스트 키를 사용하고, 상용 환경은 가맹점 전용 키를 사용합니다.

환경	상점 ID	인증 키	용도
테스트베드	공용 테스트 상점ID	공용 테스트 키	개발 및 테스트 (실제 결제 발생 안 함)
상용 환경	가맹점 전용 상점ID	가맹점 전용 키	실제 운영 서비스 (실제 결제 발생)

가맹점 전용 키 발급 (계약 후)

헥토파이낸셜과 계약 후 상용 환경에서 사용할 다음 정보를 발급받습니다.

항목	설명
상점 ID (mchtId)	가맹점 고유 식별자
라이센스 키	해시 생성 키
암호화 키	거래금액, 개인정보 등을 보호하는 키 (AES-256)

서버 연동 환경

서버 주소 및 네트워크 정보

결제창 방식은 SDK 또는 FORM으로 결제창을 호출하며, API 방식은 서버에서 JSON 형식으로 직접 API를 호출합니다. 노티는 거래 완료 후 헥토파이낸셜에서 가맹점 서버로 결제 결과를 전송하는 서버입니다.

결제창

환경	도메인	IP 주소	프로토콜
테스트베드	tbnpg.settlebank.co.kr	61.252.169.51	HTTPS(TCP/443)
상용	npg.settlebank.co.kr	14.34.14.25 (Primary) 61.252.169.58 (Secondary)	HTTPS(TCP/443)

API

환경	도메인	IP 주소	프로토콜
테스트베드	tbgw.settlebank.co.kr	61.252.169.42	HTTPS(TCP/443)
상용	gw.settlebank.co.kr	14.34.14.21 (Primary) 61.252.169.53 (Secondary)	HTTPS(TCP/443)

노티

환경	IP 주소	프로토콜
테스트베드	61.252.169.22	HTTPS(TCP/443)
상용	14.34.14.23 (Primary) 61.252.169.24 (Secondary)	HTTPS(TCP/443)

NOTE

IDC 이중화 구성

• 헥토파이낸셜 PG 시스템은 주센터(Primary)와 보조센터(Secondary)로 이중화되어 있습니다. • Primary 센터 장애 시 Secondary로 자동 전환되므로, 상용 환경의 Primary/Secondary IP 모두 방화벽에서 허용해야 합니다. • DNS Lookup 접속 권장 - 센터 전환 시 자동으로 처리됩니다 (hosts 파일 고정 시 전환 불가)

노티 수신을 위한 방화벽 설정 필수

노티 서버 IP 모두 가맹점 방화벽에서 Inbound 접근을 허용해야 합니다. Primary와 Secondary 두 IP 모두 허용이 필요하며, 하나라도 누락되면 해당 센터에서 발송되는 노티를 수신하지 못할 수 있습니다.

개발 환경 요구사항

PG 연동은 프론트엔드와 백엔드가 모두 필요합니다.

구분	역할
백엔드 (필수)	해시 생성, 금액 암호화, 결과 검증
프론트엔드	백엔드에서 생성한 암호화 데이터로 결제창 호출 (SDK 또는 FORM)

백엔드 필수

보안상 해시 생성과 금액 암호화는 반드시 서버에서 처리해야 합니다. 순수 프론트엔드만으로는 결제 연동이 불가능합니다.

암복호화 및 위변조 방지

PG 결제(결제창 호출 포함)는 데이터 보호를 위해 2가지 방식의 보안을 사용합니다. 결제창 방식과 API 방식 모두 동일하게 적용됩니다.

개인정보 및 중요정보 암복호화

개인정보와 중요정보를 보호하기 위한 암호화 방식입니다.

구분	내용
알고리즘	AES-256 / ECB / PKCS5Padding
인코딩	Base64 Encoding
암호화 대상	거래금액, 고객명, 휴대폰번호, 이메일, 카드번호, 계좌번호 등
테스트베드 키	pgSettle30y739r82jtd709yOfZ2yK5K
상용 환경 키	계약 후 별도 발급

위변조 방지 알고리즘 (pktHash)

데이터 무결성을 검증하기 위한 해시 생성 방식입니다.

구분	내용
알고리즘	SHA-256
인코딩	Hex Encoding
테스트베드 키	ST1009281328226982205
상용 환경 키	계약 후 별도 발급
생성 방법	파라미터 조합 → SHA-256 해시 → Hex 변환