헥토파이낸셜 개발자센터
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 결제010 가상계좌

010 가상계좌

휴대폰번호(010-0000-0000) 를 가상 계좌번호로 사용하는 가상계좌 서비스입니다.
복잡한 계좌번호 대신 휴대폰번호를 사용하여 입금 편의성을 높였습니다.

NOTE

010 가상계좌의 핵심 흐름. Step1 : 채번 요청 → 010 가상계좌 발급 Step2 : 구매자 입금 → 입금 확인 노티 수신 → 주문 완료 처리. 일반 가상계좌와 동일하게 notiUrl을 통한 입금 통보 처리가 필수입니다.

결제 방식 알아보기

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

010 가상계좌결제창 ✓API ✓

고객의 휴대폰번호(010-0000-0000)를 가상 계좌번호로 사용하는 가상계좌 서비스입니다. 복잡한 계좌번호 대신 휴대폰번호를 사용하여 입금 편의성을 높였습니다.

  • K뱅크(089)를 통해 본인 휴대폰번호로 가상계좌가 발급됩니다.
  • 자신의 휴대폰번호를 계좌번호로 사용하여 쉽게 입금할 수 있습니다.
일반 가상계좌결제창 ✓API ✓

은행별 표준 계좌번호 형식으로 발급되는 가상계좌 서비스입니다. 다수의 은행을 지원하며, 범용 무통장 입금에 적합합니다.

  • 다수 은행을 지원하여 고객이 원하는 은행을 선택할 수 있습니다.
NOTE
일반 가상계좌는 별도 문서를 참고해 주세요.

결제 흐름 알아보기

결제창 연동

고객이 결제창에서 결제 정보를 입력하고 010 가상계좌를 발급받습니다. 발급된 계좌(휴대폰번호)로 입금이 완료되면 notiUrl을 통해 입금 결과를 전달합니다.

구매자
가맹점
헥토파이낸셜
K뱅크
11. 주문서에서 결제 요청
1. 주문서에서 결제 요청
22. 결제창 호출 (JS SDK)
2. 결제창 호출 (JS SDK)
33. 결제창 표시
3. 결제창 표시
44. 결제 정보 입력
4. 결제 정보 입력
55. 010 가상계좌 채번 요청
5. 010 가상계좌 채번 요청
66. 010 가상계좌 발급
6. 010 가상계좌 발급
77. 가상계좌 정보 전달 (notiUrl)
7. 가상계좌 정보 전달 (notiUrl)

각 단계 상세

  1. 1결제 요청 : 구매자가 주문서에서 결제 수단을 선택하고 "결제하기" 버튼을 클릭합니다.
  2. 2결제창 호출 : 가맹점은 헥토파이낸셜 JavaScript SDK(SETTLE_PG.pay)를 호출하여 결제창을 띄웁니다.
  3. 3결제창 표시 : 구매자에게 010 가상계좌 결제 정보 입력 화면이 나타납니다.
  4. 4정보 입력 : 구매자가 필요한 결제 정보를 입력합니다.
  5. 5채번 요청 : 헥토파이낸셜이 K뱅크에 010 가상계좌 채번을 요청합니다.
  6. 6계좌 발급 : K뱅크가 010-XXXX-XXXX 형식의 가상계좌를 발급합니다.
  7. 7결과 전달 : 헥토파이낸셜이 가맹점 서버의 notiUrl로 가상계좌 정보를 전달합니다.
notiUrl은 꼭 구현해 주세요.결제창 연동에서 notiUrl은 필수입니다. 구매자가 결제창을 중간에 닫거나 브라우저를 종료하더라도, notiUrl을 통해 채번 결과와 입금 결과를 안정적으로 수신할 수 있습니다. nextUrl은 화면 표시 용도이므로, 실제 주문 처리 로직은 반드시 notiUrl에서 수행해야 합니다.

결제창 vs API 비교

항목결제창 연동API 연동
채번 방식결제창에서 자동 처리가맹점이 직접 API 호출
결제 UI헥토파이낸셜 제공 결제창가맹점 자체 디자인 가능
notiUrl필수필수 (입금 통보 수신)

API 연동

채번 API를 직접 호출하여 010 가상계좌를 발급하는 방식입니다. 입금 완료 시 notiUrl로 결과를 수신합니다.

구매자
가맹점
헥토파이낸셜
K뱅크
11. 결제 요청
1. 결제 요청
22. 채번 API 호출
2. 채번 API 호출
33. 010 가상계좌 채번 요청
3. 010 가상계좌 채번 요청
44. 010 가상계좌 발급
4. 010 가상계좌 발급
55. API 응답 (계좌 정보)
5. API 응답 (계좌 정보)
66. 입금 안내 (010-XXXX-XXXX)
6. 입금 안내 (010-XXXX-XXXX)

각 단계 상세

  1. 1결제 요청 : 구매자가 가맹점에서 결제를 요청합니다.
  2. 2API 호출 : 가맹점 서버가 헥토파이낸셜 채번 API를 호출합니다.
  3. 3채번 요청 : 헥토파이낸셜이 K뱅크에 010 가상계좌 채번을 요청합니다.
  4. 4계좌 발급 : K뱅크가 010-XXXX-XXXX 형식의 가상계좌를 발급합니다.
  5. 5API 응답 : 헥토파이낸셜이 가맹점 서버로 가상계좌 정보를 응답합니다.
  6. 6입금 안내 : 가맹점이 구매자에게 010 가상계좌 번호와 입금 안내를 제공합니다.
API 연동에서도 notiUrl 구현이 필수입니다. 가상계좌는 채번과 입금이 분리되어 있기 때문에, 입금 완료 시점을 알기 위해서는 반드시 notiUrl을 구현해야 합니다. API 응답은 채번 결과만 포함하며, 실제 입금 통보는 notiUrl로 전달됩니다.

일반 가상계좌와의 차이점

구분일반 가상계좌010 가상계좌
계좌번호 형식은행별 계좌번호 형식 (숫자 나열)010-XXXX-XXXX (휴대폰번호)
제휴은행다수 은행 지원K뱅크(089) 전용
고객 편의성복잡한 계좌번호 입력휴대폰번호로 간편 입금
계좌 기억어려움자신의 번호라 쉬움
사용 목적범용 무통장 입금입금 편의성이 중요한 서비스

연동 전 확인사항

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

NOTE

K뱅크 전용 서비스. 010 가상계좌는 K뱅크(은행코드: 089)에서만 발급 가능합니다. 다른 은행 가상계좌가 필요한 경우 일반 가상계좌를 이용하세요.

기타 관련

  • 휴대폰번호는 실제 고객의 번호와 일치하지 않아도 됩니다. 입금 편의를 위해 고객 번호를 사용하는 것을 권장합니다.
  • 입금 기한 내에 입금되지 않으면 계좌가 자동 만료됩니다. 만료 시 별도 노티가 발송되지 않으므로 가맹점에서 만료 처리를 별도 구현해야 합니다.
  • 부분 입금은 지원되지 않습니다. 설정된 금액 전액을 한 번에 입금해야 합니다.
  • 테스트 환경에서는 입금 테스트 API를 통해 입금을 시뮬레이션할 수 있습니다.

영업/심사 관련

  • 010 가상계좌 사용을 위해서는 영업담당자 협의가 필요합니다.
  • 영업 문의 :

010 가상계좌 API 문서

🪟

결제창 (UI)

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

🏦

채번 API

010 가상계좌 발급

❌

채번취소

입금 전 가상계좌 취소

↩️

환불

입금 완료 건 환불

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub