예금주성명조회Ⅰ (생년월일 미포함) API

입력받은 예금주명과 은행에서 조회된 예금주명의 일치 여부를 확인합니다. 예금주명 미입력 시 은행에서 조회된 예금주명을 반환합니다.


API 정보

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

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
hdInfoAN(50)영문+숫자, 최대 50byte*
전문정보 코드
*고정값
mchtIdAN(8)영문+숫자, 최대 8byte*
상점아이디
mchtTrdNoAN(100)영문+숫자, 최대 100byte
상점 주문번호 (한글 제외)
mchtCustIdAN(100)영문+숫자, 최대 100byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
고객아이디
reqDtAN(8)영문+숫자, 최대 8byte*
요청일자 (yyyyMMdd)
reqTmAN(6)영문+숫자, 최대 6byte*
요청시간 (HH24MISS)
bankCdAN(3)영문+숫자, 최대 3byte*
은행코드
custAcntNoAN(15)영문+숫자, 최대 15byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
계좌번호 (하이픈 제외)
mchtCustNmAN(30)영문+숫자, 최대 30byteAES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
예금주명 (한글 3byte)
acctNoChkYnAN(1)영문+숫자, 최대 1byte
등록불가계좌 확인 여부
Y N
custIpAN(15)영문+숫자, 최대 15byte
고객 IP 주소
pktHashAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA-256 해쉬값
NOTE

해쉬 생성 조합

mchtId + mchtCustId + reqDt + reqTm + custAcntNo + hashKey

응답 파라미터

outStatCdAN(4)영문+숫자, 최대 4byte*0021
거래상태코드
0021: 성공 0031: 실패
outRsltCdAN(4)영문+숫자, 최대 4byte*0000
거절코드
outRsltMsgAN(300)영문+숫자, 최대 300byte*정상처리되었습니다.
결과메시지
mchtTrdNoAN(100)영문+숫자, 최대 100byteOID201902210001
상점 주문번호
trdNoAN(40)영문+숫자, 최대 40byte*STFP_FIRM12345678901234567890
거래번호
mchtCustNmAN(30)영문+숫자, 최대 30byteAES-256AES-256/ECB/PKCS5Padding김헥토
은행에서 조회된 예금주명 (한글 3byte)
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?