헥토파이낸셜 개발자센터

계좌점유인증 내역 조회 API

계좌점유인증 내역을 조회할 수 있습니다.

API 정보

POST/v1/api/auth/ownership/translist
Content-Typeapplication/json; charset=UTF-8
테스트https://tbnpay.settlebank.co.kr/v1/api/auth/ownership/translist
운영https://npay.settlebank.co.kr/v1/api/auth/ownership/translist

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*
상점아이디
└orgTrdDtAN(6)영문+숫자, 최대 6byte*
원거래일자
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*
가맹점 거래번호 (인증 요청 시 가맹점 거래번호, 한글 제외)
└trdNoAN(50)영문+숫자, 최대 50byte*
헥토파이낸셜 거래번호 (인증 요청 시 응답받은 거래번호)
└mchtCustIdAN(100)영문+숫자, 최대 100byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
고객아이디
└reqDtAN(8)영문+숫자, 최대 8byte*
요청일자 (yyyyMMdd)
└reqTmAN(6)영문+숫자, 최대 6byte*
요청시간 (HH24MISS)
└custIpAN(15)영문+숫자, 최대 15byte
고객 IP 주소
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA-256 해쉬값
NOTE

해쉬 생성 조합

mchtId + reqDt + reqTm + mchtTrdNo + hashKey

응답 파라미터

└outStatCdAN(4)영문+숫자, 최대 4byte*0021
거래상태코드
0021: 성공 0031: 실패
└outRsltCdAN(4)영문+숫자, 최대 4byte*0000
거절코드
└outRsltMsgAN(300)영문+숫자, 최대 300byte*성공
결과메시지
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*OID20210830000000
가맹점 거래번호
└mchtCustIdAN(100)영문+숫자, 최대 100byteAES-256AES-256/ECB/PKCS5Paddingkimhecto
고객아이디
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└trdNoAN(50)영문+숫자, 최대 50byte*STFP_FIRM123454657890
헥토파이낸셜 거래번호
└bankCdAN(3)영문+숫자, 최대 3byte*004
은행코드
└custAcntNoAN(15)영문+숫자, 최대 15byte*12345********890
계좌번호 (마스킹)
└custAcntSumryAN(21)영문+숫자, 최대 21byte*AES-256AES-256/ECB/PKCS5Padding이베이A12
통장인자내용
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└reqTrdDtmAN(14)영문+숫자, 최대 14byte*20210830000000
인증 요청일시 (yyyyMMddhhmmss)
└chkTrdDtmAN(14)영문+숫자, 최대 14byte*20210830000000
인증 확인일시 (yyyyMMddhhmmss)
└trdStatCdAN(4)영문+숫자, 최대 4byte*0021
인증 거래상태
0021: 성공 0031: 실패
└trdRsltCdAN(4)영문+숫자, 최대 4byte*0000
인증 실패코드
└trdRsltMsgAN(600)영문+숫자, 최대 600byte*성공
인증 결과메시지
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?