충전건별 잔액조회 API
충전 거래건의 잔액 조회
API 정보
POST/v1/wallet/balance/ledger
Content-Type
application/json;charset=UTF-8테스트
https://tb-mps-api.hectofinancial.co.kr/v1/wallet/balance/ledger운영
https://mps-api.hectofinancial.co.kr/v1/wallet/balance/ledger요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원 번호
선불 회원 번호
*헥토파이낸셜에서 부여하는 고유 선불 회원 번호
└ciAN(255)영문+숫자, 최대 255byte*
AES-256AES-256/ECB/PKCS5Padding + Base64선불 회원 CI선불 회원 CI
*고객의 고유한 CI 값
└trdNoAN(50)영문+숫자, 최대 50byte*거래 승인 번호
거래 승인 번호
*헥토파이낸셜에서 부여하는 고유 거래번호
└trdDtAN(8)영문+숫자, 최대 8byte*거래 일자
거래 일자
*yyyyMMdd
└blcDivCdAN(1)영문+숫자, 최대 1byte잔액 구분 코드
잔액 구분 코드
*잔액 구분 코드 (M:머니/대기머니, P:포인트)
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└rsltCdAN(4)영문+숫자, 최대 4byte*응답코드
0000응답코드
0000: 성공└rsltMsgAN(200)영문+숫자, 최대 200byte*응답 메시지
성공응답 메시지
rsltObj (응답 객체)
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원 번호
20240000선불 회원 번호
*헥토파이낸셜에서 부여하는 고유 선불 회원 번호
└chrgAmtN(7)숫자, 최대 7byte*최초 충전 금액
500000최초 충전 금액
*충전 시점의 충전 금액
└blcAmtN(7)숫자, 최대 7byte*보유 잔액
100000보유 잔액
*현재 보유 잔액
요청 예시
{
"custNo": "2400001605",
"ci": "AES암호화된CI값",
"trdNo": "24071616270200002193",
"trdDt": "20240716",
"blcDivCd": "M"
}
응답 예시
성공
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": {
"custNo": "2400001605",
"chrgAmt": "150000",
"blcAmt": "50000"
}
}
실패
{
"rsltCd": "T-008",
"rsltMsg": "원거래를 찾을 수 없습니다."
}
