헥토파이낸셜 개발자센터
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로 연동하기
서비스안심선불안심선불 개요

안심선불이란?

안심선불은 고객이 미리 충전한 금액으로 결제하거나
사용할 수 있는 선불 머니 서비스를 쉽게 구축할 수 있도록 제공하는 플랫폼입니다.

일반적으로 선불 서비스는 전자금융거래법에 따른 '선불전자지급수단 발행업' 라이선스가 있어야만 운영할 수 있습니다.

헥토파이낸셜의 안심선불을 이용하면,
복잡한 금융 라이선스 취득 없이도 브랜드 전용 선불머니·포인트 서비스를 빠르게 도입할 수 있습니다.

브랜드 전용 포인트 / 머니 / 선불카드 / 키프트카드 / 리워드 등의 간편 결제 구축 예정이라면 아래 내용을 확인해 주세요.

NOTE

안심 선불 서비스 특징 ⸰ 빠르게 시작하는 선불 서비스 ⸰ 선불충전금 100% 안전 관리 ⸰ 고객 재방문을 만드는 브랜드 머니

안심선불 기능 알아보기

안심선불은 머니 충전, 사용, 선물, 포인트 적립/사용, 잔액 관리 등 선불 서비스에 필요한 기능을 통합 제공합니다.

머니 충전결제창 ✗API ✓

카드, 계좌이체 등 다양한 결제 수단으로 선불 머니를 충전할 수 있습니다. 자동충전 기능을 통해 편리한 결제 환경을 제공합니다.

머니 사용결제창 ✗API ✓

충전된 머니로 온라인 및 오프라인 가맹점에서 간편하게 결제할 수 있습니다.

머니 선물결제창 ✗API ✓

선불 회원 간 머니를 간편하게 선물하거나 전송할 수 있습니다. 이벤트, 프로모션 등에 활용할 수 있습니다.

포인트 적립/사용결제창 ✗API ✓

포인트 적립 및 사용 기능을 통해 멤버십, 이벤트, 리워드 프로그램을 운영할 수 있습니다.

잔액 관리/출금결제창 ✗API ✓

머니 잔액 조회, 사용 내역 확인, 계좌 출금 등 잔액 관리 기능을 제공합니다.

서비스 흐름 알아보기

  • 회원가입과 내정보 관리는 화면(UI) 연동이 필수입니다.
  • 충전, 사용, 조회 등 핵심 기능은 API 연동으로 처리합니다.

화면(UI) 연동

회원가입과 내정보 관리는 헥토파이낸셜이 제공하는 화면(UI)을 호출하여 처리합니다. 본인인증, 계좌인증, KYC 등 복잡한 절차를 화면에서 처리하므로 가맹점의 개발 부담이 줄어듭니다.

고객
가맹점
헥토파이낸셜
11. 회원가입 요청
1. 회원가입 요청
22. 회원정보 조회 API (가입 여부 확인)
2. 회원정보 조회 API (가입 여부 확인)
33. 미가입자 응답
3. 미가입자 응답
44. 회원가입 화면 호출
4. 회원가입 화면 호출
55. 본인인증/계좌인증/KYC 화면 표시
5. 본인인증/계좌인증/KYC 화면 표시
66. 회원가입 완료 (custNo 발급)
6. 회원가입 완료 (custNo 발급)

각 단계 상세

  1. 1회원가입 요청 : 고객이 가맹점에서 안심선불 서비스 가입을 요청합니다.
  2. 2가입 여부 확인 : 가맹점이 회원정보 조회 API로 기존 가입 여부를 확인합니다.
  3. 3미가입자 응답 : 헥토파이낸셜이 미가입자임을 응답합니다.
  4. 4회원가입 화면 호출 : 가맹점이 헥토파이낸셜 회원가입 화면을 호출합니다.
  5. 5본인인증/계좌인증/KYC : 고객이 본인인증, 계좌인증, KYC 절차를 진행합니다.
  6. 6회원가입 완료 : 헥토파이낸셜이 가맹점에 고객번호(custNo)를 발급합니다.
회원가입 화면 호출 전 가입 여부 확인 필수. 회원정보 조회 API로 가입 여부를 반드시 확인한 후 화면을 호출해야 합니다. 이미 가입된 회원이 회원가입 화면에 진입하면 오류코드(103)가 반환됩니다.

결제창 vs API 비교

항목결제창 연동API 연동
처리 범위회원가입, 내정보 관리충전, 사용, 선물, 포인트, 잔액 조회, 출금
통신 방식헥토파이낸셜 화면 호출Server-to-Server API 호출
필수 여부회원가입/내정보는 UI 연동 필수핵심 기능은 API 연동 필수

API 연동

선불머니 충전, 사용, 출금, 조회 등 핵심 기능은 Server-to-Server 방식의 API로 제공됩니다. 가맹점 서버에서 헥토파이낸셜 API를 직접 호출하여 처리합니다.

고객
가맹점
헥토파이낸셜
11. 결제 요청
1. 결제 요청
22. 잔액 조회 API
2. 잔액 조회 API
33. 잔액 응답
3. 잔액 응답
44. 사용 API (PIN 인증)
4. 사용 API (PIN 인증)
55. 사용 완료 응답
5. 사용 완료 응답
66. 결제 완료
6. 결제 완료

각 단계 상세

  1. 1결제 요청 : 고객이 가맹점에서 선불머니로 결제를 요청합니다.
  2. 2잔액 조회 : 가맹점이 잔액 조회 API를 호출하여 충분한 잔액이 있는지 확인합니다.
  3. 3잔액 응답 : 헥토파이낸셜이 현재 잔액 정보를 응답합니다.
  4. 4사용 API 호출 : 가맹점이 사용 API를 호출하고, PIN 인증을 통해 결제를 진행합니다.
  5. 5사용 완료 응답 : 헥토파이낸셜이 사용(결제) 결과를 응답합니다.
  6. 6결제 완료 : 가맹점이 고객에게 결제 완료를 안내합니다.
NOTE
API로 제공되는 주요 기능. 잔액 조회, 머니 사용/사용 취소, 머니 충전, 머니 선물, 포인트 적립/사용/회수, 충전건별 잔액 조회, 잔액 옵션 변경, 출금 등

연동 전 확인사항

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

회원 가입 여부 확인 필수

회원가입 or 내정보 페이지 호출 전에 반드시 회원 정보 조회 API로 가입 여부를 확인해야 합니다.

화면 연동 전 확인사항

  • 회원가입 페이지 진입 전, 회원 정보 조회 API로 미가입자 여부를 확인 후 호출해 주세요. 이미 가입된 회원이 진입 시 오류코드(103)가 반환됩니다.
  • 내정보 페이지는 미가입자가 진입할 경우 오류가 발생합니다. 반드시 가입자 확인 후 호출해야 합니다.
  • 결제 비밀번호를 5회 이상 틀리면 계정이 잠금 처리됩니다. 내정보 페이지의 결제비밀번호 재설정 메뉴로 잠금 해제 가능합니다.
  • 테스트 환경에서는 실제 거래가 발생하지 않으므로, 1원 인증 시 당사에 상점아이디 예외처리 등록을 요청해 주세요.

기타 확인사항

  • 영업일 오후 1시 ~ 오후 2시는 테스트 서버 반영이 있을 수 있습니다.
  • TLS 1.2 이상 사용을 권장합니다.

안심선불 개발 문서 바로가기

📱

충전 API

회원에게 머니 또는 포인트를 충전(지급)하는 API입니다.

💰

거래내역 조회 API

거래 내역 조회, 거래 상세 조회 등 조회 API

💳

충전/인출 API

충전, 취소, 출금 등 API

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub