거래 내역 조회 API

회원의 거래 내역 목록을 조회하는 API입니다.

API 정보

POST/v1/trade/list

Content-Typeapplication/json

테스트https://tb-mps-api.hectofinancial.co.kr/v1/trade/list

운영https://mps-api.hectofinancial.co.kr/v1/trade/list

거래 구분 코드

코드	설명
CU	사용
UC	사용 취소
MP	머니 충전
MC	머니 충전 취소
MW	머니 출금
WW	대기머니 출금
MG	머니 선물
MR	머니 받기
PP	포인트 지급
PC	포인트 지급 취소

요청 파라미터

타입 표기법

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 암호화 필요

└periodAN(6)영문+숫자, 최대 6byte조회년월

조회년월

*YYYYMM. 기본값 당월

└pageN(3)숫자, 최대 3byte페이지

페이지

*기본값 1

└sizeN(3)숫자, 최대 3byte한 페이지 당 아이템 수

한 페이지 당 아이템 수

*기본값 10

└trdDivCdAN(128)영문+숫자, 최대 128byte거래 구분 코드

거래 구분 코드

CU: 사용 UC: 사용취소 MP: 머니충전 MC: 머니충전 취소 MW: 머니 출금 WW: 대기머니 출금 MG: 머니 선물 MR: 머니 받기 PP: 포인트 지급 PC: 포인트 지급 취소

*조회하고자 하는 거래구분 코드가 2개 이상일 경우 콤마(,)로 구분. 예: MG,MR,UC,PP

└trdNoAN(50)영문+숫자, 최대 50byte거래 승인번호

거래 승인번호

*헥토파이낸셜에서 부여하는 고유 거래번호

└mTrdNoAN(50)영문+숫자, 최대 50byte상점 거래번호

상점 거래번호

*가맹점에서 생성하는 거래번호 (한글 제외)

└showCnclYnAN(1)영문+숫자, 최대 1byte취소 거래 표시 여부

취소 거래 표시 여부

Y: 취소거래 표시 N: 취소거래 미표시

*기본적으로 취소거래는 거래내역 조회에 포함되지 않음. 취소거래건을 하나의 거래로써 거래내역에 포함하고 싶은 경우 Y로 설정. 단, 요청값에 거래 구분 코드가 있을 경우, 해당 값은 무시됨

└blcDivCdAN(1)영문+숫자, 최대 1byte잔액 구분 코드

잔액 구분 코드

M: 머니/대기머니 P: 포인트

*미입력 시 전체조회. M 입력 시 머니/대기머니 금액이 0보다 큰 거래 건 조회. P 입력 시 포인트 금액이 0보다 큰 거래 건 조회

└cardTrdOnlyYnAN(1)영문+숫자, 최대 1byte카드 거래 전용 조회 여부

카드 거래 전용 조회 여부

Y: 카드 거래 전용 조회 N: 모든 거래 조회

*Y일 경우, 카드거래건만 필터링하여 조회 가능하며, trdDivCd 값은 CU(사용), UC(사용취소) 만 가능

응답 파라미터

타입 표기법

N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자

예: AN(10) = 영문+숫자, 최대 10byte

└rsltCdAN(4)영문+숫자, 최대 4byte*응답코드0000

응답코드

0000: 성공 그 외: 실패

└rsltMsgAN(255)영문+숫자, 최대 255byte*응답 메시지성공

응답 메시지

rsltObj (응답 객체 - LIST 타입)

└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호2400001605

선불 회원번호

└mTrdNoAN(50)영문+숫자, 최대 50byte*상점 거래번호ORDER20240716

상점 거래번호

*한글 제외

└trdNoAN(50)영문+숫자, 최대 50byte*거래 승인번호24071616270200002193

거래 승인번호

*헥토파이낸셜에서 부여하는 고유 거래번호

└trdDtAN(8)영문+숫자, 최대 8byte*거래 일자20240716

거래 일자

*yyyyMMdd

└trdTmAN(6)영문+숫자, 최대 6byte*거래 시각164101

거래 시각

*HHmmss

└trdDivCdAN(2)영문+숫자, 최대 2byte*거래 구분 코드

거래 구분 코드

└trdDivDtlCdAN(12)영문+숫자, 최대 12byte거래 구분 상세 코드

거래 구분 상세 코드

*가맹점 거래 구분 상세 코드값 (사전에 등록된 값만 사용 가능)

└chrgMeanCdAN(2)영문+숫자, 최대 2byte*충전 수단 코드RA

