출금 가능 머니 조회 API
출금 가능한 머니 금액과 해당 월의 출금 횟수를 조회하는 API입니다.
API 정보
POST/v1/wallet/balance/withdrawal
Content-Type
application/json테스트
https://tb-mps-api.hectofinancial.co.kr/v1/wallet/balance/withdrawal운영
https://mps-api.hectofinancial.co.kr/v1/wallet/balance/withdrawal요청 파라미터
타입 표기법
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*응답 메시지
성공응답 메시지
rsltObj (응답 객체)
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호
2400001605선불 회원번호
└wdMnyAmtAN(7)영문+숫자, 최대 7byte*출금 가능 머니 금액
500000출금 가능 머니 금액
*대기머니 제외
└mwCountN(3)숫자, 최대 3byte*해당 월 출금 횟수
2해당 월 출금 횟수
요청 예시
{
"custNo": "2400001605",
"ci": "AES암호화된CI값"
}
응답 예시
성공
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": {
"custNo": "2400001605",
"wdMnyAmt": "500000",
"mwCount": "2"
}
}
실패
{
"rsltCd": "1001",
"rsltMsg": "회원 정보가 존재하지 않습니다."
}
주의사항
- 출금 가능 금액은 대기머니를 제외한 일반 머니 잔액입니다.
- 출금 횟수 제한이 있을 수 있으므로
mwCount를 확인하세요.
