헥토파이낸셜 개발자센터
Products서비스
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
API & SDKAPI & SDK
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그블로그
FAQFAQ
서비스 상태
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그
기술 블로그 및 소식
FAQ
자주 묻는 질문
서비스 상태
서비스 장애 및 점검 현황
PG 결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우노티(notiUrl) 연동결제 취소 및 환불운영 전환
결제창 연동JavaScript SDKFORM-SUBMIT
신용카드 표준 결제창신용카드 결제창 (직호출)신용카드 노티 전문신용카드 승인 (인증분리)신용카드 카드등록 (빌키발급 결제창)신용카드 빌키 결제신용카드 빌키 삭제신용카드 취소
계좌이체 결제창계좌이체 노티 전문계좌이체 승인 (인증분리)계좌이체 취소
가상계좌 결제창가상계좌 노티 전문가상계좌 채번가상계좌 채번 (고정식 무제한)가상계좌 채번정보 변경가상계좌 채번취소가상계좌 수취 조회가상계좌 환불가상계좌 입금테스트
010 가상계좌 개요010가상계좌 결제창휴대폰 점유 인증 요청휴대폰 인증 확인동일 금액 확인010가상계좌 채번010가상계좌 채번취소010가상계좌 환불010가상계좌 노티010가상계좌 입금테스트
휴대폰 결제창휴대폰결제 노티 전문휴대폰 승인 (하이브리드)휴대폰 자동결제휴대폰결제 취소휴대폰결제 환불
상품권 결제창상품권 노티 전문상품권 취소
티머니 결제창티머니 노티 전문티머니 취소
포인트다모아 결제창포인트다모아 노티 전문포인트다모아 승인 (인증/승인 분리)포인트다모아 취소
간편결제 개요페이코 결제창페이코 테스트 환경삼성페이 결제창카카오페이 결제창네이버페이 결제창토스페이 결제창간편결제 노티 전문간편결제 취소간편 정기결제간편 정기결제 상태조회간편 정기결제 키삭제
실시간 거래 조회영수증(매출전표) 조회 (무인증)영수증(매출전표) 조회 (인증)거래대사정산대사2차 이하 PG하위사업자 정보 등록영중소사업자 차액정산영중소사업자 환급정산
에러 코드카드사 코드금융기관 코드결제수단 코드가상계좌 은행 코드
내통장결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창 연동
내통장 결제인증내통장 결제승인내통장 결제취소내통장 망취소
내통장 거래결과조회내통장 거래내역조회현금영수증 조회
내통장 자동결제 키 발급내통장 자동결제 승인내통장 자동결제 해지
에러 코드금융기관 코드은행 점검시간
간편현금결제
연동 준비하기서버 및 네트워크 정보펌뱅킹 연동 플로우
휴대폰 본인인증 요청휴대폰 본인인증 확인예금주성명조회Ⅰ예금주성명조회Ⅱ예금주성명조회 (금액포함)계좌점유인증계좌점유인증 요청계좌점유인증 확인ARS 인증 요청ARS 인증 확인계좌점유인증 내역 조회결제비밀번호 확인
계좌 등록계좌 해지가맹점 자체 계좌 등록금융결제원 출금이체정보 해지 조회
결제결제 취소/환불송금송금계좌 잔액 조회
정기결제 키 발행정기결제 승인정기결제 해지정기결제 정보 조회정기결제 거래내역 조회
거래 결과 조회거래 내역 조회계좌 목록 조회은행 목록 조회은행 점검 조회계좌점유인증 은행점검조회테스트콜
연동 준비하기서버 및 네트워크 정보오픈뱅킹 연동 플로우
계좌 등록오픈뱅킹 계좌등록오픈뱅킹 서비스해지
결제결제 취소송금
자금반환청구 요청자금반환청구 확인
거래 결과 조회거래내역조회계좌목록조회출금이체한도 조회
거절코드표금융기관코드표은행 점검시간
화이트라벨
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창결제 승인결제 취소
조회
에러 코드금융기관 코드은행 점검시간
현금영수증
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
현금영수증 등록현금영수증 취소
현금영수증 발급오류내역 조회현금영수증 발급상태 조회
현금영수증 재처리 등록현금영수증 재처리 결과내역 조회
참고
실시간 펌뱅킹
연동 준비하기전체 연동 플로우
관리전문
당타행 지급이체집금(수납) 이체수납출금계좌 등록/해지일반지준이체 (SC은행)특정금전신탁 입지급 (우리은행)
타행이체불능통지예금거래명세통지어음명세통지어음명세결번일반지준이체결과통지 (SC은행)타행이체불능통지결번예금거래명세통지결번
계좌성명조회이체처리결과조회잔액조회일반지준이체결과조회 (SC은행)자동이체결과조회 (SC은행 전용)
자금이체집계집금이체집계통지현황
관리전문
외화송금의뢰외화송금의뢰취소외화송금결과통지외화송금결과통지 결번외화송금의뢰(MX)외화송금결과통지(MX)외화송금결과통지결번(MX)
국내 외화 당행 예금주명조회국내 외화 예금주명 조회환율정보거래환율정보거래(외환은행)외화 송금처리결과 조회외화잔액조회
외화송금집계외화자동이체집계외화당행송금집계
외화입출금거래명세통지외화입출금거래명세통지 결번
VAN 가상계좌
VAVS 시작하기통신 및 전문 구성전문 공통부
수취조회 (2000/2100)입금 및 취소
송금 (6010/6110)예치금 잔액조회 (6001/6101)
요약전문
성명조회 (2001/2101)실입금자명 통보 (1030/1130)실입금자명 파일 통보실입금자명 결번요청 (1033/1133)출금계좌등록 (5080/5180)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트
PG 결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우노티(notiUrl) 연동결제 취소 및 환불운영 전환
결제창 연동JavaScript SDKFORM-SUBMIT
신용카드 표준 결제창신용카드 결제창 (직호출)신용카드 노티 전문신용카드 승인 (인증분리)신용카드 카드등록 (빌키발급 결제창)신용카드 빌키 결제신용카드 빌키 삭제신용카드 취소
계좌이체 결제창계좌이체 노티 전문계좌이체 승인 (인증분리)계좌이체 취소
가상계좌 결제창가상계좌 노티 전문가상계좌 채번가상계좌 채번 (고정식 무제한)가상계좌 채번정보 변경가상계좌 채번취소가상계좌 수취 조회가상계좌 환불가상계좌 입금테스트
010 가상계좌 개요010가상계좌 결제창휴대폰 점유 인증 요청휴대폰 인증 확인동일 금액 확인010가상계좌 채번010가상계좌 채번취소010가상계좌 환불010가상계좌 노티010가상계좌 입금테스트
휴대폰 결제창휴대폰결제 노티 전문휴대폰 승인 (하이브리드)휴대폰 자동결제휴대폰결제 취소휴대폰결제 환불
상품권 결제창상품권 노티 전문상품권 취소
티머니 결제창티머니 노티 전문티머니 취소
포인트다모아 결제창포인트다모아 노티 전문포인트다모아 승인 (인증/승인 분리)포인트다모아 취소
간편결제 개요페이코 결제창페이코 테스트 환경삼성페이 결제창카카오페이 결제창네이버페이 결제창토스페이 결제창간편결제 노티 전문간편결제 취소간편 정기결제간편 정기결제 상태조회간편 정기결제 키삭제
실시간 거래 조회영수증(매출전표) 조회 (무인증)영수증(매출전표) 조회 (인증)거래대사정산대사2차 이하 PG하위사업자 정보 등록영중소사업자 차액정산영중소사업자 환급정산
에러 코드카드사 코드금융기관 코드결제수단 코드가상계좌 은행 코드
내통장결제
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창 연동
내통장 결제인증내통장 결제승인내통장 결제취소내통장 망취소
내통장 거래결과조회내통장 거래내역조회현금영수증 조회
내통장 자동결제 키 발급내통장 자동결제 승인내통장 자동결제 해지
에러 코드금융기관 코드은행 점검시간
간편현금결제
연동 준비하기서버 및 네트워크 정보펌뱅킹 연동 플로우
휴대폰 본인인증 요청휴대폰 본인인증 확인예금주성명조회Ⅰ예금주성명조회Ⅱ예금주성명조회 (금액포함)계좌점유인증계좌점유인증 요청계좌점유인증 확인ARS 인증 요청ARS 인증 확인계좌점유인증 내역 조회결제비밀번호 확인
계좌 등록계좌 해지가맹점 자체 계좌 등록금융결제원 출금이체정보 해지 조회
결제결제 취소/환불송금송금계좌 잔액 조회
정기결제 키 발행정기결제 승인정기결제 해지정기결제 정보 조회정기결제 거래내역 조회
거래 결과 조회거래 내역 조회계좌 목록 조회은행 목록 조회은행 점검 조회계좌점유인증 은행점검조회테스트콜
연동 준비하기서버 및 네트워크 정보오픈뱅킹 연동 플로우
계좌 등록오픈뱅킹 계좌등록오픈뱅킹 서비스해지
결제결제 취소송금
자금반환청구 요청자금반환청구 확인
거래 결과 조회거래내역조회계좌목록조회출금이체한도 조회
거절코드표금융기관코드표은행 점검시간
화이트라벨
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
결제창결제 승인결제 취소
조회
에러 코드금융기관 코드은행 점검시간
현금영수증
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
현금영수증 등록현금영수증 취소
현금영수증 발급오류내역 조회현금영수증 발급상태 조회
현금영수증 재처리 등록현금영수증 재처리 결과내역 조회
참고
실시간 펌뱅킹
연동 준비하기전체 연동 플로우
관리전문
당타행 지급이체집금(수납) 이체수납출금계좌 등록/해지일반지준이체 (SC은행)특정금전신탁 입지급 (우리은행)
타행이체불능통지예금거래명세통지어음명세통지어음명세결번일반지준이체결과통지 (SC은행)타행이체불능통지결번예금거래명세통지결번
계좌성명조회이체처리결과조회잔액조회일반지준이체결과조회 (SC은행)자동이체결과조회 (SC은행 전용)
자금이체집계집금이체집계통지현황
관리전문
외화송금의뢰외화송금의뢰취소외화송금결과통지외화송금결과통지 결번외화송금의뢰(MX)외화송금결과통지(MX)외화송금결과통지결번(MX)
국내 외화 당행 예금주명조회국내 외화 예금주명 조회환율정보거래환율정보거래(외환은행)외화 송금처리결과 조회외화잔액조회
외화송금집계외화자동이체집계외화당행송금집계
외화입출금거래명세통지외화입출금거래명세통지 결번
VAN 가상계좌
VAVS 시작하기통신 및 전문 구성전문 공통부
수취조회 (2000/2100)입금 및 취소
송금 (6010/6110)예치금 잔액조회 (6001/6101)
요약전문
성명조회 (2001/2101)실입금자명 통보 (1030/1130)실입금자명 파일 통보실입금자명 결번요청 (1033/1133)출금계좌등록 (5080/5180)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트

