헥토파이낸셜 개발자센터
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)
은행 코드응답 코드매체 코드은행 운영 및 점검시간
안심선불
연동 준비하기서버 및 네트워크 정보전체 연동 플로우
회원가입 화면 연동내정보 화면 연동
선불금 사용사용 취소머니 선물포인트 회수
잔액 조회잔액 옵션 조회잔액 상세 조회충전건별 잔액조회출금 가능 머니 조회거래 내역 조회거래 상세 조회상점 거래 상세 조회회원 정보 조회소멸 예정 포인트 조회충전 수단 조회
충전충전 취소머니 출금대기머니 출금
오류 코드거래구분코드

도구

암호화 테스트

010 가상계좌

휴대폰 번호(010-XXXX-XXXX) 기반의 가상계좌 서비스입니다. 고객의 휴대폰 점유인증을 통해 010 형식의 입금전용 가상계좌 번호를 발급합니다.


지원 결제수단

결제 방식설명결제창 지원API 지원
결제창 채번결제창에서 휴대폰 점유인증 후 가상계좌 발급O-
API 채번API로 직접 휴대폰 인증 및 가상계좌 발급-O

010 가상계좌 개발 문서 바로가기

🪟

결제창 (UI)

결제창을 통한 가상계좌 발급

📱

휴대폰 인증 API

휴대폰 점유인증 요청/확인

🏦

채번 API

가상계좌 번호 발급

❌

채번취소

입금 전 가상계좌 취소


결제 이해하기

결제창(UI) 방식

결제창 방식에서는 휴대폰 점유인증(S1/S2)과 채번(A4)이 자동으로 처리됩니다.

구매자
가맹점
헥토파이낸셜
K뱅크
11. 결제창 호출
1. 결제창 호출
22. 휴대폰 점유인증 요청 (SMS)
2. 휴대폰 점유인증 요청 (SMS)
33. 인증번호 입력
3. 인증번호 입력
44. 010 가상계좌 채번 요청
4. 010 가상계좌 채번 요청
55. 가상계좌 번호 발급
5. 가상계좌 번호 발급
66. 채번 노티 전송 (notiUrl)
6. 채번 노티 전송 (notiUrl)
77. 채번 결과 표시 (nextUrl)
7. 채번 결과 표시 (nextUrl)
88. 고객 입금
8. 고객 입금
99. 입금 확인
9. 입금 확인
1010. 입금 노티 전송 (notiUrl)
10. 입금 노티 전송 (notiUrl)
NOTE

노티(notiUrl) 2회 전송

가상계좌 거래는 채번 노티(outStatCd: 0051)와 입금 노티(outStatCd: 0021) 총 2번의 노티가 전달됩니다. 반드시 두 노티를 모두 처리해야 합니다. DB 처리는 반드시 notiUrl에서 수행하고, nextUrl은 결과 화면 표시 용도로만 사용하세요.

API 방식 - B2C

결제창을 사용하지 않는 경우, 가맹점 서버에서 아래 순서대로 API를 직접 호출해야 합니다.

구매자
가맹점 서버
헥토파이낸셜
K뱅크
11. 결제 요청 (휴대폰번호 입력)
1. 결제 요청 (휴대폰번호 입력)
22. 휴대폰 점유인증 요청 (S1)
2. 휴대폰 점유인증 요청 (S1)
33. SMS 인증번호 발송
3. SMS 인증번호 발송
44. 인증번호 입력
4. 인증번호 입력
55. 휴대폰 인증 확인 (S2)
5. 휴대폰 인증 확인 (S2)
66. 가상계좌 채번 요청 (A4)
6. 가상계좌 채번 요청 (A4)
77. K뱅크 가상계좌 발급
7. K뱅크 가상계좌 발급
88. 발급 결과
8. 발급 결과
99. 채번 노티 전송 (notiUrl)
9. 채번 노티 전송 (notiUrl)
1010. 고객 입금
10. 고객 입금
1111. 입금 확인
11. 입금 확인
1212. 입금 노티 전송 (notiUrl)
12. 입금 노티 전송 (notiUrl)

B2C API 호출 순서

순서APIbizType설명
1휴대폰 점유 인증 요청S1고객 휴대폰으로 SMS 인증번호 발송
2휴대폰 인증 확인S2고객이 입력한 인증번호 검증
3가상계좌 채번A4010 형식 가상계좌 번호 발급
NOTE

mchtTrdNo 동일 필수

S1(인증 요청)과 A4(채번)에서 사용하는 mchtTrdNo(상점주문번호)는 반드시 동일해야 합니다.

API 방식 - B2B

B2B 이용 시에는 채번 전에 동일 금액 확인(A7) API를 추가로 호출하여 중복 채번을 방지해야 합니다.

구매자
가맹점 서버
헥토파이낸셜
K뱅크
11. 결제 요청 (휴대폰번호 입력)
1. 결제 요청 (휴대폰번호 입력)
22. 휴대폰 점유인증 요청 (S1)
2. 휴대폰 점유인증 요청 (S1)
33. SMS 인증번호 발송
3. SMS 인증번호 발송
44. 인증번호 입력
4. 인증번호 입력
55. 휴대폰 인증 확인 (S2)
5. 휴대폰 인증 확인 (S2)
66. 동일 금액 확인 (A7)
6. 동일 금액 확인 (A7)
77. 가상계좌 채번 요청 (A4)
7. 가상계좌 채번 요청 (A4)
88. K뱅크 가상계좌 발급
8. K뱅크 가상계좌 발급
99. 발급 결과
9. 발급 결과
1010. 채번 노티 전송 (notiUrl)
10. 채번 노티 전송 (notiUrl)
1111. 고객 입금
11. 고객 입금
1212. 입금 확인
12. 입금 확인
1313. 입금 노티 전송 (notiUrl)
13. 입금 노티 전송 (notiUrl)

B2B API 호출 순서

순서APIbizType설명
1휴대폰 점유 인증 요청S1고객 휴대폰으로 SMS 인증번호 발송
2휴대폰 인증 확인S2고객이 입력한 인증번호 검증
3동일 금액 확인A7동일 금액으로 이미 채번된 거래 확인 (B2B 필수)
4가상계좌 채번A4010 형식 가상계좌 번호 발급

B2B 동일 금액 확인 필수

B2B 서비스 이용 시 A7(동일 금액 확인) 없이 A4(채번)를 요청하면, 이미 발급된 동일 금액의 가상계좌가 있을 경우 VA03 에러로 채번이 실패합니다.

B2C와 B2B 차이점

구분B2CB2B
입금 만료최대 27일최대 3년
통장인자명"010가상계좌" 고정"010_고객명" 형식
가상계좌번호휴대폰번호휴대폰번호 + 3자리
거래금액실제 결제 금액1원 이상 (실제 입금액과 무관)
동일 금액 확인 (A7)불필요필수

입금 후 처리

가상계좌 정상 발급 후 고객이 해당 계좌에 입금하면, 헥토파이낸셜에서 가맹점으로 **입금 결과 노티(notiUrl)**를 전송합니다.

  • 채번 취소 (A2): 고객 입금 전에 발급된 가상계좌를 취소합니다.
  • 환불 (C0): 고객 입금 후에 환불 처리합니다. (별도 환불 서비스 등록 필요)

주요 기능 및 특징

특징설명
휴대폰 기반010 형식의 휴대폰 번호가 가상계좌 번호로 사용됩니다
점유인증 필수휴대폰 점유인증을 통해 본인 확인 후 계좌 발급
K뱅크 연동K뱅크(089)를 통한 가상계좌 서비스
입금 만료 설정B2C: 최대 27일, B2B: 최대 3년

이런 서비스에 적합합니다

  • 본인 확인 필수 결제: 휴대폰 점유인증으로 본인 확인이 필요한 서비스
  • 간편한 입금: 고객이 기억하기 쉬운 010 번호 형식의 계좌
  • B2B 거래: 긴 입금 기한(최대 3년)이 필요한 기업간 거래

주의사항

운영 환경 테스트 주의

운영환경에서 테스트 시 발생하는 비용은 가맹점에서 부담합니다. 반드시 테스트베드에서 모든 테스트를 완료 후 운영환경을 이용해야 합니다.

점유인증 생략 조건

결제창(UI) 방식에서는 점유인증 생략 불가

결제창은 항상 UI 내에서 점유인증(SMS 발송 → 인증번호 입력)을 진행합니다. 아래 생략 조건은 API 방식에서만 유효합니다.

다음 조건을 모두 만족하는 경우 S1(인증 요청) → S2(인증 확인) 단계를 생략하고 A4(채번)를 바로 요청할 수 있습니다.

  • cphoneNo(휴대폰번호)와 mchtCustId(상점고객아이디)를 A4 채번 요청 시 함께 전송
  • 동일한 cphoneNo + mchtCustId 조합으로 27일 이내 점유인증(S1/S2) 완료 이력이 있어야 함

두 조건 중 하나라도 충족되지 않으면 S1 → S2 → A4 순서로 진행해야 합니다.

입금 만료일 설정

  • 입금만료일(expireDt)을 넣지 않으면 거래일 기준 +10일로 자동 설정됩니다.
  • B2C: 현재일자 기준 최대 27일
  • B2B: 현재일자 기준 최대 3년

통장인자명

  • B2C: "010가상계좌" 고정
  • B2B: "010_고객명" 형식

연동 정보

결제창(UI) URI

구분URL
테스트베드https://tbnpg.settlebank.co.kr
상용 환경https://npg.settlebank.co.kr

API URI

구분URL
테스트베드https://tbgw.settlebank.co.kr
상용 환경https://gw.settlebank.co.kr

보안 정보

암호화 방식 (AES-256)

개인정보가 포함된 파라미터는 암호화하여 전송해야 합니다.

구분항목
알고리즘AES-256/ECB/PKCS5Padding
인코딩Base64 Encoding
대상 필드거래금액, 고객명, 휴대폰번호, 이메일 등

위변조 방지 (SHA-256)

요청 데이터의 위변조를 방지하기 위해 해시값을 생성합니다.

구분항목
알고리즘SHA-256
인코딩Hex Encoding

테스트용 키 정보

암호화 키: pgSettle30y739r82jtd709yOfZ2yK5K
해시 생성 키: ST1009281328226982205
* 운영 환경에서는 헥토파이낸셜에서 별도 제공하는 키를 사용해야 합니다.

테스트 전용 정보

위 키와 상점 ID는 테스트 환경에서만 사용하세요. 운영 환경에서는 헥토파이낸셜에서 별도 발급하는 키와 상점 ID를 사용해야 합니다.

API 전체 목록

구분API설명bizType
결제창 연동채번 (단독창)UI 결제창을 통한 가상계좌 발급-
결제창 연동채번 (통합결제창)통합결제창을 통한 가상계좌 발급-
API 연동휴대폰 점유 인증SMS 인증번호 발송 요청S1
API 연동휴대폰 인증 확인SMS 인증번호 확인S2
API 연동동일 금액 확인동일 금액 중복 채번 확인 (B2B 필수)A7
API 연동채번가상계좌 번호 발급A4
API 연동채번 취소발급된 가상계좌 취소 (입금 전)A2
API 연동환불입금 완료 건 환불 처리C0
노티입금통보고객 입금 시 결과 통보B1
테스트입금테스트테스트 환경 입금 시뮬레이션F1

더 많은 API 문서

🔍

동일 금액 확인

B2B 중복 채번 방지 (A7)

↩️

환불

입금 완료 건 환불 처리

🔔

입금통보 노티

입금 완료 시 노티 처리

🧪

입금테스트

테스트 환경 입금 시뮬레이션

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub