계좌 등록 API
고객의 출금 계좌를 등록하거나 해지하는 기능을 제공합니다.
계좌 등록 (출금이체 등록)
ARS 인증 또는 기타 인증 수단(PASS, 서면 등)을 통해 획득한 거래번호로 출금이체 등록을 요청합니다.
API 정보
POST/v1/api/acnt/reg
Content-Type
application/json; charset=UTF-8테스트
https://tbnpay.settlebank.co.kr/v1/api/acnt/reg운영
https://npay.settlebank.co.kr/v1/api/acnt/reg요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*전문정보 코드
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*상점아이디
상점아이디
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점 주문번호 (한글 제외)
상점 주문번호 (한글 제외)
└trdNoAN(50)영문+숫자, 최대 50byte거래번호 (인증 확인 시 발급받은 거래번호)
거래번호 (인증 확인 시 발급받은 거래번호)
*authMthdCd가 ARS인 경우 필수
└mchtCustIdAN(100)영문+숫자, 최대 100byte*
AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)고객아이디고객아이디
└reqDtAN(8)영문+숫자, 최대 8byte*요청일자 (yyyyMMdd)
요청일자 (yyyyMMdd)
└reqTmAN(6)영문+숫자, 최대 6byte*요청시간 (HH24MISS)
요청시간 (HH24MISS)
└mchtCustNmAN(60)영문+숫자, 최대 60byte*
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자리)
└authMthdCdAN(5)영문+숫자, 최대 5byte인증구분코드 (ARS, WR, PASS)
인증구분코드 (ARS, WR, PASS)
ARS: ARS인증 WR: 서면 PASS: PASS인증└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계좌번호키 (출금이체 등록된 계좌의 식별키)
└svcDivCdN(1)숫자, 최대 1byte*계좌등록서비스구분
1계좌등록서비스구분
1: 펌뱅킹└mchtTrdNoAN(100)영문+숫자, 최대 100byte상점 주문번호
OID201902210001상점 주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*거래번호
STFP_FIRM12345678901234567890거래번호
└payerNoAN(20)영문+숫자, 최대 20byte*납부자번호
TESTMCHT00000001납부자번호
요청 예시
{
"hdInfo": "SPAY_RE0W_1.0",
"mchtId": "midtest",
"mchtTrdNo": "T2026022100001",
"mchtCustId": "AES암호화된고객아이디",
"trdNo": "STFP_FIRM12345678901234567890",
"reqDt": "20260211",
"reqTm": "095000",
"mchtCustNm": "AES암호화된예금주명",
"uii": "AES암호화된생년월일",
"bankCd": "004",
"custAcntNo": "AES암호화된계좌번호",
"authMthdCd": "ARS",
"pktHash": "해시값"
}
응답 예시
{
"outStatCd": "0021",
"outRsltCd": "0000",
"outRsltMsg": "정상처리되었습니다.",
"mchtCustId": "AES암호화된고객아이디",
"bankCd": "004",
"custAcntNo": "234*******123",
"custAcntKey": "d894kjd93kd9",
"svcDivCd": "1",
"mchtTrdNo": "T2026022100001",
"trdNo": "STFP_FIRM12345678901234567890",
"payerNo": "TESTMCHT00000001"
}