JavaScript SDK 연동 API

헥토파이낸셜 JavaScript SDK(SettlePG)를 사용하여 결제창을 연동하는 방법을 설명합니다.


주의 사항

결제창 타임아웃

결제창 진입 후 10분이 경과하면 '거래 시간이 초과했습니다' 오류가 발생합니다. 고객이 결제를 완료하지 못한 경우 결제창을 다시 호출해야 합니다.

SDK 스크립트 로드

<!-- 테스트 환경 -->
<script src="https://tbnpg.settlebank.co.kr/resources/js/v1/SettlePG_v1.2.js"></script>

<!-- 운영 환경 -->
<script src="https://npg.settlebank.co.kr/resources/js/v1/SettlePG_v1.2.js"></script>

SETTLE_PG.pay()

SETTLE_PG.pay(options, callback);
파라미터타입필수설명
optionsObjectO결제 요청 파라미터 (아래 상세 참고)
callbackFunction-iframe 방식에서 결과 수신 콜백

스크립트 파라미터 정의

SETTLE_PG.pay()의 options 객체에 전달하는 파라미터입니다. SDK는 env, ui와 필수 파라미터(mchtId, method, mchtTrdNo, trdDt, trdTm, trdAmt, mchtName, pmtPrdtNm, notiUrl, nextUrl, cancUrl, pktHash)가 비어 있는지, method 값이 올바른지를 검증하며, 나머지 파라미터는 서버에서 검증됩니다.

결제수단별 추가 파라미터(카드사명, 가상계좌번호 등)는 결제창 연동 문서를 참고하세요.

NOTE

주문 처리 주의

실제 주문 처리(재고 차감, 상태 변경)는 반드시 notiUrl에서 수행해야 합니다. 자세한 내용은 노티 연동 가이드를 참고하세요. 노티(notiUrl) 연동 가이드

필수 파라미터

└envstring*결제 시스템 환경 URLhttps://tbnpg.settlebank.co.kr
결제 시스템 환경 URL
테스트: https://tbnpg.settlebank.co.kr 운영: https://npg.settlebank.co.kr
파라미터
타입
설명
예시
env필수
string
결제 시스템 환경 URL
테스트: https://tbnpg.settlebank.co.kr / 운영: https://npg.settlebank.co.kr
https://tbnpg.settlebank.co.kr
└mchtIdstring*헥토파이낸셜에서 부여한 상점 IDnxca_jt_il
헥토파이낸셜에서 부여한 상점 ID
파라미터
타입
설명
예시
mchtId필수
string
헥토파이낸셜에서 부여한 상점 ID
nxca_jt_il
└methodstring*결제수단 코드card
결제수단 코드
card: 신용카드 bank: 계좌이체 vbank: 가상계좌 vbank010: 010가상계좌 mobile: 휴대폰결제 tmoney: 티머니 point: 포인트다모아 corp: 간편결제 teencash: 틴캐시 culturecash: 컬쳐캐쉬 smartcash: 스마트문상 booknlife: 도서상품권
*목록에 없는 값은 SDK가 'method is wrong' 오류를 표시합니다.
파라미터
타입
설명
예시
method필수
string
결제수단 코드
card: 신용카드 / bank: 계좌이체 / vbank: 가상계좌 / vbank010: 010가상계좌 / mobile: 휴대폰결제 / tmoney: 티머니 / point: 포인트다모아 / corp: 간편결제 / teencash: 틴캐시 / culturecash: 컬쳐캐쉬 / smartcash: 스마트문상 / booknlife: 도서상품권
* 목록에 없는 값은 SDK가 'method is wrong' 오류를 표시합니다.
card
└trdDtstring*거래일자 (YYYYMMDD 형식)20240101
거래일자 (YYYYMMDD 형식)
파라미터
타입
설명
예시
trdDt필수
string
거래일자 (YYYYMMDD 형식)
20240101
└trdTmstring*거래시간 (HHMMSS 형식)153045
거래시간 (HHMMSS 형식)
파라미터
타입
설명
예시
trdTm필수
string
거래시간 (HHMMSS 형식)
153045
└mchtTrdNostring*상점 주문번호 (고유값, 중복 불가)ORDER20240101153045
상점 주문번호 (고유값, 중복 불가)
파라미터
타입
설명
예시
mchtTrdNo필수
string
상점 주문번호 (고유값, 중복 불가)
ORDER20240101153045
└trdAmtstring*거래금액 (원 단위)10000
거래금액 (원 단위)
파라미터
타입
설명
예시
trdAmt필수
string
거래금액 (원 단위)
10000
└notiUrlstring*결제 결과 통보 URL (서버 to 서버)https://example.com/api/payment/noti
결제 결과 통보 URL (서버 to 서버)
파라미터
타입
설명
예시
notiUrl필수
string
결제 결과 통보 URL (서버 to 서버)
https://example.com/api/payment/noti
└nextUrlstring*결제 완료 후 리다이렉트 URLhttps://example.com/payment/success
결제 완료 후 리다이렉트 URL
파라미터
타입
설명
예시
nextUrl필수
string
결제 완료 후 리다이렉트 URL
https://example.com/payment/success
└pktHashstring*위변조 방지 해시값 (SHA-256)abc123...
위변조 방지 해시값 (SHA-256)
파라미터
타입
설명
예시
pktHash필수
string
위변조 방지 해시값 (SHA-256)
abc123...
└mchtNamestring*상점명 (한글)헥토파이낸셜
상점명 (한글)
파라미터
타입
설명
예시
mchtName필수
string
상점명 (한글)
헥토파이낸셜
└pmtPrdtNmstring*결제 상품명노트북 구매
결제 상품명
파라미터
타입
설명
예시
pmtPrdtNm필수
string
결제 상품명
노트북 구매
└cancUrlstring*결제 취소 시 리다이렉트 URLhttps://example.com/payment/cancel
결제 취소 시 리다이렉트 URL
파라미터
타입
설명
예시
cancUrl필수
string
결제 취소 시 리다이렉트 URL
https://example.com/payment/cancel
└uiobject*UI 설정 객체 (type, width, height){ type: "popup", width: 430, height: 660 }
UI 설정 객체 (type, width, height)
파라미터
타입
설명
예시
ui필수
object
UI 설정 객체 (type, width, height)
{ type: "popup", width: 430, height: 660 }

선택 파라미터

└methodSubstring신용카드 결제창 세부 방식. 지정하지 않으면 일반 카드 결제창(/card/main.do)을 호출합니다.auth
신용카드 결제창 세부 방식. 지정하지 않으면 일반 카드 결제창(/card/main.do)을 호출합니다.
direct: 신용카드 직호출 (/card/cardDirect.do) auth: 카드등록(빌키발급) 결제창 (/card/cardAuth.do)
*method='card'와 함께 사용. direct는 cardGb(카드사 코드)도 함께 전달해야 하며, auth의 요청 파라미터는 카드등록(빌키발급) 결제창 문서를 참고하세요.
파라미터
타입
설명
예시
methodSub
string
신용카드 결제창 세부 방식. 지정하지 않으면 일반 카드 결제창(/card/main.do)을 호출합니다.
direct: 신용카드 직호출 (/card/cardDirect.do) / auth: 카드등록(빌키발급) 결제창 (/card/cardAuth.do)
* method='card'와 함께 사용. direct는 cardGb(카드사 코드)도 함께 전달해야 하며, auth의 요청 파라미터는 카드등록(빌키발급) 결제창 문서를 참고하세요.
auth
└mchtENamestring상점명 (영문)Hecto Financial
상점명 (영문)
파라미터
타입
설명
예시
mchtEName
string
상점명 (영문)
Hecto Financial
└mchtCustNmstring고객명홍길동
고객명
파라미터
타입
설명
예시
mchtCustNm
string
고객명
홍길동
└custAcntSumrystring고객 계좌 요약 정보신한 1234-56-7890
고객 계좌 요약 정보
파라미터
타입
설명
예시
custAcntSumry
string
고객 계좌 요약 정보
신한 1234-56-7890
└mchtParamstring상점 고유 파라미터 (notiUrl, nextUrl로 전달됨)name=Hong&age=25
상점 고유 파라미터 (notiUrl, nextUrl로 전달됨)
파라미터
타입
설명
예시
mchtParam
string
상점 고유 파라미터 (notiUrl, nextUrl로 전달됨)
name=Hong&age=25
└custIpstring고객 IP 주소. IPv4 형식으로 입력 (IPv6 불가)127.0.0.1
고객 IP 주소. IPv4 형식으로 입력 (IPv6 불가)
파라미터
타입
설명
예시
custIp
string
고객 IP 주소. IPv4 형식으로 입력 (IPv6 불가)
127.0.0.1

