헥토파이낸셜 개발자센터
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

간편결제의 핵심 흐름. 구매자가 간편결제 선택 → 간편결제 앱에서 인증 → 결제 완료.

간편결제사별 지원 기능

카카오페이결제창 ✓API ✓

카카오톡 앱에 등록된 카드 또는 계좌로 결제하는 방식입니다. 카카오톡 앱에서 비밀번호 또는 지문 인증만으로 빠르게 결제할 수 있습니다.

  • 정기결제(빌링)를 지원합니다. 정기결제 전용 상점아이디가 필요합니다.
네이버페이결제창 ✓API ✗

네이버 계정에 등록된 결제수단으로 결제하는 방식입니다. 네이버 앱 또는 웹에서 간편하게 결제할 수 있습니다.

  • 정기결제 지원 예정입니다.
페이코결제창 ✓API ✗

NHN 페이코 앱에 등록된 결제수단으로 결제하는 방식입니다.

  • 인증/승인 분리를 지원합니다.
토스페이결제창 ✓API ✗

토스 앱에 등록된 결제수단으로 결제하는 방식입니다. 토스 앱에서 간편하게 인증하고 결제할 수 있습니다.

  • 정기결제 지원 예정입니다.

결제 흐름 알아보기

결제창 연동

가맹점 웹페이지에서 헥토파이낸셜 결제창을 호출하면, 구매자가 간편결제사를 선택하고 해당 앱에서 인증을 진행합니다.

구매자
가맹점
헥토파이낸셜
간편결제사
11. 간편결제 선택 (카카오/네이버 등)
1. 간편결제 선택 (카카오/네이버 등)
22. 결제창 호출 (corpPayCode 설정)
2. 결제창 호출 (corpPayCode 설정)
33. 간편결제 앱/웹 실행
3. 간편결제 앱/웹 실행
44. 비밀번호/지문 인증
4. 비밀번호/지문 인증
55. 인증 결과 전달
5. 인증 결과 전달
66. 결과 통보 (notiUrl)
6. 결과 통보 (notiUrl)

각 단계 상세

  1. 1간편결제 선택 : 구매자가 주문서에서 간편결제 수단을 선택합니다.
  2. 2결제창 호출 : 가맹점이 JavaScript SDK를 호출합니다. corpPayCode로 간편결제사를 지정합니다.
  3. 3간편결제 앱 실행 : 해당 간편결제사의 앱 또는 웹 페이지가 열립니다.
  4. 4인증 : 구매자가 비밀번호 또는 지문으로 결제를 승인합니다.
  5. 5결과 전달 : 간편결제사가 인증 결과를 헥토파이낸셜에 전달합니다.
  6. 6결과 통보 : 헥토파이낸셜이 가맹점 서버의 notiUrl로 결제 결과를 전달합니다.
notiUrl은 꼭 구현해 주세요. 결제창 연동에서 notiUrl은 필수입니다. 구매자가 결제창을 중간에 닫더라도, notiUrl을 통해 결제 결과를 안정적으로 수신할 수 있습니다.

결제창 vs API 비교

항목결제창 연동API 연동
지원 결제사카카오페이, 네이버페이, 페이코, 토스페이카카오페이 (정기결제)
결제 UI헥토파이낸셜 결제창 → 간편결제 앱결제창 없음 (서버 간 통신)
고객 인증간편결제 앱에서 인증인증 불필요 (BillKey 사용)

정기결제 (카카오페이)

카카오페이 정기결제는 최초 결제 시 BillKey를 발급받고, 이후에는 BillKey만으로 자동 결제를 실행하는 방식입니다.

구매자
가맹점
헥토파이낸셜
카카오페이
11. 정기결제 신청
1. 정기결제 신청
22. 결제창 호출 (정기결제 상점아이디)
2. 결제창 호출 (정기결제 상점아이디)
33. 카카오페이 앱에서 인증
3. 카카오페이 앱에서 인증
44. 결제 완료 + BillKey 발급
4. 결제 완료 + BillKey 발급
55. 결과 통보 (BillKey 포함)
5. 결과 통보 (BillKey 포함)
66. 정기결제 API 호출 (BillKey 사용)
6. 정기결제 API 호출 (BillKey 사용)
77. 결제 결과 응답
7. 결제 결과 응답

각 단계 상세

  1. 1정기결제 신청 : 구매자가 정기결제(구독)를 신청합니다.
  2. 2결제창 호출 : 가맹점이 정기결제 전용 상점아이디(예: nxkkp_auto)로 결제창을 호출합니다.
  3. 3카카오페이 인증 : 구매자가 카카오페이 앱에서 결제를 승인합니다.
  4. 4BillKey 발급 : 최초 결제 완료와 함께 BillKey가 발급됩니다.
  5. 5BillKey 저장 : 가맹점이 BillKey를 안전하게 저장합니다.
  6. 6정기결제 실행 : 원하는 시점에 BillKey로 정기결제 API를 호출합니다.
  7. 7결과 응답 : 헥토파이낸셜이 결제 결과를 응답합니다.
NOTE
정기결제 전용 상점아이디가 필요합니다.카카오페이 정기결제는 일반 결제와 상점아이디가 다릅니다. 영업담당자에게 정기결제 전용 상점아이디 발급을 요청하세요.

연동 전 확인사항

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

테스트 환경 주의

카카오페이는 테스트 환경에서는 실 결제가 발생할 수 있습니다. 당사 테스트 상점아이디를 사용하는 경우 당일 자동 취소 진행됩니다.

상점아이디 관련

  • 카카오페이 정기결제는 정기결제 전용 상점아이디가 필요합니다. 영업 담당자에게 발급을 요청하세요.
  • 테스트 환경과 운영 환경의 상점아이디는 다릅니다.

기타 관련

  • 간편결제사별로 지원하는 결제수단과 기능이 다릅니다. 연동 전 각 간편결제사별 지원 범위를 확인하세요.

영업/심사 관련

  • 간편결제사별 심사가 필요할 수 있습니다. 영업 담당자와 협의해 주세요.
  • 간편결제사별 취소/환불 정책이 다를 수 있습니다.
  • 영업 문의 :

간편결제 개발 문서 바로가기

💳

간편결제 호출 API

통합 간편결제 요청 (method='corp')

🔄

정기결제(BillKey) API

카카오페이 정기결제 등

↩️

간편결제 취소 API

각 간편결제사별 취소 요청

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub