잔액 상세 조회 API
회원의 머니 및 포인트 잔액을 구분코드별로 상세 조회하는 API입니다.
API 정보
POST/v1/wallet/balance/detail
Content-Type
application/json테스트
https://tb-mps-api.hectofinancial.co.kr/v1/wallet/balance/detail운영
https://mps-api.hectofinancial.co.kr/v1/wallet/balance/detail요청 파라미터
타입 표기법
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대기 머니 잔액
*사용 취소로 인해 발생한 대기 상태 머니
data (상세 잔액 객체)
└PList[]*포인트 상세 내역
포인트 상세 내역
*잔액구분코드별 포인트 상세 목록
└MList[]*머니 상세 내역
머니 상세 내역
*잔액구분코드별 머니 상세 목록
요청 예시
{
"custNo": "2400001605",
"ci": "AES암호화된CI값"
}
응답 예시
성공
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": {
"custNo": "2400001605",
"custDivCd": "0",
"chrgblAmt": "500000",
"mnyBlc": "1500000",
"pntBlc": "500",
"waitMnyBlc": "0",
"data": {
"P": [
{
"blcDivCd": "CP", // 가맹점 지급포인트
"blcAmt": "500",
"expDt": "20340716"
}
],
"M": [
{
"blcDivCd": "CA", // 신용카드
"blcAmt": "100000",
"expDt": "20340716"
},
{
"blcDivCd": "EZ", // 내통장
"blcAmt": "500000",
"expDt": "20350716"
}
]
}
}
}
실패
{
"rsltCd": "C-015",
"rsltMsg": "CI 값이 일치하지 않습니다."
}
주의사항
- 잔액 조회 API와 달리 구분코드별 상세 내역을 제공합니다.
- 상세 내역에는 잔액구분코드, 금액, 만료일자 등이 포함됩니다.
