회원 정보 조회 API
선불 서비스 가입 여부 및 회원 정보를 조회하는 API입니다.
API 정보
POST/v1/customer/info
Content-Type
application/json테스트
https://tb-mps-api.hectofinancial.co.kr/v1/customer/info운영
https://mps-api.hectofinancial.co.kr/v1/customer/info용도
NOTE
회원가입 전 필수 호출
회원가입/내정보 화면 호출 전 반드시 이 API로 가입 여부를 확인해야 합니다.
| 용도 | 설명 |
|---|---|
| 가입 여부 확인 | 회원가입 화면 호출 전 미가입자 확인 |
| 회원번호 조회 | custNo 조회 (API 호출 시 필요) |
| 회원상태 확인 | 정상/잠금/탈퇴 등 상태 확인 |
요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호
선불 회원번호
*헥토파이낸셜에서 부여하는 고유 선불 회원 번호. custNo 또는 custId 중 하나 필수
└custIdAN(20)영문+숫자, 최대 20byte
AES-256AES-256/ECB/PKCS5Padding + Base64선불 회원 아이디선불 회원 아이디
*AES-256/ECB/PKCS5Padding 암호화 필요. custNo 또는 custId 중 하나 필수. 서비스해지한 고객은 custNo로만 조회 가능
└ciAN(20)영문+숫자, 최대 20byte*
AES-256AES-256/ECB/PKCS5Padding + Base64선불 회원 CI선불 회원 CI
*회원의 고유한 CI 값. AES-256/ECB/PKCS5Padding 암호화 필요
└midAN(20)영문+숫자, 최대 20byte*상점 아이디
상점 아이디
*헥토파이낸셜에서 부여하는 고유한 상점 아이디
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└rsltCdAN(4)영문+숫자, 최대 4byte*응답코드
0000응답코드
0000: 성공 그 외: 실패└rsltMsgAN*응답 메시지
성공응답 메시지
rsltObj (응답 객체)
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호
2400001605선불 회원번호
└custIdAN(20)영문+숫자, 최대 20byte*선불 회원 아이디
선불 회원 아이디
*선불 회원이 가입할 때, 가맹점에서 넘겨준 회원의 ID
└midAN(20)영문+숫자, 최대 20byte*상점 아이디
M2471645상점 아이디
└custDivCdAN(1)영문+숫자, 최대 1byte*고객 구분 코드
고객 구분 코드
0: 무기명 1: 기명└custStatCdAN(1)영문+숫자, 최대 1byte*고객 상태 코드
고객 상태 코드
N: 정상 D: 서비스 해지 W: 대기 H: 휴면 L: 잠금 K: KYC 미이행 R: 가입거절└regDtAN(8)영문+숫자, 최대 8byte*회원 등록 일자
20240701회원 등록 일자
*yyyyMMdd
└regTmAN(6)영문+숫자, 최대 6byte*회원 등록 시각
143025회원 등록 시각
*HHmmss
└csrcRegNoDivCdAN(1)영문+숫자, 최대 1byte현금영수증 등록번호 구분
현금영수증 등록번호 구분
1: 카드 3: 사업자번호 4: 휴대폰번호└csrcRegNoAN(50)영문+숫자, 최대 50byte
AES-256AES-256/ECB/PKCS5Padding현금영수증 등록번호01011110000현금영수증 등록번호
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└kycKindCdAN(1)영문+숫자, 최대 1byteKYC 종류 코드
KYC 종류 코드
1: CDD 2: EDD*기명 회원의 경우. 무기명은 null
└kycExprDtAN(8)영문+숫자, 최대 8byteKYC 만료일자
20250701KYC 만료일자
*기명 회원의 경우 KYC 만료일자. yyyyMMdd
└hldLmtAmtAN(7)영문+숫자, 최대 7byte*보유 한도 금액
2000000보유 한도 금액
*회원 구분에 따른 선불금 보유 한도 금액
요청 예시
{
"custNo": "2400001605",
"ci": "AES암호화된CI값",
"mid": "M2471645"
}
응답 예시
가입자 (정상)
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": {
"custNo": "2400001605",
"custId": "user123",
"mid": "M2471645",
"custDivCd": "1",
"custStatCd": "N",
"regDt": "20240701",
"regTm": "143025",
"csrcRegNoDivCd": "4",
"csrcRegNo": "AES암호화된번호",
"kycKindCd": "1",
"kycExprDt": "20250701",
"hldLmtAmt": "2000000"
}
}
잠금 회원
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": {
"custNo": "2400001605",
"custId": "user123",
"mid": "M2471645",
"custDivCd": "1",
"custStatCd": "L",
"regDt": "20240701",
"regTm": "143025",
"hldLmtAmt": "2000000"
}
}
미가입자
{
"rsltCd": "1001",
"rsltMsg": "회원 정보가 존재하지 않습니다."
}
회원상태별 처리
| 상태 | 코드 | 처리 방법 |
|---|---|---|
| 정상 | N | 정상 서비스 이용 가능 |
| 잠금 | L | 내정보 페이지에서 비밀번호 재설정 필요 |
| 서비스 해지 | D | 신규 가입 필요 |
| 대기 | W | 가입 진행 중 |
| 휴면 | H | 휴면 해제 필요 |
| KYC 미이행 | K | KYC 절차 이행 필요 |
| 가입거절 | R | 신규 가입 불가 |
주의사항
- 회원가입 화면 호출 전 반드시 미가입자 확인
- 가입자가 회원가입 화면 진입 시 오류코드(103) 반환
- 미가입자가 내정보 화면 진입 시 오류 발생
custNo와custId두 값 모두 요청 시custNo기준으로custId검증- 서비스해지한 고객은
custNo로만 조회 가능
