상점거래상세조회 API
상점거래번호 (mTrdNo) 로 거래내역 조회
API 정보
POST/v1/trade/detail/market
Content-Type
application/json;charset=UTF-8테스트
https://tb-mps-api.hectofinancial.co.kr/v1/trade/detail/market운영
https://mps-api.hectofinancial.co.kr/v1/trade/detail/market요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원 번호
선불 회원 번호
*헥토파이낸셜에서 부여하는 고유 선불 회원 번호
└ciAN(255)영문+숫자, 최대 255byte*
AES-256AES-256/ECB/PKCS5Padding + Base64선불 회원 CI선불 회원 CI
*고객의 고유한 CI값
└mTrdNoAN(50)영문+숫자, 최대 50byte*상점 거래 번호
상점 거래 번호
*상점에서 생성하는 거래번호
└periodAN(6)영문+숫자, 최대 6byte*조회 년 월
조회 년 월
*yyyyMM
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└rsltCdAN(4)영문+숫자, 최대 4byte*응답코드
0000응답코드
0000: 성공└rsltMsgAN(255)영문+숫자, 최대 255byte*응답 메시지
성공응답 메시지
└rsltObj.custNoAN(20)영문+숫자, 최대 20byte*선불 회원 번호
20240000선불 회원 번호
*헥토파이낸셜에서 부여하는 고유 선불 회원 번호
└rsltObj.mTrdNoAN(50)영문+숫자, 최대 50byte*상점 거래 번호
ORDER20240716상점 거래 번호
*상점에서 생성하는 거래번호 ※ 한글 제외
└rsltObj.trdNoAN(50)영문+숫자, 최대 50byte*거래 승인 번호
24071616270200002193거래 승인 번호
*헥토파이낸셜에서 부여하는 고유 거래번호
└rsltObj.orgTrdNoAN(2)영문+숫자, 최대 2byte원거래 승인 번호
ORDER20240715원거래 승인 번호
*원거래가 존재시 해당 (거래 구분 UC(사용취소), MC(머니 지급 취소), PC(포인트 지급 취소) 일 경우)
└rsltObj.reqDtAN(8)영문+숫자, 최대 8byte요청 일자
20240717요청 일자
*가맹점 요청 일자 (yyyyMMdd)
└rsltObj.reqTmAN(6)영문+숫자, 최대 6byte요청 시각
190203요청 시각
*가맹점 요청 시각 (HHmmss)
└rsltObj.trdDtAN(8)영문+숫자, 최대 8byte*거래 일자
YYYYMMDD거래 일자
*거래 취소 성공시, 취소 거래 일자
└rsltObj.trdTmAN(6)영문+숫자, 최대 6byte*거래 시각
HHMMSS거래 시각
*거래 취소 성공시, 취소 거래 시각
└rsltObj.trdDivCdAN(2)영문+숫자, 최대 2byte*거래 구분 코드
CU거래 구분 코드
CU: 사용 UC: 사용취소 MP: 머니충전 MC: 머니충전 취소 MW: 머니 출금 WW: 대기머니 출금 MG: 머니 선물 MR: 머니 받기 PP: 포인트 지급 PC: 포인트 지급 취소└rsltObj.trdDivDtlCdAN(12)영문+숫자, 최대 12byte거래 구분 상세 코드
거래 구분 상세 코드
*가맹점 거래 구분 상세 코드값 (사전에 등록된 값만 사용 가능)
└rsltObj.chrgMeanCdAN(2)영문+숫자, 최대 2byte충전 수단 코드
RA충전 수단 코드
*MP:머니충전/PP:포인트지급 만 해당
└rsltObj.trdSumryAN(100)영문+숫자, 최대 100byte거래 적요
987거래 적요
*지급 사유, 지급 취소 사유, 머니 출금 계좌 번호 (뒷 세자리)
└rsltObj.trdAmtN(7)숫자, 최대 7byte*거래 금액
2000거래 금액
└rsltObj.mnyAmtN(7)숫자, 최대 7byte*머니 금액
1000머니 금액
└rsltObj.pntAmtN(7)숫자, 최대 7byte*포인트 금액
1000포인트 금액
└rsltObj.waitMnyAmtN(7)숫자, 최대 7byte대기머니 금액
1000대기머니 금액
└rsltObj.mnyBlcN(7)숫자, 최대 7byte*머니 잔액
1000머니 잔액
└rsltObj.pntBlcN(7)숫자, 최대 7byte*포인트 잔액
1000포인트 잔액
└rsltObj.waitMnyBlcN(7)숫자, 최대 7byte*대기머니 잔액
1000대기머니 잔액
└rsltObj.mnyVldPdAN(8)영문+숫자, 최대 8byte머니 유효 기간
20240722머니 유효 기간
*거래 구분 MP(머니 충전)일 경우
└rsltObj.pntVldPdAN(8)영문+숫자, 최대 8byte포인트 유효 기간
20240722포인트 유효 기간
*거래 구분 PP(포인트 지급)일 경우
└rsltObj.cnclYnAN(1)영문+숫자, 최대 1byte취소 여부
N취소 여부
*거래 구분 CU(사용), MP(머니충전), PP(포인트지급) 일 경우, 취소된 거래 건에 한 함
└rsltObj.csrcIssReqYnAN(1)영문+숫자, 최대 1byte현금영수증 신청 여부
Y현금영수증 신청 여부
*거래 구분 'CU(사용)' 일 경우
└rsltObj.csrcIssStatCdAN(1)영문+숫자, 최대 1byte현금영수증 발행 상태
Y현금영수증 발행 상태
*거래 구분 CU(사용)일 경우
└rsltObj.csrcAppNoAN(50)영문+숫자, 최대 50byte현금영수증 승인 번호
20240722100000현금영수증 승인 번호
*거래 구분 CU(사용)일 경우
└rsltObj.csrcApprDtmAN(14)영문+숫자, 최대 14byte현금영수증 승인 일시
현금영수증 승인 일시
*거래 구분 'CU(사용)' 일 경우. YYYYMMDDHHMMSS
└rsltObj.statusAN(1)영문+숫자, 최대 1byte거래 상태
거래 상태
0: 처리 중 1: 처리 완료*거래 구분 'MW(머니출금), WW(대기머니출금), TW(해지출금)' 일 경우 출금 상태 확인
└rsltObj.stlMIdAN(20)영문+숫자, 최대 20byte정산 상점 아이디
정산 상점 아이디
*정산 대상 상점 아이디
└rsltObj.storCdAN(20)영문+숫자, 최대 20byte사용처 코드
HF000001사용처 코드
└rsltObj.storNmAN(128)영문+숫자, 최대 128byte사용처 명
헥토파이낸셜사용처 명
└rsltObj.cnclTrdAmtN(7)숫자, 최대 7byte취소 금액
1000취소 금액
*거래 구분 코드가 'CU/MP/PP' 일경우, 원거래건 취소 시 취소 금액
└rsltObj.cnclMnyAmtN(7)숫자, 최대 7byte취소 머니 금액
1000취소 머니 금액
*거래 구분 코드가 'CU/MP/PP' 일경우, 원거래건 취소 시 취소 머니 금액
└rsltObj.cnclPntAmtN(7)숫자, 최대 7byte취소 포인트 금액
1000취소 포인트 금액
*거래 구분 코드가 'CU/MP/PP' 일경우, 원거래건 취소 시 취소 포인트 금액
└rsltObj.lastCnclDateN(14)숫자, 최대 14byte마지막 취소 일자
YYYYMMDDHH24MISS마지막 취소 일자
*거래 구분 코드가 'CU/MP/PP' 일경우, 마지막 원거래 취소 발생 일자
└rsltObj.mResrvField1AN(255)영문+숫자, 최대 255byte상점여유필드1
상점여유필드1
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└rsltObj.mResrvField2AN(255)영문+숫자, 최대 255byte상점여유필드2
상점여유필드2
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└rsltObj.mResrvField3AN(255)영문+숫자, 최대 255byte상점여유필드3
상점여유필드3
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
주의사항
NOTE
응답 데이터 형식
rsltObj는 LIST(배열) 타입의 응답 객체입니다. 조건에 해당하는 거래 내역이 여러 건일 수 있어 각 거래가 배열의 요소로 반환됩니다.
