가맹점 자체 계좌 등록 API
가맹점이 자체적으로 수집한 계좌 정보를 등록합니다. 오픈뱅킹 계좌등록 항목을 포함합니다.
가맹점 자체 계좌 등록
가맹점이 자체적으로 획득한 출금 동의 정보를 바탕으로 계좌를 등록합니다.
API 정보
POST/v1/api/acnt/reg/self
Content-Type
application/json; charset=UTF-8테스트
https://tbnpay.settlebank.co.kr/v1/api/acnt/reg/self운영
https://npay.settlebank.co.kr/v1/api/acnt/reg/self요청 파라미터
└hdInfoAN(50)영문+숫자, 최대 50byte*전문정보 코드
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*상점아이디
상점아이디
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점 주문번호
상점 주문번호
└payerNoAN(20)영문+숫자, 최대 20byte*납부자번호
납부자번호
└mchtCustIdAN(100)영문+숫자, 최대 100byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)고객아이디고객아이디
└reqDtAN(8)영문+숫자, 최대 8byte*요청일자
요청일자
└reqTmAN(6)영문+숫자, 최대 6byte*요청시간
요청시간
└mchtCustNmAN(30)영문+숫자, 최대 30byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)예금주명 (한글 3byte)예금주명 (한글 3byte)
└uiiAN(10)영문+숫자, 최대 10byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)생년월일(yyMMdd) 또는 사업자번호(10자리)생년월일(yyMMdd) 또는 사업자번호(10자리)
*사업자번호는 하이픈 제외
└bankCdAN(3)영문+숫자, 최대 3byte*은행코드
은행코드
└custAcntNoAN(15)영문+숫자, 최대 15byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)계좌번호 (하이픈 제외, 최소 9자리~최대 15자리)계좌번호 (하이픈 제외, 최소 9자리~최대 15자리)
└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거절코드
*ST08: 이미 등록된 계좌일 경우 등록된 계좌 정보 전달
└outRsltMsgAN(300)영문+숫자, 최대 300byte*결과메시지
정상처리되었습니다.결과메시지
└mchtCustIdAN(100)영문+숫자, 최대 100byte*
AES-256AES-256/ECB/PKCS5Padding고객아이디kimhecto고객아이디
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└bankCdAN(3)영문+숫자, 최대 3byte*은행코드
004은행코드
└custAcntNoAN(15)영문+숫자, 최대 15byte*계좌번호 (마스킹 처리)
234*******123계좌번호 (마스킹 처리)
└custAcntKeyAN(50)영문+숫자, 최대 50byte계좌번호키
d894kjd93kd9계좌번호키
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점 주문번호
OID201902210001상점 주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*거래번호
STFP_FIRM12345678901234567890거래번호
