계좌점유인증 요청 API
1원 입금을 요청하는 단계입니다. 인증번호 유형을 선택하여 발송할 수 있습니다.
계좌점유인증 요청 (분리형 Step 1)
1원 입금을 요청하는 단계입니다. 인증번호 유형을 선택하여 발송할 수 있습니다.
API 정보
POST/v1/api/auth/ownership/req
Content-Type
application/json; charset=UTF-8테스트
https://tbnpay.settlebank.co.kr/v1/api/auth/ownership/req운영
https://npay.settlebank.co.kr/v1/api/auth/ownership/req요청 파라미터
└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)
└mchtCustNmAN(20)영문+숫자, 최대 20byte
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)통장예금주명 (한글 3byte)통장예금주명 (한글 3byte)
└bankCdAN(3)영문+숫자, 최대 3byte*은행코드
은행코드
└custAcntNoAN(15)영문+숫자, 최대 15byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)계좌번호 (하이픈 제외)계좌번호 (하이픈 제외)
└authTypeAN(1)영문+숫자, 최대 1byte*인증번호 유형
인증번호 유형
1: 숫자 3자리 2: 영문대문자+숫자 2자리 3: 한글단어조합 4글자 4: 숫자 4자리└remitterNmAN(8)영문+숫자, 최대 8byte
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)보낸사람 정보 (송금인명칭) - 문구의 앞/뒤에 인증번호 조합 (한글 2byte)보낸사람 정보 (송금인명칭) - 문구의 앞/뒤에 인증번호 조합 (한글 2byte)
*인증번호유형이 '3'이고 인증번호생성주체가 자동생성이면 무시됨. 인증번호유형이 '4'이면 최대 3글자 지원
└textPosAN(1)영문+숫자, 최대 1byte보낸사람 정보(송금인명칭) 위치
보낸사람 정보(송금인명칭) 위치
F: 전위 R: 후위└authVldTmN(5)숫자, 최대 5byte인증 유효시간 (초)
인증 유효시간 (초)
*계좌점유인증 요청 성공 응답시 거래번호 발생 기준으로 인증 유효시간 지정
└apintTmN(5)숫자, 최대 5byte반복 요청 방지시간 (초)
반복 요청 방지시간 (초)
*지정된 시간 내 반복 요청 시 1원 입금을 진행하지 않고 처리중으로 응답
└custIpAN(15)영문+숫자, 최대 15byte고객 IP 주소
고객 IP 주소
└pktHashAN(200)영문+숫자, 최대 200byte*
SHA-256SHA-256 해쉬값(실시간 생성)SHA-256 해쉬값
NOTE
해쉬 생성 조합
mchtId + reqDt + reqTm + bankCd + custAcntNo + hashKey
응답 파라미터
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드
0021거래상태코드
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*거절코드
0000거절코드
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리되었습니다.결과메시지
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*가맹점 거래번호
OID201902210001가맹점 거래번호
└trdNoAN(40)영문+숫자, 최대 40byte*거래번호
STFP_FIRM12345678901234567890거래번호
└mchtCustIdAN(100)영문+숫자, 최대 100byte*
AES-256AES-256/ECB/PKCS5Padding고객아이디kimhecto고객아이디
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└bankChkYnAN(1)영문+숫자, 최대 1byte*은행점검여부
N은행점검여부
Y: 점검중 N: 정상└stDtmAN(14)영문+숫자, 최대 14byte점검시작일시 (yyyyMMddhhmmss)
20200729000900점검시작일시 (yyyyMMddhhmmss)
└edDtmAN(14)영문+숫자, 최대 14byte점검종료일시 (yyyyMMddhhmmss)
20200729001000점검종료일시 (yyyyMMddhhmmss)
