헥토파이낸셜 개발자센터

거래대사 API

특정 거래일자의 거래내역을 조회하는 API입니다. 가맹점 서버에서 헥토파이낸셜 서버로 거래대사 조회를 위한 API를 호출하면, 헥토파이낸셜측 거래대사 결과가 응답됩니다.

테스트용 키 정보

API 정보

POST/api/pg/{상점아이디}/transInfo.do
Content-Typeapplication/x-www-form-urlencoded
테스트https://tb-nspay.settlebank.co.kr/api/pg/{상점아이디}/transInfo.do
운영https://nspay.settlebank.co.kr/api/pg/{상점아이디}/transInfo.do

주의 사항

NOTE

거래대사 API 안내

거래대사 API는 특정 거래일자에 발생한 모든 거래내역을 조회합니다. 대량의 데이터가 조회될 수 있으므로 주의해주세요.
  • 응답 형식은 파이프(|) 구분자로 구분된 텍스트 형식입니다.
  • 첫 번째 행은 결과코드, 결과메시지, 조회건수를 포함합니다.
  • 조회 성공 시 두 번째 행부터 거래건별 정보가 출력됩니다.

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└mchtIdAN(10)영문+숫자, 최대 10byte*
헥토파이낸셜에서 부여하는 고유 상점아이디
└mchtTyAN(1)영문+숫자, 최대 1byte*
상점아이디 구분
M: 상점ID별조회 G: 그룹ID별조회
└repMchtIdAN(10)영문+숫자, 최대 10byte
대표 상점아이디, mchtTy(상점아이디 구분) 값이 G(그룹아이디)일때 세팅하여 pktHash 생성할 때 repMchtId의 hashKey 사용
└methodAN(2)영문+숫자, 최대 2byte*
결제수단
ALL: 전 결제수단 조회 CA: 신용카드 VA: 가상계좌 RA: 계좌이체 MP: 휴대폰 TM: 티머니 CG: 문화상품권 SG: 스마트문상 BG: 도서문화상품권 HM: 해피머니 TC: 틴캐시 CP: 포인트 다모아 PZ: 간편결제
└pdTyAN(1)영문+숫자, 최대 1byte*
조회기간 구분 코드
*고정값
└trdDtStN(8)숫자, 최대 8byte*
거래일자 (yyyyMMdd)
└ezpIncYNAN(1)영문+숫자, 최대 1byte
거래대사 조회 결과에 간편결제(PZ) 거래를 포함할지 여부
Y: 포함 N 또는 세팅안함: 미포함
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA256 방식으로 생성한 해쉬값
NOTE

해쉬 생성 조합

mchtId + trdDtSt + hashKey

응답 형식

응답은 파이프(|) 구분자로 구분된 텍스트 형식입니다.

조회 결과 (첫 번째 행)

순번항목타입설명
1결과코드AN(4)API 응답 결과 코드
2결과메시지ANAPI 응답 결과 메시지
3조회내역 건수N조회 성공 거래 내역 건수

거래내역 (두 번째 행부터)

조회 성공(result:0000) 시 두 번째 행부터 거래건 별로 출력됩니다.

순번항목타입설명
1상점아이디AN(10)상점아이디
2결제수단N(2)결제수단 코드
3헥토파이낸셜 거래번호AN(40)헥토파이낸셜에서 생성한 거래번호
4주문번호AN(100)상점주문번호
5승인구분AN(1)0: 승인, 1: 취소
6거래일자N(8)거래일자(취소일자) yyyyMMdd
7거래시간N(6)거래시간(취소시간) hhmmss
8거래금액N(13)거래금액
9원거래번호AN(40)취소거래에 대한 원 거래번호
10원거래일자N(8)취소거래에 대한 원 거래일자
11주문자명AN(88)상점 주문자명
12상품명AN(200)상점 상품명
13승인번호AN신용카드 승인번호
14금융사코드AN신용카드: 카드사 코드, 계좌이체/가상계좌: 금융기관 코드, 휴대폰: 통신사 코드, 간편결제: 카드사 코드/간편결제사 코드
15할부개월N(2)신용카드 거래 할부 개월
16무이자할부여부AN(1)가맹점부담 무이자 할부 거래 여부 (신용카드). N: 일반, Y: 무이자할부거래
17간편결제사 코드AN(3)결제수단이 간편결제(PZ)인데 금융사 코드가 카드사인 경우에 간편결제사를 판별하기 위한 값
18상품 코드AN(3)복합결제 시 주결제수단과 보조결제수단을 판별하기 위한 값
19복합결제거래번호AN(40)복합결제에 대한 원 거래번호

응답 예시

정상 처리 응답

0000|정상 처리 되었습니다.|6|
nxca_jt_il|CA|STFP_PGCAnxca_jt_il0260720100000M1000001|ORDER20260720100001|0|20260720|100000|10000|||홍길동|테스트상품|99100001|02|00|N|
nxca_jt_il|CA|STFP_PGCAnxca_jt_il0260720103000M1000002|ORDER20260720100002|0|20260720|103000|30000|||김철수|테스트상품2|99100002|05|03|Y|
nxca_jt_il|CA|STFP_PGCAnxca_jt_il0260720110000M1000003|ORDER20260720100001|1|20260720|110000|10000|STFP_PGCAnxca_jt_il0260720100000M1000001|20260720|홍길동|테스트상품|99100001|02|00|N|
nxca_jt_il|PZ|STFP_PGPZnxca_jt_il0260720120000M1000004|ORDER20260720100004|0|20260720|120000|5000||||테스트상품3|||00|N|
nxca_jt_il|PZ|STFP_PGPZnxca_jt_il0260720130000M1000005|ORDER20260720100004|1|20260720|130000|5000|STFP_PGPZnxca_jt_il0260720120000M1000004|20260720||테스트상품3|||00|N|
nxca_jt_il|CA|STFP_PGCAnxca_jt_il0260720140000M1000006|ORDER20260720100006|0|20260720|140000|20000|||이영희|테스트상품|99100006|11|00|N|

실패 응답

ST92|해쉬 값 불일치.|0|

결과 코드

코드설명
0000정상 처리 되었습니다.
1001조회내역 없음
ST09유효하지 않은 요청전문
ST10내부 시스템 에러
ST90등록되지 않은 상점 아이디
ST91필수 파라미터 오류
ST92해쉬 값 불일치

카드사 코드 (매입사 코드)

코드카드사명
01BC
02국민
03하나
04삼성
05신한
08현대
09롯데
11우리
15NH

금융기관 코드

코드금융기관명
002산업은행
003기업은행
004국민은행
007수협은행/수협중앙회
011농협은행
012농협중앙회
020우리은행
023SC제일은행
027한국씨티은행
031대구은행
032부산은행
034광주은행
035제주은행
037전북은행
039경남은행
045새마을금고중앙회
048신협중앙회
050상호저축은행
054HSBC은행
055도이치은행
057제이피모간체이스은행
060BOA은행
062중국공상은행
064산림조합중앙회
071우체국
081KEB하나은행
088신한은행
089K뱅크
090카카오뱅크
092토스뱅크
103SBI저축은행
209유안타증권
218KB증권
238미래에셋대우
240삼성증권
243한국투자증권
247NH투자증권
261교보증권
262하이투자증권
263현대차투자증권
264키움증권
265이베스트투자증권
266SK증권
267대신증권
269한화투자증권
270하나금융투자
278신한금융투자
279동부증권
280유진투자증권
287메리츠종합금융증권
290부국증권
291신영증권
292케이프투자증권

결제수단 코드

코드결제수단
CA신용카드
VA가상계좌
RA계좌이체
MP휴대폰
TM티머니
CG문화상품권
SG스마트문상
BG도서문화상품권
HM해피머니
TC틴캐시
CP포인트 다모아
PZ간편결제

통신사 코드

코드통신사명
SKTSK Telecom
KTFKT
LGTLG U+
SKLSK 7 Mobile
CJHCJ 헬로모바일
KCT한국케이블텔레콤

간편결제사 코드

코드간편결제사명
KKP카카오페이
NVP네이버페이
PAC페이코
TOS토스페이

상품 코드

코드상품명
CAP신용카드
KKM카카오머니
PNT포인트
COU페이코쿠폰
TSM토스머니
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?