계좌점유인증 확인 API

고객이 확인한 인증번호를 검증하는 단계입니다.


계좌점유인증 확인 (분리형 Step 2)

고객이 확인한 인증번호를 검증하는 단계입니다.

API 정보

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

요청 파라미터

hdInfoAN(50)영문+숫자, 최대 50byte*
전문정보 코드
*고정값
mchtIdAN(8)영문+숫자, 최대 8byte*
상점아이디
mchtTrdNoAN(100)영문+숫자, 최대 100byte*
가맹점 거래번호 (요청 시 전달한 값)
mchtCustIdAN(100)영문+숫자, 최대 100byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
고객아이디
reqDtAN(8)영문+숫자, 최대 8byte*
요청일자
reqTmAN(6)영문+숫자, 최대 6byte*
요청시간
authNoAN(12)영문+숫자, 최대 12byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
인증번호 (보내는사람 정보 제외)
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*성공
결과메시지
mchtCustIdAN(100)영문+숫자, 최대 100byte*AES-256AES-256/ECB/PKCS5Paddingkimhecto
고객아이디
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
trdNoAN(40)영문+숫자, 최대 40byte*STFP_FIRM12345678901234567890
거래번호
mchtTrdNoAN(100)영문+숫자, 최대 100byte*OID201902210001
가맹점 거래번호
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?