ui 객체 파라미터

└ui.typestring*결제창 표시 방식popup
결제창 표시 방식
popup: 팝업창 iframe: 레이어 self: 현재창 blank: 새창
파라미터
타입
설명
예시
ui.type필수
string
결제창 표시 방식
popup: 팝업창 / iframe: 레이어 / self: 현재창 / blank: 새창
popup
└ui.widthstring팝업창 너비 (px, popup/iframe 방식에서만 사용)430
팝업창 너비 (px, popup/iframe 방식에서만 사용)
파라미터
타입
설명
예시
ui.width
string
팝업창 너비 (px, popup/iframe 방식에서만 사용)
430
└ui.heightstring팝업창 높이 (px, popup/iframe 방식에서만 사용)660
팝업창 높이 (px, popup/iframe 방식에서만 사용)
파라미터
타입
설명
예시
ui.height
string
팝업창 높이 (px, popup/iframe 방식에서만 사용)
660

UI 타입별 동작

SDK의 ui.type 옵션으로 결제창 표시 방식을 지정합니다.

popup (팝업)

SETTLE_PG.pay({
    env: "https://tbnpg.settlebank.co.kr",
    ui: { type: "popup", width: 430, height: 660 },
    // ... 결제수단별 파라미터
}, null);
  • 별도 팝업 창에서 결제창 표시
  • 팝업 차단 시 안내 메시지 표시
  • 결제 완료 후 nextUrl로 리다이렉트

iframe (레이어) ⚠️

iframe 방식은 지양하세요

iframe 방식은 로컬 네트워크 접근 제한, 브라우저 호환성 문제 등의 이슈가 있어 권장하지 않습니다. popup, self, blank 방식 사용을 권장합니다.
SETTLE_PG.pay({
    env: "https://tbnpg.settlebank.co.kr",
    ui: { type: "iframe", width: 430, height: 660 },
    // ... 결제수단별 파라미터
}, function(response) {
    // 결과 수신
    if (response.outStatCd === "0021") {
        console.log("성공:", response.trdNo);
    } else {
        console.log("실패:", response.outRsltMsg);
    }
});
  • 현재 페이지 위에 dimmed 레이어와 함께 결제창 표시
  • 콜백 함수로 결제 결과 수신 (iframe만 해당)
NOTE

iframe 콜백은 화면 표시용

콜백 함수는 iframe 방식에서만 호출됩니다. popup, self, blank 방식에서는 콜백이 호출되지 않고 nextUrl로 리다이렉트됩니다.

콜백 응답 파라미터

iframe 방식에서 콜백 함수로 전달되는 response 객체의 주요 파라미터입니다.

파라미터타입설명
outStatCdAN(4)거래상태 코드 (0021: 성공, 0031: 실패, 0041: 대기, 0051: 진행중)
outRsltCdAN(4)상세 결과 코드
outRsltMsgAHN(200)결과 메시지
trdNoAN(40)헥토파이낸셜 거래번호
mchtTrdNoAN(100)상점 주문번호
trdAmtN(12)거래금액
methodA(10)결제수단 코드

self (현재 창)

SETTLE_PG.pay({
    env: "https://tbnpg.settlebank.co.kr",
    ui: { type: "self" },
    // ... 결제수단별 파라미터
}, null);
  • 현재 창에서 결제 페이지로 이동
  • 결제 완료 후 nextUrl로 리다이렉트
  • 뒤로가기 시 cancUrl로 이동

blank (새 창)

SETTLE_PG.pay({
    env: "https://tbnpg.settlebank.co.kr",
    ui: { type: "blank" },
    // ... 결제수단별 파라미터
}, null);
  • 새 탭/창에서 결제창 표시
  • 팝업과 유사하나 브라우저 기본 새 창 동작 사용

서버 사이드 처리

SDK 호출 전 백엔드에서 거래금액 암호화(AES-256)와 위변조 방지 해시(SHA-256)를 생성해야 합니다.

상세 정보: 연동 준비하기 — 암복호화 및 위변조 방지


에러 처리

SDK는 아래 두 가지 경우에 브라우저 alert을 표시합니다.

팝업 차단

developers.hectofinancial.co.kr의 메시지

[헥토파이낸셜] 팝업 차단 설정이 되어 있습니다. 해제 후 다시 이용해 주세요.

팝업 차단 해제 방법:

  • Chrome: 주소창 우측 팝업 차단 아이콘 클릭 → '항상 허용'
  • Safari: 환경설정 → 웹사이트 → 팝업 윈도우 → '허용'
  • Edge: 설정 → 쿠키 및 사이트 권한 → 팝업 및 리디렉션 → 허용

필수 파라미터 누락

env, ui 또는 필수 파라미터(mchtId, method, mchtTrdNo, trdDt, trdTm, trdAmt, mchtName, pmtPrdtNm, notiUrl, nextUrl, cancUrl, pktHash)가 비어 있거나 method 값이 올바르지 않으면 alert을 표시합니다.

NOTE

서버 검증

결제수단별 세부 파라미터(카드번호, 유효기간 등)는 SDK가 아닌 서버에서 검증됩니다. 서버 검증 실패 시 결제창에서 에러 메시지가 표시됩니다.
developers.hectofinancial.co.kr의 메시지

[헥토파이낸셜] 호출 파라미터 오류 (mchtId is null)


결제수단별 파라미터

SDK 연동 방법은 모든 결제수단에서 동일합니다. 각 결제수단별 상세 파라미터는 왼쪽 메뉴의 결제수단별 연동 문서를 참고하세요.

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub