충전 수단 조회 API
가맹점에서 사용 가능한 충전 수단 목록을 조회하는 API입니다.
API 정보
POST/v1/market/charge/list
Content-Type
application/json테스트
https://tb-mps-api.hectofinancial.co.kr/v1/market/charge/list운영
https://mps-api.hectofinancial.co.kr/v1/market/charge/list요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└midAN(20)영문+숫자, 최대 20byte*상점 아이디
상점 아이디
*헥토파이낸셜에서 부여하는 고유한 상점 아이디
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└rsltCdAN(4)영문+숫자, 최대 4byte*응답코드
0000응답코드
0000: 성공 그 외: 실패└rsltMsgAN*응답 메시지
성공응답 메시지
rsltObj (응답 객체 - LIST 타입)
└midAN(20)영문+숫자, 최대 20byte*상점 아이디
M2471645상점 아이디
└chrgMeanCdAN(10)영문+숫자, 최대 10byte*충전 수단 코드
CA충전 수단 코드
CA: 신용카드 ZOZ: 010가상계좌 EZ: 내통장결제 RA: 계좌 PIN: 핀 RP: 간편현금결제 MM: 머니이관 PM: 포인트이관└chrgMeanNmAN(20)영문+숫자, 최대 20byte*충전 수단명
신용카드충전 수단명
└stDateAN(14)영문+숫자, 최대 14byte*시작일시
20240101000000시작일시
*yyyyMMddHHmmss. 해당 충전 수단 제공 시작 일자
└edDateAN(14)영문+숫자, 최대 14byte*종료일시
99991231235959종료일시
*yyyyMMddHHmmss. 해당 충전 수단 제공 종료 일자
└rmkAN(100)영문+숫자, 최대 100byte비고
비고
└minChrgAmtN(7)숫자, 최대 7byte*최소 충전 금액
10000최소 충전 금액
*해당 충전 수단으로 충전 가능한 최소 금액
└minChrgUnitCdN(7)숫자, 최대 7byte*최소 충전 단위 코드
MANWON최소 충전 단위 코드
*해당 충전 수단으로 충전 가능한 최소 충전 단위
└orderN(3)숫자, 최대 3byte*표시 순서
1표시 순서
└chrgCnclPsblYnAN(1)영문+숫자, 최대 1byte*충전 취소 가능 여부
Y충전 취소 가능 여부
Y: 가능 N: 불가*해당 충전 수단을 사용하여 충전한 건의 취소 가능 여부
요청 예시
{
"mid": "M2471645"
}
응답 예시
성공
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": [
{
"mid": "M2471645",
"chrgMeanCd": "CA",
"chrgMeanNm": "신용카드",
"stDate": "20240101000000",
"edDate": "99991231235959",
"rmk": "",
"minChrgAmt": "10000",
"minChrgUnitCd": "MANWON",
"order": "1",
"chrgCnclPsblYn": "Y"
},
{
"mid": "M2471645",
"chrgMeanCd": "RA",
"chrgMeanNm": "계좌이체",
"stDate": "20240101000000",
"edDate": "99991231235959",
"rmk": "",
"minChrgAmt": "10000",
"minChrgUnitCd": "MANWON",
"order": "2",
"chrgCnclPsblYn": "N"
}
]
}
실패
{
"rsltCd": "1001",
"rsltMsg": "상점 정보가 존재하지 않습니다."
}
충전 수단 코드
| 코드 | 충전 수단 |
|---|---|
| CA | 신용카드 |
| ZOZ | 010가상계좌 |
| EZ | 내통장결제 |
| RA | 계좌이체 |
| PIN | 핀 |
| RP | 간편현금결제 |
| MM | 머니이관 |
| PM | 포인트이관 |
