소멸예정포인트 조회 API
특정 일자까지 소멸 예정인 포인트 금액을 조회하는 API입니다.
API 정보
POST/v1/get/customers/point/expiring
Content-Type
application/json테스트
https://tb-mps-api.hectofinancial.co.kr/v1/get/customers/point/expiring운영
https://mps-api.hectofinancial.co.kr/v1/get/customers/point/expiring요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호
선불 회원번호
*헥토파이낸셜에서 부여하는 고유 선불 회원 번호
└targetDateAN(8)영문+숫자, 최대 8byte*조회 일자
조회 일자
*yyyyMMdd 형식. 해당 일자까지 소멸 예정인 포인트 조회 (최대 60일)
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└rsltCdAN(4)영문+숫자, 최대 4byte*응답코드
0000응답코드
0000: 성공 그 외: 실패└rsltMsgAN(200)영문+숫자, 최대 200byte*응답 메시지
성공응답 메시지
rsltObj (응답 객체)
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호
2400001605선불 회원번호
└expPntBlcAN(7)영문+숫자, 최대 7byte*소멸예정 포인트 금액
1000소멸예정 포인트 금액
*조회 일자까지 소멸 예정인 포인트 금액
요청 예시
{
"custNo": "2400001605",
"targetDate": "20250515"
}
응답 예시
성공
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": {
"custNo": "2400001605",
"expPntBlc": "1000"
}
}
실패
{
"rsltCd": "1001",
"rsltMsg": "회원 정보가 존재하지 않습니다."
}
주의사항
- 조회 일자는 현재 일자로부터 최대 60일까지만 가능합니다.
- 소멸예정 포인트는 해당 일자까지 사용하지 않으면 자동 소멸됩니다.