충전 수단 코드

*MP:머니충전/PP:포인트지급 만 해당

└trdSumryAN(100)영문+숫자, 최대 100byte거래 적요987

거래 적요

*지급 사유, 지급 취소 사유, 머니 출금 계좌 번호 (뒷 세자리)

└trdAmtN(7)숫자, 최대 7byte*거래 금액2000

거래 금액

└mnyAmtN(7)숫자, 최대 7byte*머니 금액1000

머니 금액

└pntAmtN(7)숫자, 최대 7byte*포인트 금액1000

포인트 금액

└waitMnyAmtN(7)숫자, 최대 7byte*대기머니 금액0

대기머니 금액

└cnclTrdAmtN(7)숫자, 최대 7byte취소 금액1000

취소 금액

*거래 구분 코드가 CU/MP/PP 일경우, 원거래건 취소 시 취소 금액

└cnclMnyAmtN(7)숫자, 최대 7byte취소 머니 금액1000

취소 머니 금액

*거래 구분 코드가 CU/MP/PP 일경우, 원거래건 취소 시 취소 머니 금액

└cnclPntAmtN(7)숫자, 최대 7byte취소 포인트 금액0

취소 포인트 금액

*거래 구분 코드가 CU/MP/PP 일경우, 원거래건 취소 시 취소 포인트 금액

└lastCnclDateN(14)숫자, 최대 14byte마지막 취소 일자20240718190801

마지막 취소 일자

*거래 구분 코드가 CU/MP/PP 일경우, 마지막 원거래 취소 발생 일자. YYYYMMDDHH24MISS

└stlMIdAN(20)영문+숫자, 최대 20byte정산 상점 아이디

정산 상점 아이디

*정산 대상 상점 아이디

└storCdAN(20)영문+숫자, 최대 20byte사용처 코드HF000001

사용처 코드

└storNmAN(128)영문+숫자, 최대 128byte사용처 명헥토파이낸셜

사용처 명

└mResrvField1AN(255)영문+숫자, 최대 255byte상점 여유필드 1

상점 여유필드 1

*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의

└mResrvField2AN(255)영문+숫자, 최대 255byte상점 여유필드 2

상점 여유필드 2

*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의

└mResrvField3AN(255)영문+숫자, 최대 255byte상점 여유필드 3

상점 여유필드 3

*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의

요청 예시

{
  "custNo": "2400001605",
  "ci": "AES암호화된CI값",
  "period": "202407",
  "page": 1,
  "size": 10,
  "trdDivCd": "CU,MP"
}

응답 예시

성공

{
  "rsltCd": "0000",
  "rsltMsg": "성공",
  "rsltObj": [
    {
      "custNo": "2400001605",
      "mTrdNo": "ORDER20240716",
      "trdNo": "24071616270200002193",
      "trdDt": "20240716",
      "trdTm": "164101",
      "trdDivCd": "CU",
      "chrgMeanCd": "",
      "trdSumry": "",
      "trdAmt": "10000",
      "mnyAmt": "9000",
      "pntAmt": "1000",
      "waitMnyAmt": "0",
      "cnclTrdAmt": "0",
      "cnclMnyAmt": "0",
      "cnclPntAmt": "0",
      "storCd": "HF000001",
      "storNm": "헥토파이낸셜"
    },
    {
      "custNo": "2400001605",
      "mTrdNo": "ORDER20240715",
      "trdNo": "24071516270200002192",
      "trdDt": "20240715",
      "trdTm": "100000",
      "trdDivCd": "MP",
      "chrgMeanCd": "CA",
      "trdSumry": "충전",
      "trdAmt": "50000",
      "mnyAmt": "50000",
      "pntAmt": "0",
      "waitMnyAmt": "0"
    }
  ]
}

실패

{
  "rsltCd": "1001",
  "rsltMsg": "회원 정보가 존재하지 않습니다."
}

주의사항

기본적으로 취소거래(머니충전취소, 포인트지급취소, 사용취소)는 거래내역 조회에 포함되지 않습니다. (원거래건에 "취소" 거래금액으로 확인 가능)
취소거래건을 하나의 거래로써 거래내역에 포함하고 싶은 경우, showCnclYn을 Y로 설정하세요.
단, 요청값에 거래 구분 코드(trdDivCd)가 있을 경우, showCnclYn 값은 무시됩니다.

더 궁금한 내용이 있나요?

FAQ

기술지원이 필요한가요?

코드 샘플

HectoFinancial GitHub