헥토파이낸셜 개발자센터

내정보 화면 연동 API

안심선불 서비스의 내정보 관리는 헥토파이낸셜 표준화면을 통해 처리합니다.

개요

내정보 화면에서 제공하는 기능:

기능설명
결제비밀번호 재설정비밀번호 변경/재설정
충전 및 사용 한도 변경한도 조정
회원정보 수정KYC 재이행
출금계좌 등록 및 변경계좌 관리
결제내역 이메일 수신알림 설정
현금영수증 관리현금영수증 설정
회원 탈퇴선불 서비스 탈퇴

화면 URL

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

호출 전 확인사항

가입자 확인 필수

내정보 화면 호출 전 반드시 회원 정보 조회 API로 가입 여부를 확인해야 합니다. 미가입자가 진입 시 오류가 발생합니다.

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└mIdAN(20)영문+숫자, 최대 20byte*
헥토파이낸셜에서 부여하는 고유한 상점 아이디
└custNoAN(20)영문+숫자, 최대 20byte*
헥토파이낸셜에서 부여하는 고유 선불 회원 번호
*회원가입 시 발급된 번호
└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)숫자, 최대 3byte201
오류 코드 (status가 failure인 경우 전달)
201: 내 정보 페이지 오류 202: 휴면 회원 접근 204: 비정상 상태 회원 접근 (문의 필요) 205: 서비스 해지된 회원 접근 301: 서비스 해지 실패 (해지할 출금 금액 없음) 302: 서비스 해지 실패 (해지할 출금 금액 있음)
└custNoAN(20)영문+숫자, 최대 20byte2400001605
헥토파이낸셜에서 부여하는 고유 선불 회원 번호
└pktHashAN(64)영문+숫자, 최대 64byte*a2d6d597d55d7c9b...
SHA-256 위변조 검증 해시값

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

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

주의사항

결제 비밀번호

  • 결제 비밀번호를 5회 이상 틀리면 계정이 잠금 처리됩니다.
  • 내정보 페이지의 결제비밀번호 재설정 메뉴로 잠금 해제 가능합니다.

회원 탈퇴

  • 잔액이 있는 경우 탈퇴가 제한됩니다.
  • 탈퇴 후 동일 정보로 재가입 시 기존 거래 내역은 조회되지 않습니다.
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?