거래 상세 조회 API
특정 거래의 상세 정보를 조회하는 API입니다.
API 정보
POST/v1/trade/detail
Content-Type
application/json테스트
https://tb-mps-api.hectofinancial.co.kr/v1/trade/detail운영
https://mps-api.hectofinancial.co.kr/v1/trade/detail요청 파라미터
타입 표기법
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 암호화 필요
└trdNoAN(50)영문+숫자, 최대 50byte*거래 승인번호
거래 승인번호
*헥토파이낸셜에서 부여하는 고유 거래번호
└trdDtAN(8)영문+숫자, 최대 8byte*거래 승인 일자
거래 승인 일자
*yyyyMMdd
응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└rsltCdAN(4)영문+숫자, 최대 4byte*응답코드
0000응답코드
0000: 성공 그 외: 실패└rsltMsgAN(255)영문+숫자, 최대 255byte*응답 메시지
성공응답 메시지
rsltObj (응답 객체)
└custNoAN(20)영문+숫자, 최대 20byte*선불 회원번호
2400001605선불 회원번호
└mtrdNoAN(50)영문+숫자, 최대 50byte*상점 거래번호
ORDER20240716상점 거래번호
*한글 제외
└trdNoAN(50)영문+숫자, 최대 50byte*거래 승인번호
24071616270200002193거래 승인번호
*헥토파이낸셜에서 부여하는 고유 거래번호
└orgTrdNoAN(50)영문+숫자, 최대 50byte원거래 승인번호
ORDER20240715원거래 승인번호
*원거래가 존재시 해당 (거래 구분 UC, MC, PC 일 경우)
└reqDtAN(8)영문+숫자, 최대 8byte요청 일자
20240717요청 일자
*가맹점 요청 일자. yyyyMMdd
└reqTmAN(6)영문+숫자, 최대 6byte요청 시각
190203요청 시각
*가맹점 요청 시각. HHmmss
└trdDtAN(8)영문+숫자, 최대 8byte*거래 일자
20240716거래 일자
*yyyyMMdd
└trdTmAN(6)영문+숫자, 최대 6byte*거래 시각
164101거래 시각
*HHmmss
└trdDivCdAN(2)영문+숫자, 최대 2byte*거래 구분 코드
거래 구분 코드
CU: 사용 UC: 사용취소 MP: 머니충전 MC: 머니충전 취소 MW: 머니 출금 WW: 대기머니 출금 MG: 머니 선물 MR: 머니 받기 PP: 포인트 지급 PC: 포인트 지급 취소└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대기머니 금액
└mnyBlcN(7)숫자, 최대 7byte*머니 잔액
10000머니 잔액
└pntBlcN(7)숫자, 최대 7byte*포인트 잔액
1000포인트 잔액
└waitMnyBlcN(7)숫자, 최대 7byte*대기머니 잔액
0대기머니 잔액
└mnyVldPdAN(8)영문+숫자, 최대 8byte머니 유효 기간
20340722머니 유효 기간
*거래 구분 MP(머니 충전) 일 경우. yyyyMMdd
└pntVldPdAN(8)영문+숫자, 최대 8byte포인트 유효 기간
20340722포인트 유효 기간
*거래 구분 PP(포인트 지급) 일 경우. yyyyMMdd
└cnclYnAN(1)영문+숫자, 최대 1byte취소 여부
취소 여부
Y: 취소됨 N: 미취소*거래 구분 CU(사용), MP(머니충전), PP(포인트지급) 일 경우, 취소된 거래 건에 한 함
└csrcIssReqYnAN(1)영문+숫자, 최대 1byte현금영수증 신청 여부
현금영수증 신청 여부
Y: 신청 N: 미신청*거래 구분 CU(사용) 일 경우
└csrcIssStatCdAN(1)영문+숫자, 최대 1byte현금영수증 발행 상태
현금영수증 발행 상태
*거래 구분 CU(사용) 일 경우
└csrcAppNoAN(50)영문+숫자, 최대 50byte현금영수증 승인 번호
20240722100000현금영수증 승인 번호
*거래 구분 CU(사용) 일 경우
└csrcApprDtmAN(14)영문+숫자, 최대 14byte현금영수증 승인 일시
현금영수증 승인 일시
*거래 구분 CU(사용) 일 경우. YYYYMMDDHHMMSS
└statusAN(1)영문+숫자, 최대 1byte거래 상태
거래 상태
0: 처리 중 1: 처리 완료*거래 구분 MW(머니출금), WW(대기머니출금), TW(해지출금) 일 경우 출금 상태 확인
└stlMIdAN(20)영문+숫자, 최대 20byte정산 상점 아이디
정산 상점 아이디
*정산 대상 상점 아이디
└storCdAN(20)영문+숫자, 최대 20byte사용처 코드
HF000001사용처 코드
└storNmAN(128)영문+숫자, 최대 128byte사용처 명
헥토파이낸셜사용처 명
└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
└mResrvField1AN(255)영문+숫자, 최대 255byte상점 여유필드 1
상점 여유필드 1
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└mResrvField2AN(255)영문+숫자, 최대 255byte상점 여유필드 2
상점 여유필드 2
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
└mResrvField3AN(255)영문+숫자, 최대 255byte상점 여유필드 3
상점 여유필드 3
*평문으로 송수신되므로 개인정보와 같은 민감정보 포함되지 않도록 주의
요청 예시
{
"custNo": "2400001605",
"ci": "AES암호화된CI값",
"trdNo": "24071616270200002193",
"trdDt": "20240716"
}
응답 예시
성공 (사용 거래)
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": {
"custNo": "2400001605",
"mtrdNo": "ORDER20240716",
"trdNo": "24071616270200002193",
"reqDt": "20240716",
"reqTm": "164100",
"trdDt": "20240716",
"trdTm": "164101",
"trdDivCd": "CU",
"trdSumry": "",
"trdAmt": "10000",
"mnyAmt": "9000",
"pntAmt": "1000",
"waitMnyAmt": "0",
"mnyBlc": "11000",
"pntBlc": "0",
"waitMnyBlc": "0",
"cnclYn": "N",
"csrcIssReqYn": "Y",
"csrcIssStatCd": "Y",
"csrcAppNo": "20240716164102",
"csrcApprDtm": "20240716164102",
"storCd": "HF000001",
"storNm": "헥토파이낸셜",
"cnclTrdAmt": "0",
"cnclMnyAmt": "0",
"cnclPntAmt": "0"
}
}
성공 (출금 거래)
{
"rsltCd": "0000",
"rsltMsg": "성공",
"rsltObj": {
"custNo": "2400001605",
"mtrdNo": "ORDER20240717",
"trdNo": "24071716270200002194",
"trdDt": "20240717",
"trdTm": "100000",
"trdDivCd": "MW",
"trdSumry": "987",
"trdAmt": "50000",
"mnyAmt": "50000",
"pntAmt": "0",
"mnyBlc": "0",
"pntBlc": "0",
"waitMnyBlc": "0",
"status": "1"
}
}
실패
{
"rsltCd": "1001",
"rsltMsg": "거래 정보가 존재하지 않습니다."
}
