잔액 조회 API
회원의 머니 및 포인트 잔액을 조회하는 API입니다.
API 정보
POST/v1/wallet/balance
Content-Type
application/json테스트
https://tb-mps-api.hectofinancial.co.kr/v1/wallet/balance운영
https://mps-api.hectofinancial.co.kr/v1/wallet/balanceNOTE
사전 조회 필수
다른 API 요청 전, 해당 API로 머니 잔액, 포인트 잔액, 대기 머니 잔액 값을 확인 후 사용해 주세요.
요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호
선불 회원번호
*헥토파이낸셜에서 부여하는 고유 선불 회원 번호
└ciAN(255)영문+숫자, 최대 255byte*
AES-256AES-256/ECB/PKCS5Padding + Base64선불 회원 CI선불 회원 CI
*고객의 고유한 CI 값. AES-256/ECB/PKCS5Padding 암호화 후 Base64 인코딩 필요
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└rsltCdAN(4)영문+숫자, 최대 4byte*응답코드
0000응답코드
0000: 성공 그 외: 실패└rsltMsgAN(200)영문+숫자, 최대 200byte*응답 메시지
성공응답 메시지
rsltObj (응답 객체)
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호
2400001605선불 회원번호
└custDivCdAN(1)영문+숫자, 최대 1byte*고객 구분 코드
고객 구분 코드
0: 무기명 1: 기명└chrgblAmtN(7)숫자, 최대 7byte*충전 가능금액
500000충전 가능금액
*조회 시점의 충전 가능 머니 금액
└mnyBlcN(7)숫자, 최대 7byte*머니 잔액
1500000머니 잔액
└pntBlcN(7)숫자, 최대 7byte*포인트 잔액
1000포인트 잔액
└waitMnyBlcN(7)숫자, 최대 7byte*대기 머니 잔액
0대기 머니 잔액
*사용 취소로 인해 발생한 대기 상태 머니
└expMnyBlcN(7)숫자, 최대 7byte*2개월 내 소멸 예정 머니 금액
02개월 내 소멸 예정 머니 금액
*머니 유효기간 10년
요청 예시
{
"custNo": "2400001605",
"ci": "AES암호화된CI값"
}
응답 예시
성공
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": {
"custNo": "2400001605",
"custDivCd": "0",
"chrgblAmt": "500000",
"mnyBlc": "1500000",
"pntBlc": "1000",
"waitMnyBlc": "0",
"expMnyBlc": "0"
}
}
실패
{
"rsltCd": "C-001",
"rsltMsg": "존재하지 않는 회원입니다."
}
