헥토파이낸셜 개발자센터

상점거래상세조회 API

상점거래번호 (mTrdNo) 로 거래내역 조회

API 정보

POST/v1/trade/detail/market
Content-Typeapplication/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값
└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.chrgTrdNoAN(50)영문+숫자, 최대 50byte
충전거래번호
*거래구분코드(trdDivCd)가 충전(MP/PP)일 경우 전달됩니다.
└rsltObj.orgTrdNoAN(50)영문+숫자, 최대 50byteORDER20240715
원거래번호
*기본값은 빈값이며, 거래구분코드(trdDivCd)가 취소 관련(UC/MC/PC)일 경우 원거래번호가 전달됩니다.
└rsltObj.orgTrdDtAN(8)영문+숫자, 최대 8byte
원거래일자
*기본값은 빈값이며, 거래구분코드(trdDivCd)가 취소 관련(UC/MC/PC)일 경우 원거래일자가 전달됩니다.
└rsltObj.reqDtAN(8)영문+숫자, 최대 8byte20240717
요청 일자
*가맹점 요청 일자 (yyyyMMdd)
└rsltObj.reqTmAN(6)영문+숫자, 최대 6byte190203
요청 시각
*가맹점 요청 시각 (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)영문+숫자, 최대 2byteRA
충전 수단 코드
*MP:머니충전/PP:포인트지급 만 해당
└rsltObj.trdSumryAN(100)영문+숫자, 최대 100byte987
거래 적요
*지급 사유, 지급 취소 사유, 머니 출금 계좌 번호 (뒷 세자리)
└rsltObj.trdAmtN(7)숫자, 최대 7byte*2000
거래 금액
└rsltObj.mnyAmtN(7)숫자, 최대 7byte*1000
머니 금액
└rsltObj.pntAmtN(7)숫자, 최대 7byte*1000
포인트 금액
└rsltObj.waitMnyAmtN(7)숫자, 최대 7byte1000
대기머니 금액
└rsltObj.mnyBlcN(7)숫자, 최대 7byte*1000
머니 잔액
└rsltObj.pntBlcN(7)숫자, 최대 7byte*1000
포인트 잔액
└rsltObj.waitMnyBlcN(7)숫자, 최대 7byte*1000
대기머니 잔액
└rsltObj.mnyVldPdAN(8)영문+숫자, 최대 8byte20240722
머니 유효 기간
*거래 구분 MP(머니 충전)일 경우
└rsltObj.pntVldPdAN(8)영문+숫자, 최대 8byte20240722
포인트 유효 기간
*거래 구분 PP(포인트 지급)일 경우
└rsltObj.cnclYnAN(1)영문+숫자, 최대 1byteN
취소 여부
*거래 구분 CU(사용), MP(머니충전), PP(포인트지급) 일 경우, 취소된 거래 건에 한 함
└rsltObj.csrcIssReqYnAN(1)영문+숫자, 최대 1byteY
현금영수증 신청 여부
*거래 구분 'CU(사용)' 일 경우
└rsltObj.csrcIssStatCdAN(1)영문+숫자, 최대 1byteY
현금영수증 발행 상태
*거래 구분 CU(사용)일 경우
└rsltObj.csrcAppNoAN(50)영문+숫자, 최대 50byte20240722100000
현금영수증 승인 번호
*거래 구분 CU(사용)일 경우
└rsltObj.csrcApprDtmAN(14)영문+숫자, 최대 14byte
현금영수증 승인 일시
*거래 구분 'CU(사용)' 일 경우. YYYYMMDDHHMMSS
└rsltObj.statusAN(1)영문+숫자, 최대 1byte
거래 상태
0: 처리 중 1: 처리 완료
*거래 구분 'MW(머니출금), WW(대기머니출금), TW(해지출금)' 일 경우 출금 상태 확인
└rsltObj.stlMIdAN(20)영문+숫자, 최대 20byte
정산 상점 아이디
*정산 대상 상점 아이디
└rsltObj.storCdAN(20)영문+숫자, 최대 20byteHF000001
사용처 코드
└rsltObj.storNmAN(128)영문+숫자, 최대 128byte헥토파이낸셜
사용처 명
└rsltObj.cnclTrdAmtN(7)숫자, 최대 7byte1000
취소 금액
*거래 구분 코드가 'CU/MP/PP' 일경우, 원거래건 취소 시 취소 금액
└rsltObj.cnclMnyAmtN(7)숫자, 최대 7byte1000
취소 머니 금액
*거래 구분 코드가 'CU/MP/PP' 일경우, 원거래건 취소 시 취소 머니 금액
└rsltObj.cnclPntAmtN(7)숫자, 최대 7byte1000
취소 포인트 금액
*거래 구분 코드가 'CU/MP/PP' 일경우, 원거래건 취소 시 취소 포인트 금액
└rsltObj.lastCnclDateN(14)숫자, 최대 14byteYYYYMMDDHH24MISS
마지막 취소 일자
*거래 구분 코드가 'CU/MP/PP' 일경우, 마지막 원거래 취소 발생 일자
└rsltObj.mResrvField1AN(255)영문+숫자, 최대 255byte
상점여유필드1
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└rsltObj.mResrvField2AN(255)영문+숫자, 최대 255byte
상점여유필드2
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└rsltObj.mResrvField3AN(255)영문+숫자, 최대 255byte
상점여유필드3
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의

주의사항

NOTE

응답 데이터 형식

rsltObj는 LIST(배열) 타입의 응답 객체입니다. 조건에 해당하는 거래 내역이 여러 건일 수 있어 각 거래가 배열의 요소로 반환됩니다.
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?

무엇이든 물어보세요