헥토파이낸셜 개발자센터
Products서비스
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
API & SDKAPI & SDK
PG 결제
다양한 간편 결제
내통장결제
실시간 계좌이체 서비스
간편현금결제
계좌 등록 / 결제 / 송금
화이트라벨
브랜드페이-통합결제지원
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그블로그
FAQFAQ
서비스 상태
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
MCP 서버 및 AI 챗봇
PG 결제
내통장결제
간편현금결제
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
블로그
기술 블로그 및 소식
FAQ
자주 묻는 질문
서비스 상태
서비스 장애 및 점검 현황
시작하기신용카드 결제가상계좌 결제010 가상계좌계좌이체 결제휴대폰 결제상품권 결제포인트 다모아간편결제
내통장결제
펌뱅킹오픈뱅킹
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
시작하기신용카드 결제가상계좌 결제010 가상계좌계좌이체 결제휴대폰 결제상품권 결제포인트 다모아간편결제
내통장결제
펌뱅킹오픈뱅킹
화이트라벨
현금영수증
실시간 펌뱅킹
VAN 가상계좌
안심선불
LLMs로 연동하기
서비스PG 결제가상계좌 결제

가상계좌 결제

가상계좌(무통장입금)는 구매자에게 임시 계좌번호를 발급하고, 해당 계좌로 입금하면 결제가 완료되는 방식입니다.
카드가 없는 고객도 결제할 수 있고, 입금 확인이 자동으로 처리되어 가맹점의 운영 효율을 높여줍니다.

일반적인 결제 수단과 달리, 가상계좌는 채번(계좌 발급)과 입금이 분리된 비동기 구조로 동작합니다.
결제 요청 시 실제 결제가 발생하지 않고 계좌만 발급되며, 고객이 해당 계좌에 입금해야 비로소 결제가 완료됩니다.

NOTE

가상계좌 결제의 핵심 흐름. Step1 : 채번 요청 → 가상계좌 발급 Step2 : 구매자 입금 → 입금 확인 노티 수신 → 주문 완료 처리. 채번과 입금이 분리되어 있으므로, notiUrl을 통한 입금 통보 처리가 필수입니다.

계좌 방식 알아보기

헥토파이낸셜은 서비스 특성에 맞게 선택할 수 있도록 세 가지 방식을 제공합니다.

회전식결제창 ✓API ✓

헥토파이낸셜이 보유한 계좌 풀(Pool)에서 주문마다 다른 계좌번호를 자동으로 할당하는 방식입니다. 가맹점이 계좌를 별도로 관리할 필요 없이, 요청 즉시 사용 가능한 계좌가 발급됩니다.

  • 주문마다 고유한 계좌번호가 자동으로 발급됩니다.
  • 입금 기한이 지나면 계좌가 자동 회수되어 다른 주문에 재사용됩니다.
고정식결제창 ✗API ✓

가맹점이 사전에 전달받은 계좌를 사용하여, 입금이 필요할 때마다 채번 API를 호출하는 방식입니다. 계좌(Pool)를 가맹점이 직접 관리하고 싶을 때 적합합니다.

  • 사전에 할당받은 계좌를 가맹점이 직접 관리합니다.
  • 주문 건마다 채번 API를 호출하여 해당 계좌를 활성화합니다.
  • 입금 이후에 계좌는 초기화 됩니다. 이후 채번 API 호출하여 재 활성화 후 사용합니다.
  • 영업담당자 협의를 통해 신청할 수 있습니다.
고정무제한결제창 ✗API ✓

1회 채번 활성화 이후에 금액을 체크하지 않고 입금 시마다 통보하는 방식입니다.

  • 최초 1회 채번 후 계좌를 상시 입금 가능한 상태로 전환합니다.
  • 금액과 무관하게 입금 시마다 통보합니다.
  • 사전 채번(헥토파이낸셜이 미리 발급) 또는 가맹점 채번(API 호출) 방식을 선택할 수 있습니다.
NOTE
고정무제한 계좌는 영업담당자 협의를 통해 신청해야 합니다. 사전 채번 방식은 API 연동 없이 사용 가능합니다.

결제 흐름 알아보기

결제창 연동

가맹점 웹페이지에서 헥토파이낸셜 결제창을 호출하면, 구매자가 결제창에서 은행을 선택하고 가상계좌를 발급받습니다. 입금이 완료되면 헥토파이낸셜이 가맹점 서버로 결과를 전달합니다.

구매자
가맹점
헥토파이낸셜
은행
11. 주문서에서 결제 요청
1. 주문서에서 결제 요청
22. 결제창 호출 (JS SDK)
2. 결제창 호출 (JS SDK)
33. 결제창 표시 (은행 선택)
3. 결제창 표시 (은행 선택)
44. 은행 선택 및 정보 입력
4. 은행 선택 및 정보 입력
55. 채번 노티 (가상계좌 정보, outStatCd
5. 채번 노티 (가상계좌 정보, outStatCd
66. 가상계좌 안내 (계좌번호, 입금 기한)
6. 가상계좌 안내 (계좌번호, 입금 기한)
77. 입금
7. 입금
88. 입금 확인
8. 입금 확인
99. 입금 노티 (outStatCd
9. 입금 노티 (outStatCd

각 단계 상세

  1. 1결제 요청 : 구매자가 주문서에서 가상계좌 결제를 선택합니다.
  2. 2결제창 호출 : 가맹점이 JavaScript SDK(SETTLE_PG.pay)를 호출하여 결제창을 띄웁니다.
  3. 3은행 선택 : 구매자가 결제창에서 입금할 은행을 선택합니다.
  4. 4채번 노티 : 헥토파이낸셜이 가상계좌 정보(계좌번호, 입금 기한)를 notiUrl로 전달합니다. (outStatCd: 0051)
  5. 5입금 안내 : 가맹점이 구매자에게 발급된 가상계좌 정보를 안내합니다.
  6. 6입금 : 구매자가 안내받은 계좌로 입금합니다.
  7. 7입금 노티 : 입금이 확인되면 헥토파이낸셜이 notiUrl로 입금 완료를 전달합니다. (outStatCd: 0021)
노티 연동은 필수입니다. 채번 노티(outStatCd: 0051)는 계좌가 발급된 시점에 전달되고, 입금 노티(outStatCd: 0021)는 고객이 실제로 입금한 시점에 전달됩니다. ` 두 노티 모두 notiUrl로 수신하므로 outStatCd로 구분하여 처리해야 합니다.

결제창 vs API 비교

항목결제창 연동API 연동
계좌 방식회전식회전식, 고정식, 고정무제한
결제 UI헥토파이낸셜 제공 결제창가맹점 자체 디자인 가능
notiUrl필수 (채번 + 입금)채번 노티 선택 / 입금 노티 필수

API 연동

가맹점 서버에서 헥토파이낸셜 채번 API를 직접 호출하여 가상계좌를 발급하는 방식입니다. 결제창 없이 서버 간 통신으로 처리하므로, 자체 UI를 구축하거나 고정식/고정무제한 계좌를 사용할 때 적합합니다.

구매자
가맹점
헥토파이낸셜
은행
11. 결제 요청
1. 결제 요청
22. 채번 API 호출
2. 채번 API 호출
33. 가상계좌 정보 응답
3. 가상계좌 정보 응답
44. 가상계좌 안내
4. 가상계좌 안내
55. 입금
5. 입금
66. 입금 확인
6. 입금 확인
77. 입금 노티 (notiUrl)
7. 입금 노티 (notiUrl)

각 단계 상세

  1. 1결제 요청 : 구매자가 가맹점에서 가상계좌 결제를 요청합니다.
  2. 2채번 API 호출 : 가맹점 서버가 헥토파이낸셜 채번 API를 호출합니다.
  3. 3계좌 정보 응답 : 헥토파이낸셜이 발급된 가상계좌 정보(은행, 계좌번호, 입금 기한)를 API 응답으로 전달합니다.
  4. 4입금 안내 : 가맹점이 구매자에게 가상계좌 정보를 안내합니다.
  5. 5입금 : 구매자가 안내받은 계좌로 입금합니다.
  6. 6입금 노티 : 입금이 확인되면 헥토파이낸셜이 notiUrl로 입금 완료를 전달합니다.
NOTE
API 연동에서도 입금 notiUrl은 필수입니다. notiUrl로 입금 통보를 수신해야 합니다.

주요 기능 및 특징

1. 유효성 체크

일반 가상계좌와 다르게 입금 기한, 입금 금액 등을 체크하여 정상적인 입금 여부를 확인합니다.

2. 가상계좌 만료 처리

입금 기한이 지나도 입금이 없으면 계좌가 자동 만료됩니다.

가상계좌 만료 시 별도 노티가 발송되지 않습니다. 만료된 계좌에 대한 처리(주문 취소, 재발급 안내 등)는 가맹점에서 별도로 구현해야 합니다. 만료 기한 도달 여부를 주기적으로 확인하는 배치 처리를 권장합니다.

3. 가맹점 수취조회 기능

기본적으로 PG사에서 수취조회 기능을 대행하고 있습니다. 다만 필요시 영업담당자를 통해 요청하면 수취조회를 가맹점에서 체크할 수 있습니다.

4. 현금영수증

가상계좌는 현금성 결제로 분류되어 현금영수증 발행 대상입니다. 결제창을 통해 연동하는 경우 따로 연동할 필요 없습니다. WEB-API를 통해 채번하는 경우 파라미터를 통해 현금영수증 설정이 가능합니다.

5. 은행 직계약

헥토파이낸셜 가상계좌 외에 은행과 직접 계약이 된 경우,
또는 일부 은행만 사용하는 경우에도 영업담당자를 통해 설정 가능합니다.

취소 및 환불

가상계좌의 취소와 환불은 입금 전/후에 따라 처리 방법이 달라집니다.

구분처리 방법설명
입금 전 취소채번취소 API발급된 계좌를 회수합니다. 고객이 입금하지 않은 상태에서 주문 취소 시 사용합니다.
입금 후 환불환불 API고객 계좌로 입금된 금액을 송금합니다. 환불계좌 정보를 고객으로부터 직접 입력받아야 합니다.
환불 처리 기간영업일 기준 2~5일일반적으로 영업일 기준 익일 환불 진행되나 일부 예외적인 경우 시일이 걸릴 수 있습니다.
NOTE

입금 전 취소와 입금 후 환불의 차이. 입금 전 취소는 발급된 가상계좌를 단순히 회수하는 것이므로 즉시 처리됩니다. 입금 후 환불은 고객 계좌로 별도 송금해야 하므로 환불계좌 정보가 필요하고, 처리 시간이 소요됩니다.

연동 전 확인사항

가상계좌 결제 연동을 시작하기 전에, 아래 사항을 미리 확인해 두면 좋습니다.

상점아이디 관련

  • 회전식, 고정식, 고정무제한 등 계좌 방식에 따라 상점아이디가 분리될 수 있습니다. 사용할 방식을 미리 확인하고, 영업 담당자와 협의해 주세요.
  • 테스트 환경과 운영 환경의 상점아이디는 다릅니다. 운영환경에서 테스트하면 실제 비용이 발생하니, 꼭 테스트베드를 이용해 주세요.

기타 관련

  • 가상계좌는 notiUrl 연동이 필수입니다. 회전식/고정식은 채번 노티(0051)와 입금 노티(0021)를 처리해야 합니다. 고정무제한은 채번 노티가 발송되지 않으며, 입금 노티(0021/B1)와 설정 시 자동취소 노티(0121/B2)를 처리해야 합니다.
  • 고정식/고정무제한 방식은 notiUrl을 영업담당자에게 미리 전달해야 합니다.
  • 은행 점검 시간(23:30~00:35)에는 채번 및 취소 요청을 피해 주세요.
  • 취소 기한은 1년입니다.

영업/심사 관련

  • 고정식, 고정무제한 방식은 영업담당자 협의를 통해 신청해야 합니다.
  • 영업 문의 :

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

🏦

가상계좌 발급 API

고정식/회전식 계좌 채번

📱

010 가상계좌

휴대폰 번호 기반 계좌 발급

💸

환불 요청 API

입금 후 고객 계좌로 반환

🚫

채번 취소 API

입금 전 계좌 회수

🔍

수취 조회 API

가맹점 직접 유효성 검증

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub