헥토파이낸셜 개발자센터

회원가입 화면 연동 API

안심선불 서비스의 회원가입은 헥토파이낸셜 표준화면을 통해 처리합니다.

개요

회원가입 화면에서는 다음 과정이 진행됩니다:

  1. 휴대폰 본인인증 확인
  2. 결제 비밀번호 설정
  3. 예금주성명조회 및 계좌점유인증
  4. KYC 이행(CDD/EDD)

화면 URL

GET/identity
Content-Typeapplication/json
테스트https://tb-mps.hectofinancial.co.kr/identity
운영https://mps.hectofinancial.co.kr/identity

연동 프로세스

고객
가맹점
헥토파이낸셜
11. 회원가입 요청
22. 회원정보 조회 API (가입 여부 확인)
33. 미가입자 응답
44. 회원가입 화면 호출 (GET /identity)
55. 본인인증/계좌인증/KYC
66. 회원가입 완료 (returnUrl, custNo 발급)

호출 전 확인사항

회원 가입 여부 확인 필수

회원가입 화면 호출 전 반드시 회원 정보 조회 API로 가입 여부를 확인해야 합니다. 이미 가입된 회원이 진입 시 오류코드(103)가 반환됩니다.

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└mIdAN(20)영문+숫자, 최대 20byte*
헥토파이낸셜에서 부여하는 고유한 상점 아이디
└mCustIdAN(50)영문+숫자, 최대 50byte*
상점 고객 아이디
└ciEncAN(500)영문+숫자, 최대 500byte*AES-256AES-256/ECB/PKCS5Padding + Base64
고객 CI (연계정보)
*암호화 알고리즘: AES-256/ECB/PKCS5Padding, 인코딩: Base64 Encoding
└returnUrlAN(200)영문+숫자, 최대 200byte*
회원가입 프로세스(취소/오류/완료) 이후 고객페이지로 돌아갈 리턴 URL
NOTE

파라미터 전달 방식

모든 파라미터는 URI 인코딩(encodeURIComponent)하여 전달해야 합니다.

returnUrl 응답 파라미터

회원가입 완료 시 returnUrl로 다음 파라미터가 전달됩니다.

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└statusAN(10)영문+숫자, 최대 10byte*success
선불 서비스 상태
success: 정상 처리 (회원가입 완료) canceled: 사용자 중도 취소 failure: 오류 발생
└errorCodeN(3)숫자, 최대 3byte103
오류 코드 (status가 failure인 경우 전달)
101: 본인인증 페이지 오류 102: 등록되지 않은 가맹점 접근 103: 이미 가입된 회원 접근 104: 재가입 불가 회원 접근 (해지 후 30일 이내) 105: 본인인증확인 페이지 오류 106: CI값 불일치 107: 개인 회원 가입 불가 상점 진입
└custNoAN(20)영문+숫자, 최대 20byte2400001605
헥토파이낸셜에서 부여하는 고유 선불 회원 번호 (status가 success인 경우 전달)
*이후 API 호출 시 사용
└pktHashAN(64)영문+숫자, 최대 64byte*a2d6d597d55d7c9b...
SHA-256 위변조 검증 해시값

pktHash 검증 조합 (status에 따라 다름)

statuspktHash 조합
successmId + mCustId + "success" + hashKey
canceledmId + mCustId + "canceled" + hashKey
failuremId + mCustId + "failure" + errorCode + hashKey

주의사항

  • 회원가입 화면은 모바일/PC 반응형으로 제공됩니다.
  • 본인인증 수단: 휴대폰 인증, 공동인증서
  • KYC 심사에 따라 가입이 제한될 수 있습니다.
  • 결제 비밀번호를 5회 이상 틀리면 계정이 잠금 처리됩니다.
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?