계좌 점유 인증 API
고객이 실제 계좌를 점유하고 있는지 확인하기 위해 계좌에 1원을 송금하고, 입금 내역의 적요(통장인자내용)를 인증번호로 사용하여 검증하는 서비스입니다.
두 가지 방식이 제공됩니다:
- 계좌점유인증 (단일): 요청 시 설정된 인자내용으로 입금 후, 고객이 확인하여 입력하는 방식 (통합 프로세스용)
- 계좌점유인증 (분리): [요청] 단계에서 입금 실행 후, [확인] 단계에서 인증번호를 검증하는 방식
※ 부정사용 방지를 위해 계좌번호당 1일 5회로 제한됩니다.
계좌점유인증 (단일)
계좌에 1원을 입금하여 점유 여부를 확인합니다.
API 정보
POST/v1/api/auth/acnt/ownership
Content-Type
application/json; charset=UTF-8테스트
https://tbnpay.settlebank.co.kr/v1/api/auth/acnt/ownership운영
https://npay.settlebank.co.kr/v1/api/auth/acnt/ownership요청 파라미터
타입 표기법
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)
요청일자 (yyyyMMdd)
└reqTmAN(6)영문+숫자, 최대 6byte*요청시간 (HH24MISS)
요청시간 (HH24MISS)
└bankCdAN(3)영문+숫자, 최대 3byte*은행코드
은행코드
└custAcntNoAN(15)영문+숫자, 최대 15byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)계좌번호 (하이픈 제외)계좌번호 (하이픈 제외)
└custAcntSumryAN(12)영문+숫자, 최대 12byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)통장인자내용 (한글 2byte)통장인자내용 (한글 2byte)
└custIpAN(15)영문+숫자, 최대 15byte고객 IP 주소
고객 IP 주소
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-256 해쉬값(실시간 생성)SHA-256 해쉬값
NOTE
해쉬 생성 조합
mchtId + mchtCustId + reqDt + reqTm + custAcntNo + hashKey
응답 파라미터
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드
0021거래상태코드
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드
0000거절코드
└outRsltMsgAN(100)영문+숫자, 최대 100byte*결과메시지
정상처리되었습니다.결과메시지
└mchtTrdNoAN(100)영문+숫자, 최대 100byte상점 주문번호
OID201902210001상점 주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*거래번호
STFP_FIRM12345678901234567890거래번호
