화이트라벨
화이트라벨 서비스는 간편현금결제 서비스에 신용카드를 결제수단으로 추가하여,
고객사가 간편결제(간편현금 + 신용카드) 서비스를 운영할 수 있도록 지원하는 기능입니다.
회원가입 후 PIN 번호 등록 및 간편결제 수단을 등록하면, 이후에는 PIN 번호만으로 간편하게 결제를 이용할 수 있습니다.
NOTE
화이트라벨 핵심 흐름. 본인인증을 통한 회원가입 및 결제 PIN 등록 → 결제수단 등록 → 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서비스 이용 요청 : 고객이 가맹점에서 결제를 요청합니다.
- 2결제창 호출 : 가맹점이 헥토파이낸셜 화이트라벨 결제창을 호출합니다.
- 3본인인증 및 회원가입 : 최초 이용 시 본인인증을 통해 회원가입을 진행합니다.
- 4PIN 번호 등록 : 결제에 사용할 PIN 번호를 등록합니다.
- 5결제수단 등록 : 은행 계좌 또는 신용카드를 결제수단으로 등록합니다.
- 6결제 인증 : 등록된 결제수단으로 PIN 번호를 입력하여 결제 인증을 요청합니다.
- 7인증 결과 전달 : 헥토파이낸셜이 가맹점 nextUrl로 인증 결과를 전달합니다.
결제창에서는 인증까지만 처리됩니다.
인증 완료 후 가맹점 서버에서 반드시 승인 API를 호출해야 실제 결제가 완료됩니다.
nextUrl은 화면 표시 용도이므로, 실제 주문 처리 로직은 승인 API 응답을 기준으로 수행해 주세요.
결제창 vs API 비교
| 항목 | 결제창 연동 | API 연동 |
|---|---|---|
| 처리 범위 | 회원가입, PIN 등록, 결제수단 등록, 결제 인증 | 승인 요청, 취소 요청, 거래 결과 조회 |
| 통신 방식 | 헥토파이낸셜 결제창 호출 | Server-to-Server API 호출 |
| Content-Type | application/x-www-form-urlencoded | application/json |
연동 전 확인사항
운영 환경 테스트 주의
운영환경에서 상점아이디(mchtId)로 테스트 진행 시 발생하는 비용은 가맹점에서 부담합니다.
