헥토파이낸셜 개발자센터
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 결제휴대폰 결제

휴대폰 결제

휴대폰 결제는 이동통신사를 통해 결제를 진행하고, 결제 금액이 다음 달 휴대폰 요금에 합산 청구되는 소액결제 방식입니다.
신용카드가 없는 고객도 휴대폰만 있으면 결제할 수 있어, 디지털 콘텐츠 결제에 특히 적합합니다.

헥토파이낸셜은 SKT, KT, LGU+ 및 알뜰폰(MVNO) 통신사 모두 지원하며, 일반 소액결제뿐 아니라 구독 서비스를 위한 정기결제(월자동)도 제공합니다.

NOTE

휴대폰 결제의 핵심 흐름. 구매자가 통신사 선택 → 인증(SMS, PASS, ARS) → 통신사 승인 → 결제 완료 (다음 달 요금에 합산).

결제 방식 알아보기

헥토파이낸셜은 서비스 특성에 맞게 선택할 수 있도록 다양한 휴대폰 결제 방식을 제공합니다.

일반결제결제창 ✓API ✗

구매자가 결제창에서 통신사를 선택하고 인증을 진행하면, 결제 금액이 다음 달 휴대폰 요금에 합산 청구되는 기본적인 소액결제 방식입니다.

  • 결제창 연동으로만 사용할 수 있습니다.
  • 신용카드가 없는 고객도 결제할 수 있어 디지털 콘텐츠` 서비스에 적합합니다.
정기결제 (월자동)결제창 ✓API ✓

매월 자동으로 결제되는 구독형 결제 방식입니다. 1회차는 결제창에서 고객이 직접 인증하고, 2회차부터는 발급된 billKey로 가맹점 서버에서 자동 결제합니다.

  • 1회차: 결제창에서 고객 직접 인증 → billKey 발급
  • 2회차 이후: billKey로 가맹점 서버에서 자동 승인 API 호출
  • 정기결제 전용 상점아이디가 별도로 필요합니다.
  • 매월 연속 결제가 필요하며, 결제 실패 시 billKey를 재발급해야 합니다.
NOTE
정기결제 날짜는 전월 결제일 기준 ±3일 이내에 진행해야 합니다. 매달 연속적인 결제가 필요하며, 결제가 실패하면 billKey를 재발급해야 합니다.
인증/승인 분리결제창 ✓API ✓

고객 인증과 실제 승인을 분리하여 처리하는 방식입니다. 인증 완료 후 승인 API를 호출합니다.

  • 인증 단계에서는 결제가 발생하지 않습니다.
  • 가맹점이 필요한 시점에 승인 API를 호출하여 최종 결제를 진행합니다.
  • 재고 확인, 주문 검증 등 중간 처리가 필요한 경우에 적합합니다.

결제 흐름 알아보기

결제창 연동

가맹점 웹페이지에서 헥토파이낸셜 결제창을 호출하면, 구매자가 통신사를 선택하고 SMS 인증을 통해 결제를 진행합니다. 결제 금액은 다음 달 휴대폰 요금에 합산 청구됩니다.

구매자
가맹점
헥토파이낸셜
통신사
11. 주문서에서 휴대폰 결제 선택
1. 주문서에서 휴대폰 결제 선택
22. 결제창 호출 (JS SDK)
2. 결제창 호출 (JS SDK)
33. 결제창 표시 (통신사 선택)
3. 결제창 표시 (통신사 선택)
44. 휴대폰번호 입력 및 SMS 인증
4. 휴대폰번호 입력 및 SMS 인증
55. 승인 요청
5. 승인 요청
66. 승인 결과 반환
6. 승인 결과 반환
77. 결과 통보 (notiUrl)
7. 결과 통보 (notiUrl)

각 단계 상세

  1. 1결제 요청 : 구매자가 주문서에서 휴대폰 결제를 선택합니다.
  2. 2결제창 호출 : 가맹점이 JavaScript SDK(SETTLE_PG.pay)를 호출하여 결제창을 띄웁니다.
  3. 3통신사 선택 : 구매자가 자신의 통신사를 선택합니다.
  4. 4인증 : 구매자가 휴대폰번호를 입력하고 인증(SMS, PASS, ARS)을 확인합니다.
  5. 5승인 요청 : 헥토파이낸셜이 통신사에 결제 승인을 요청합니다.
  6. 6승인 결과 : 통신사가 승인 여부를 반환합니다.
  7. 7결과 통보 : 헥토파이낸셜이 가맹점 서버의 notiUrl로 결제 결과를 전달합니다.
notiUrl은 꼭 구현해 주세요. 결제창 연동에서 notiUrl은 필수입니다. 구매자가 결제창을 중간에 닫거나 브라우저를 종료하더라도, notiUrl을 통해 결제 결과를 안정적으로 수신할 수 있습니다.

결제창 vs API 비교

항목결제창 연동API 연동
사용 시점일반결제, 정기결제 1회차정기결제 2회차 이후
결제 UI헥토파이낸셜 제공 결제창결제창 없음 (서버 간 통신)
고객 인증인증(SMS, PASS, ARS) 필요인증 불필요 (billKey 사용)

API 연동 (정기결제 2회차~)

1회차에서 발급받은 billKey를 사용하여 가맹점 서버에서 직접 결제 API를 호출하는 방식입니다. 2회차 부터는 빌키로 자동으로 결제가 처리됩니다.

가맹점
헥토파이낸셜
통신사
11. 정기결제 API 호출 (billKey 포함)
1. 정기결제 API 호출 (billKey 포함)
22. 결제 요청
2. 결제 요청
33. 결제 결과 반환
3. 결제 결과 반환
44. API 응답
4. API 응답

각 단계 상세

  1. 1API 호출 : 가맹점 서버가 billKey를 포함하여 정기결제 승인 API를 호출합니다.
  2. 2결제 요청 : 헥토파이낸셜이 통신사에 결제를 요청합니다.
  3. 3결제 결과 : 통신사가 결제 결과를 반환합니다.
  4. 4API 응답 : 헥토파이낸셜이 가맹점 서버로 결제 결과를 응답합니다.
NOTE
API 연동에서는 notiUrl이 필수가 아닙니다. API 응답으로 결제 결과를 바로 수신할 수 있기 때문입니다.

취소 및 환불

구분처리 방법가능 여부
당월 취소취소 API결제한 달(M월) 1일~말일 이내
익월 이후 환불환불 API환불 기한 1년 이내

취소와 환불 구분 필수. 휴대폰 결제는 결제한 달(M월)과 이후 달의 처리 방법이 다릅니다. 잘못된 API 호출 시 처리가 실패할 수 있습니다.

연동 전 확인사항

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

상점아이디 관련

  • 일반결제와 정기결제는 상점아이디가 분리됩니다. 정기결제 전용 상점아이디는 영업 담당자에게 발급을 요청하세요.
  • 테스트 환경과 운영 환경의 상점아이디는 다릅니다. 운영환경에서 테스트하면 실제 비용이 발생하니, 꼭 테스트베드를 이용해 주세요.

기타 관련

  • 정기결제는 매월 연속 결제가 필요합니다. 결제 실패 시 billKey를 삭제, 재발급해야 합니다.
    (단, 영업팀과 협의 후 예외 처리한 가맹점의 경우에는 위 제약사항이 없음)
  • 유효하지 않은 휴대폰 정기결제 키는 다음해에 삭제됩니다..
  • 정기결제 날짜는 전월 결제일 기준 ±3일 이내에 진행해야 합니다.

정책 관련

  • 취소 기한: 결제한 달(M월) 말일까지, 환불 기한: 1년
  • 통신사 정책에 따라 금액 한도가 발생할 수 있습니다.
  • 정기결제의 경우 전월 결제일 기준으로 ±3일 이내에 진행해야 합니다.

영업/심사 관련

  • 디지털 콘텐츠, 실물 상품 등 업종에 따라 통신사 심사 기준이 다릅니다.
  • 영업 문의 :

휴대폰 결제 개발 문서 바로가기

📱

휴대폰 결제 API

일반 결제 및 월자동 1회차 요청

🔄

월자동 결제 API (2회차~)

BillKey를 이용한 정기 승인 요청

↩️

휴대폰 결제 취소 API

당월 결제건 취소 요청

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub