헥토파이낸셜 개발자센터

정산대사 API

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

테스트용 키 정보

API 정보

POST/api/pg/{상점아이디}/sttlmntInfo.do
Content-Typeapplication/x-www-form-urlencoded
테스트https://tb-nspay.settlebank.co.kr/api/pg/{상점아이디}/sttlmntInfo.do
운영https://nspay.settlebank.co.kr/api/pg/{상점아이디}/sttlmntInfo.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: 도서문화상품권 TC: 틴캐시 CP: 포인트 다모아 PZ: 간편결제
└crtrDtN(8)숫자, 최대 8byte*
정산예정일자 (yyyyMMdd)
└pktHashAN(32)영문+숫자, 최대 32byte*SHA-256(실시간 생성)
SHA256 방식으로 생성한 해쉬값
└ezpIncYNAN(1)영문+숫자, 최대 1byte
정산대사 조회 결과에 간편결제(PZ) 거래를 포함할지 여부
Y: 포함 N 또는 세팅안함: 미포함
└sttlmntTyAN(3)영문+숫자, 최대 3byte
정산구분
ALL: 전체정산 TR: 일반정산 DB: 차액정산 NR: 환급정산
NOTE

해쉬 생성 조합

mchtId + crtrDt + hashKey

응답 형식

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

조회 결과 (첫 번째 행)

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

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

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

순번항목타입설명
1상점아이디AN(10)상점아이디
2헥토파이낸셜 거래번호AN(40)헥토파이낸셜에서 생성한 거래번호
3원거래번호AN(40)취소거래에 대한 원 거래번호
4결제수단AN(2)결제수단 코드
5승인/취소일자N(8)거래일자(취소일자) yyyyMMdd
6승인/취소 여부N(1)0: 승인, 1: 취소
7금융사/통신사코드AN신용카드: 카드사 코드, 계좌이체/가상계좌: 은행 코드, 휴대폰: 통신사 코드, 간편결제: 카드사 코드/간편결제사 코드
8승인번호AN신용카드 승인번호
9할부개월수AN(2)신용카드 거래 할부 개월
10주문번호AN(100)상점주문번호
11주문자명AN(88)상점 주문자명
12상품명AN(200)상점 상품명
13결제금액N결제금액. 차액/환급 정산 건일 경우 0원
14수수료N공급가액
15부가세N부가세
16정산예정금액N정산예정금액
17정산예정일자AN(8)정산예정일자 yyyyMMdd
18간편결제사 코드AN(3)결제수단이 간편결제(PZ)인데 금융사 코드가 카드사인 경우에 간편결제사를 판별하기 위한 값
19상품 코드AN(3)복합결제 시 주결제수단과 보조결제수단을 판별하기 위한 값
20복합결제거래번호AN(40)복합결제에 대한 원 거래번호
21정산구분AN(2)요청전문 정산구분(sttlmntTy) 값 세팅 시 추가 출력. TR: 일반정산, DB: 차액정산, NR: 환급정산

응답 예시

정상 처리 응답

0000|정상 처리 되었습니다.|5|
nxca_jt_il|STFP_PGCAnxca_jt_il0260720100000M2000001|STFP_PGCAnxca_jt_il0260720100000M2000001|CA|20260720|0|05|99200001|00|ORDER20260720100001|홍길동|테스트상품|10000|215|21|9764|20260721||CAP||TR
nxca_jt_il|STFP_PGCAnxca_jt_il0260720110000M2000002|STFP_PGCAnxca_jt_il0260720100000M2000001|CA|20260720|1|05|99200001|00|ORDER20260720100001|홍길동|테스트상품|10000|0|0|10000|20260721||CAP||TR
nxca_jt_il|STFP_PGCAnxca_jt_il0260720120000M2000003|STFP_PGCAnxca_jt_il0260720120000M2000003|CA|20260720|0|02|99200003|03|ORDER20260720100003|김철수|테스트상품2|30000|645|64|29291|20260721||CAP||TR
nxca_jt_il|STFP_PGPZnxca_jt_il0260720130000M2000004|STFP_PGPZnxca_jt_il0260720130000M2000004|PZ|20260720|0|KKP||00|ORDER20260720100004||테스트상품3|1000|0|0|1000|20260721|KKP|KKM||TR
nxca_jt_il|STFP_PGCAnxca_jt_il0260720140000M2000005|STFP_PGCAnxca_jt_il0260720140000M2000005|CA|20260720|0|11|99200005|00|ORDER20260720100005|이영희|테스트상품|20000|430|43|19527|20260721||CAP||TR

실패 응답

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

결과 코드

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

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

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

결제수단 코드

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

통신사 코드

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

금융기관 코드

코드금융기관명
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케이프투자증권

간편결제사 코드

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

상품 코드

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

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?