헥토파이낸셜 개발자센터
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로 연동하기
서비스화이트라벨화이트라벨 개요

화이트라벨

화이트라벨 서비스는 간편현금결제 서비스에 신용카드를 결제수단으로 추가하여,
고객사가 간편결제(간편현금 + 신용카드) 서비스를 운영할 수 있도록 지원하는 기능입니다.

회원가입 후 PIN 번호 등록 및 간편결제 수단을 등록하면, 이후에는 PIN 번호만으로 간편하게 결제를 이용할 수 있습니다.

NOTE

화이트라벨 핵심 흐름. 본인인증을 통한 회원가입 및 결제 PIN 등록 → 결제수단 등록 → PIN 번호로 간편 결제.

결제 방식 알아보기

헥토파이낸셜 화이트라벨은 간편현금결제와 신용카드 결제 두 가지 결제수단을 하나의 인터페이스로 통합 지원합니다.

주요 특징

간편현금결제와 신용카드를 동시에 사용할 수 있고 브랜드 페이로 커스텀하여 사용 사능합니다. [주요특징]

  • 브랜드 일관성 : 자사 브랜드로 결제 서비스를 제공하고 싶은 경우 / 브랜드 페이 커스텀 지원`
  • 통합 결제 : 여러 결제 수단을 하나의 인터페이스로 제공
간편현금결제결제창 ✓API ✗

은행 계좌를 결제수단으로 등록하여, PIN 번호만으로 간편하게 결제하는 방식입니다. 계좌에서 직접 출금되므로 카드 수수료 없이 결제할 수 있습니다.

  • 은행 계좌 기반 결제로 카드 수수료가 발생하지 않습니다.
  • 최초 1회 계좌 등록 후 PIN 번호만으로 결제할 수 있습니다.
  • 결제창 연동으로 회원가입, PIN 등록, 계좌 등록, 결제 인증을 처리합니다.
신용카드 결제결제창 ✓API ✗

신용카드를 결제수단으로 등록하여, PIN 번호만으로 간편하게 카드 결제하는 방식입니다. 기존 카드 결제와 달리 매번 카드 정보를 입력할 필요가 없습니다.

  • 최초 1회 카드 등록 후 PIN 번호만으로 결제할 수 있습니다.
  • 간편현금결제와 동일한 UX로 카드 결제를 지원합니다.
  • 결제창 연동으로 회원가입, PIN 등록, 카드 등록, 결제 인증을 처리합니다.

결제 흐름 알아보기

  • 결제창에서 인증 완료 이후 승인 요청을 API로 요청하는 구조입니다.
  • API만 사용하여 인증 & 승인이 어렵습니다.

결제창 연동

가맹점 웹페이지에서 헥토파이낸셜 화이트라벨 결제창을 호출합니다. 고객은 결제창에서 회원가입, PIN 등록, 결제수단 등록, 결제 인증까지 모든 과정을 진행합니다.

고객
가맹점
헥토파이낸셜
11. 서비스 이용 요청
1. 서비스 이용 요청
22. 결제창 호출 (UI)
2. 결제창 호출 (UI)
33. 본인인증 및 회원가입 화면 표시
3. 본인인증 및 회원가입 화면 표시
44. PIN 번호 등록
4. PIN 번호 등록
55. 결제수단 등록 (계좌/카드)
5. 결제수단 등록 (계좌/카드)
66. 결제 인증 요청 (PIN 입력)
6. 결제 인증 요청 (PIN 입력)
77. 인증 결과 nextUrl
7. 인증 결과 nextUrl

각 단계 상세

  1. 1서비스 이용 요청 : 고객이 가맹점에서 결제를 요청합니다.
  2. 2결제창 호출 : 가맹점이 헥토파이낸셜 화이트라벨 결제창을 호출합니다.
  3. 3본인인증 및 회원가입 : 최초 이용 시 본인인증을 통해 회원가입을 진행합니다.
  4. 4PIN 번호 등록 : 결제에 사용할 PIN 번호를 등록합니다.
  5. 5결제수단 등록 : 은행 계좌 또는 신용카드를 결제수단으로 등록합니다.
  6. 6결제 인증 : 등록된 결제수단으로 PIN 번호를 입력하여 결제 인증을 요청합니다.
  7. 7인증 결과 전달 : 헥토파이낸셜이 가맹점 nextUrl로 인증 결과를 전달합니다.
결제창에서는 인증까지만 처리됩니다. 인증 완료 후 가맹점 서버에서 반드시 승인 API를 호출해야 실제 결제가 완료됩니다. nextUrl은 화면 표시 용도이므로, 실제 주문 처리 로직은 승인 API 응답을 기준으로 수행해 주세요.

결제창 vs API 비교

항목결제창 연동API 연동
처리 범위회원가입, PIN 등록, 결제수단 등록, 결제 인증승인 요청, 취소 요청, 거래 결과 조회
통신 방식헥토파이낸셜 결제창 호출Server-to-Server API 호출
Content-Typeapplication/x-www-form-urlencodedapplication/json

API 연동

결제창에서 인증이 완료된 건에 대해, 가맹점 서버에서 헥토파이낸셜 API를 직접 호출하여 승인, 취소, 조회를 처리하는 방식입니다.

가맹점
헥토파이낸셜
11. 결제 승인 API 호출
1. 결제 승인 API 호출
22. 승인 결과 응답
2. 승인 결과 응답
33. 취소 API 호출 (필요시)
3. 취소 API 호출 (필요시)
44. 취소 결과 응답
4. 취소 결과 응답
55. 거래 조회 API 호출
5. 거래 조회 API 호출
66. 조회 결과 응답
6. 조회 결과 응답

각 단계 상세

  1. 1결제 승인 요청 : 결제창 인증이 완료된 건에 대해 승인 API를 호출하여 실제 결제를 진행합니다.
  2. 2승인 결과 수신 : 헥토파이낸셜이 승인 결과를 응답합니다.
  3. 3결제 취소 요청 : 필요시 취소 API를 호출하여 결제를 취소합니다.
  4. 4취소 결과 수신 : 헥토파이낸셜이 취소 결과를 응답합니다.
  5. 5거래 조회 요청 : 거래 상태를 확인하기 위해 조회 API를 호출합니다.
  6. 6조회 결과 수신 : 헥토파이낸셜이 거래 상태 정보를 응답합니다.
NOTE
API 연동에서 제공하는 기능. 1. 결제 인증 요청 건에 대한 승인 요청 2. 결제 취소 요청 3. 거래 결과 조회

연동 전 확인사항

운영 환경 테스트 주의

운영환경에서 상점아이디(mchtId)로 테스트 진행 시 발생하는 비용은 가맹점에서 부담합니다.

화이트라벨 개발 문서 바로가기

🪟

결제창 연동

표준 결제창(UI) 호출 방법

💳

결제 API

결제 승인 API (Non-UI)

↩️

취소 API

결제 취소 및 환불

❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub