헥토파이낸셜 개발자센터
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로 연동하기
서비스내통장결제내통장결제 개요

내통장결제

온라인 상점에서 고객 계좌를 통해 바로 결제를 받을 수 있는 간편결제 서비스입니다.

고객은 최초 1회 은행 계좌를 등록하고 결제용 PIN을 설정하면,
이후에는 PIN만 입력해 복잡한 인증 절차 없이 간편하게 결제할 수 있습니다.

NOTE

내통장결제 핵심 흐름. 결제창에서 계좌 인증 → 가맹점 서버에서 승인 API 호출 → 고객 계좌에서 즉시 출금.

결제 방식 알아보기

주요 특징

고객 계좌를 통해서 간편하게 결제할 수 있는 기능을 제공합니다.

  • 간편한 인증 : 공인인증서, 보안카드 없이 휴대폰 인증으로 결제 진행이 가능해요.
  • 실시간 출금 : 고객 계좌에서 즉시 출금되어 가맹점에서 정산됩니다.
  • 낮은 수수료 : 신용카드 대비 낮은 결제 수수료를 제공해요
  • 높은 결제 한도 : 카드 한도와 무관하게 계좌 잔액 내에서 결제할 수 있어요
  • 빌키 결제 : 빌키를 통해 정기결제(구독, 멤버십 등)을 제공하기 좋아요
일반결제결제창 ✓API ✓

매 결제마다 결제창 인증을 거쳐 즉시 출금하는 방식입니다. 가장 기본적인 결제 방식으로, 매번 고객이 결제창에서 인증을 진행합니다.

  • 결제창에서 인증 & 승인 API 성공 후 즉시 출금이 이루어집니다.
  • 매 결제마다 인증이 필요합니다.
  • 결제창(UI) 인증 + API 승인 방식으로 동작합니다.
1회차 결제 후 빌키결제결제창 ✓API ✓

결제창 인증과 동시에 1회차 결제가 실행됩니다. 승인 응답으로 빌키를 발급받아, 이후에는 UI 없이 빌키만으로 결제할 수 있습니다.

  • 최초 결제 시 인증과 동시에 출금이 이루어지고 빌키가 발급됩니다.
  • 이후에는 빌키만으로 UI 없이 결제를 요청할 수 있습니다.
NOTE
빌키 발급 후에는 가맹점에서 빌키를 안전하게 보관해야 합니다. 빌키 해지 시 자동결제키 해지 API를 호출해 주세요.
0원 인증 후 빌키결제결제창 ✓API ✓

결제 없이 인증만 진행해 빌키를 발급받는 방식입니다. 이후 정해진 주기에 자동으로 결제할 수 있어 구독/정기결제 서비스에 적합합니다.

  • 결제창에서 0원 인증을 진행해 실 결제 없이 빌키를 발급받습니다.
  • 이후 원하는 시점에 자동결제 승인 API로 결제합니다.
  • 구독, 멤버십, 정기배송 등 정기결제 서비스에 적합합니다.
NOTE
0원 인증은 실결제가 발생하지 않습니다. 빌키 발급 후 자동결제 승인 API를 호출해야 실제 출금이 이루어집니다.

결제 흐름 알아보기

결제창 연동

가맹점 웹페이지에서 헥토파이낸셜 결제창을 호출하여 고객 인증을 진행합니다. 고객이 계좌 정보를 입력하고 본인인증을 완료하면, 인증 결과가 가맹점으로 전달됩니다.

구매자
가맹점
헥토파이낸셜
은행
11. 결제 요청
1. 결제 요청
22. 결제창 호출
2. 결제창 호출
33. 결제창 표시
3. 결제창 표시
44. 계좌정보 입력/휴대폰 본인인증
4. 계좌정보 입력/휴대폰 본인인증
55. 계좌 인증 및 출금이체 등록
5. 계좌 인증 및 출금이체 등록
66. 계좌 인증 결과
6. 계좌 인증 결과
77. 인증완료 Callback
7. 인증완료 Callback

각 단계 상세

  1. 1결제 요청 : 구매자가 가맹점에서 결제를 요청합니다.
  2. 2결제창 호출 : 가맹점이 헥토파이낸셜 결제창을 호출합니다.
  3. 3결제창 표시 : 구매자에게 계좌 정보 입력 화면이 나타납니다.
  4. 4계좌정보 입력/휴대폰 본인인증 : 구매자가 계좌 정보를 입력하고 휴대폰 본인인증을 완료합니다.
  5. 5계좌 인증 및 출금이체 등록 : 예금주 조회, ARS 인증과 출금이체 동의를 거쳐 계좌를 등록합니다.
  6. 6계좌 인증 결과 : 은행이 계좌 인증 및 출금이체 등록 결과를 반환합니다.
  7. 7인증완료 Callback : 헥토파이낸셜이 가맹점으로 인증 결과를 전달합니다.
결제창에서는 인증까지만 처리됩니다. 인증 완료 후 10분 이내에 결제승인 API를 호출해야 합니다. 초과 시 인증 정보가 만료됩니다.

결제창 vs API 비교

항목결제창 연동API 연동
처리 범위고객 인증 (계좌정보 입력, 본인확인)결제 승인, 취소/환불, 자동결제, 조회
통신 방식헥토파이낸셜 결제창 호출Server-to-Server API 호출
Content-Typeapplication/x-www-form-urlencodedapplication/json; charset=UTF-8

API 연동

결제창 인증 완료 후, 가맹점 서버에서 헥토파이낸셜 API를 직접 호출하여 승인, 취소, 자동결제를 처리합니다.

가맹점
헥토파이낸셜
은행
11. 결제승인 API 호출
1. 결제승인 API 호출
22. 출금 요청
2. 출금 요청
33. 출금 결과
3. 출금 결과
44. 승인 결과 응답
4. 승인 결과 응답
55. 취소/환불 API 호출 (필요시)
5. 취소/환불 API 호출 (필요시)
66. 취소 결과 응답
6. 취소 결과 응답

각 단계 상세

  1. 1결제승인 API 호출 : 결제창 인증이 완료된 건에 대해 승인 API를 호출합니다.
  2. 2출금 요청 : 헥토파이낸셜이 고객 계좌에서 출금을 요청합니다.
  3. 3출금 결과 : 은행이 출금 결과를 반환합니다.
  4. 4승인 결과 응답 : 헥토파이낸셜이 가맹점에 승인 결과를 응답합니다. (빌키결제인 경우 빌키 포함)
  5. 5취소/환불 API 호출 : 필요시 취소 또는 환불 API를 호출합니다.
  6. 6취소 결과 응답 : 헥토파이낸셜이 취소 결과를 응답합니다.
NOTE
API로 제공되는 주요 기능. 1. 결제 승인 (일반결제/빌키결제) 2. 취소/환불 3. 자동결제 키발급/승인/해지 4. 거래결과 조회 5. 망취소 (타임아웃 대응)

연동 전 확인사항

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

인증 유효시간

  • 결제인증 완료 후 10분 이내에 결제승인 API를 호출해야 합니다. 초과 시 인증 정보가 만료됩니다.

타임아웃 처리

  • 결제승인 API 호출 시 타임아웃이 발생하면 거래결과조회 API로 결과를 확인해 주세요.
  • 조회 결과가 성공이면 망취소 API로 취소 처리를 진행해 주세요.

운영 환경 테스트 주의

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

내통장결제 개발 문서 바로가기

🔐

결제인증 (UI)

결제창을 통한 본인인증

✅

결제승인 API

인증 후 출금 승인 요청

↩️

취소/환불 API

결제 취소 및 환불 처리

🔄

자동결제 API

정기결제 키발급/승인/해지

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub