운영 전환
테스트 연동을 완료했다면, 운영 환경으로 전환할 준비가 된 것입니다.
사전 준비
전환 전 필수 확인
운영 전환 전 반드시 헥토파이낸셜과 계약을 완료하고, 운영 상점 ID와 키를 발급받아야 합니다.
원천사 심사 현황
사용할 결제수단별 원천사 심사가 완료되었는지 확인하세요.
| 결제수단 | 원천사 | 확인 사항 |
|---|---|---|
| 신용카드 | 각 카드사 (BC, 삼성, 현대 등) | 심사 완료 여부 |
| 가상계좌 | 각 은행 (국민, 신한, 우리 등) | 계좌 발급 가능 여부 |
| 계좌이체 | 금융결제원 | 연동 승인 여부 |
| 휴대폰결제 | 각 통신사 (SKT, KT, LGU+) | 심사 완료 여부 |
NOTE
심사 현황 확인
원천사 심사 현황은 헥토파이낸셜 담당자 또는 가맹점 관리자 페이지에서 확인할 수 있습니다.
테스트 체크리스트
운영 전환 전 다음 항목을 반드시 테스트해야 합니다.
- 결제 성공 및 notiUrl 수신 확인
- pktHash 검증 로직 정상 동작 확인
- 사용할 모든 결제수단 정상 동작 확인
- 암호화/해시 키가 서버에만 존재하는지 확인 (클라이언트 노출 금지)
- 결제 실패 시 에러 처리 확인
- 결제 취소 정상 동작 확인
환경 변경
변경 항목
| 항목 | 테스트 | 운영 |
|---|---|---|
| 결제창 URL | https://tbnpg.settlebank.co.kr | https://npg.settlebank.co.kr |
| API URL | https://tbgw.settlebank.co.kr | https://gw.settlebank.co.kr |
| SDK URL | https://tbnpg.settlebank.co.kr/resources/js/v1/SettlePG_v1.2.js | https://npg.settlebank.co.kr/resources/js/v1/SettlePG_v1.2.js |
| 상점 ID | 테스트용 (예: nxca_jt_il) | 발급받은 운영 상점 ID |
| 라이센스 키 | ST1009281328226982205 | 발급받은 운영 라이센스 키 |
| AES 키 | pgSettle30y739r82jtd709yOfZ2yK5K | 발급받은 운영 AES 키 |
키 교체 주의
운영 환경 배포 시 반드시 운영 키로 교체되었는지 확인해야 합니다. 테스트 키로 운영 환경 배포 시 결제가 실패합니다.
방화벽 설정
notiUrl IP 허용
노티(결과통보)를 수신하려면 헥토파이낸셜 서버 IP를 방화벽에서 허용해야 합니다.
허용해야 할 IP (운영 환경)
| 센터 | IP 주소 | 용도 |
|---|---|---|
| Primary | 14.34.14.23 | 노티 발송 (메인) |
| Secondary | 61.252.169.24 | 노티 발송 (백업) |
양쪽 센터 모두 허용 필수
Primary와 Secondary IP를 모두 방화벽에서 허용해야 합니다. 하나라도 누락되면 센터 전환 시 노티를 수신하지 못할 수 있습니다.
Outbound 방화벽 설정
가맹점 서버에서 헥토파이낸셜 API 호출 시 다음 설정이 필요합니다.
| 구분 | 설정 |
|---|---|
| 프로토콜 | HTTPS (TCP/443) |
| 도메인 | gw.settlebank.co.kr (Primary)npg.settlebank.co.kr (결제창) |
| IP | DNS Lookup 권장 (hosts 고정 비권장) |
운영 전환 후 확인
전환 직후 다음 항목을 즉시 확인하세요.
즉시 확인 (전환 후 1시간 이내)
- 소액 테스트 결제 수행: 실제 결제가 정상 동작하는지 확인
- notiUrl 정상 수신: 노티가 정상적으로 수신되는지 로그 확인
- 데이터베이스 저장: 결제 정보가 DB에 정확히 저장되는지 확인
- 에러 로그 모니터링: 운영 환경 에러 로그 확인
운영 첫날 확인
- 전체 결제수단 정상 동작 확인
- 결제 취소 프로세스 정상 동작 확인
- 고객 문의사항 모니터링
- 결제 성공률 확인 (테스트 대비 급락 여부)
문제 발생 시 대응
일반적인 문제와 해결 방법
결제가 전혀 되지 않는 경우
- 운영 키 적용 여부 확인 (mchtId, 라이센스 키, AES 키)
- SDK URL이 운영 환경으로 변경되었는지 확인
- 원천사 심사 완료 여부 확인
노티가 수신되지 않는 경우
- 방화벽에서 헥토파이낸셜 IP 허용 여부 확인 (Primary + Secondary)
- notiUrl이 HTTPS인지 확인 (HTTP는 미지원)
- notiUrl 응답이 "OK"를 Plain Text로 반환하는지 확인
- notiUrl 서버가 정상 동작하는지 확인 (200 OK 응답)
pktHash 불일치 에러
- 라이센스 키가 올바르게 적용되었는지 확인
- 해시 생성 순서가 정확한지 확인 (연동 준비하기 문서 참고)
- 암호화 대상 필드는 평문 값을 사용하는지 확인
간헐적인 결제 실패
- 네트워크 타임아웃 설정 확인 (권장: 30초 이상)
- 서버 리소스 부족 여부 확인 (CPU, 메모리)
- 데이터베이스 커넥션 풀 크기 확인
긴급 연락처
문제 해결이 어려운 경우 헥토파이낸셜 기술지원팀에 문의하세요.
NOTE
기술지원 문의 시 준비사항
문의 시 다음 정보를 준비하세요: 상점 ID, 발생 시각, 거래번호(trdNo), 에러 메시지, 관련 로그
