헥토파이낸셜 개발자센터

계좌 등록 API

가맹점 서버에서 헥토파이낸셜 서버로 계좌등록을 요청합니다. (펌, 오픈뱅킹 등록처리)

'ARS 인증 확인' API의 결과 값인 거래번호(trdNo)를 사용하여 계좌등록 (출금이체 등록)을 진행 합니다. 등록된 계좌로 추후 결제(출금)을 진행 할수 있습니다.

API 정보

POST/v2/api/acnt/reg
Content-Typeapplication/json
테스트https://tbnpay.settlebank.co.kr/v2/api/acnt/reg
운영https://npay.settlebank.co.kr/v2/api/acnt/reg

요청 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└hdInfoAN(50)영문+숫자, 최대 50byte*
전문정보 코드
*고정값
└mchtIdAN(8)영문+숫자, 최대 8byte*
헥토파이낸셜에서 부여하는 고유 상점아이디
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*
상점 주문번호
*한글제외
└trdNoAN(50)영문+숫자, 최대 50byte
헥토파이낸셜 거래번호
*ARS인증시 리턴받은 거래번호 셋팅. authMthdCd : ARS인경우 필수
└mchtCustIdAN(100)영문+숫자, 최대 100byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
상점에서 보내주는 고유 고객아이디 혹은 Unique 한 Key
└reqDtAN(8)영문+숫자, 최대 8byte*
요청일자
*yyyyMMdd
└reqTmAN(6)영문+숫자, 최대 6byte*
요청시간
*HH24MISS
└mchtCustNmAN(60)영문+숫자, 최대 60byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
예금주명
*영문/숫자/한글 (한글 3byte)
└uiiAN(6)영문+숫자, 최대 6byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
생년월일
*생년월일: yyMMdd. 사업자번호 등록 불가
└bankCdAN(3)영문+숫자, 최대 3byte*
은행코드
*금융기관코드 테이블 참조
└custAcntNoAN(15)영문+숫자, 최대 15byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
계좌번호
*계좌번호 "-" 제외 최소 9, 최대 15
└authMthdCdAN(5)영문+숫자, 최대 5byte
인증구분코드
WR: 서면파일 ARS: ARS인증 PASS: PASS 인증서
*출금이체 동의 자료. 기본값: ARS
└custIpAN(15)영문+숫자, 최대 15byte
고객 IP 주소
*가맹점 서버의 IP가 아닌 고객 기기의 IP 주소
└pktHashAN(200)영문+숫자, 최대 200byte*SHA-256(실시간 생성)
SHA256 방식으로 생성한 해쉬값
*상점아이디 + 고객아이디(평문) + 요청일자 + 요청시간 + 계좌번호(평문) + 인증키
└sexDivCdAN(1)영문+숫자, 최대 1byte*
성별구분코드
*주민등록번호 뒷자리 첫번째 숫자
└ciAN(88)영문+숫자, 최대 88byte*
고객 CI
└emailAN(100)영문+숫자, 최대 100byte
고객 이메일

요청 전문 해쉬 코드

항목조합 필드
pktHash 값상점아이디 + 고객아이디(평문) + 요청일자 + 요청시간 + 계좌번호(평문) + 인증키

응답 파라미터

타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자
예: AN(10) = 영문+숫자, 최대 10byte
└outStatCdAN(4)영문+숫자, 최대 4byte*
거래상태코드 (성공/실패)
0021: 성공 0031: 실패
└outRsltCdAN(4)영문+숫자, 최대 4byte*
거절코드
*거절코드 테이블 참조. ST08: 이미 등록된 계좌일 경우 등록된 계좌 정보 전달
└outRsltMsgAN(300)영문+숫자, 최대 300byte*정상처리되었습니다.
결과메시지
*오류가 발생시 오류에 대한 메시지 전달
└mchtCustIdAN(100)영문+숫자, 최대 100byte*AES-256AES-256/ECB/PKCS5Paddingkimhecto
상점에서 보내주는 고유 고객아이디 혹은 Unique 한 Key
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└bankCdAN(3)영문+숫자, 최대 3byte*004
3자리 은행코드
└custAcntNoAN(15)영문+숫자, 최대 15byte*234*******123
계좌번호 마스킹 처리
└custAcntKeyAN(50)영문+숫자, 최대 50byte*d894kjd93kd9
출금이체등록된 계좌의 일련번호
└svcDivCdN(4)숫자, 최대 4byte*
출금이체 등록 된 서비스
1: 펌뱅킹 2: 오픈뱅킹 3: 펌뱅킹, 오픈뱅킹
└mchtTrdNoAN(100)영문+숫자, 최대 100byteOID201902210001
상점 주문번호
*한글제외
└trdNoAN(40)영문+숫자, 최대 40byte*STFP_FIRM12345678901234567890
헥토파이낸셜 거래번호
└obPayerNoAN(30)영문+숫자, 최대 30byte20220630123456789012
오픈뱅킹 납부자번호
*오픈뱅킹으로 등록된 고객 납부자번호
└fintechUseNoAN(24)영문+숫자, 최대 24byte123456789012345678901234
핀테크이용번호
*오픈뱅킹 사용자 계좌 식별번호
└userSeqNoAN(10)영문+숫자, 최대 10byte1234567890
사용자일련번호
*오픈뱅킹 사용자 식별번호
└obRsltCdAN(4)영문+숫자, 최대 4byte
오픈뱅킹 계좌등록 결과
*거절코드 테이블 참조

요청 예시

{
  "hdInfo": "SPAY_RE0W_1.0",
  "mchtId": "midtest",
  "mchtTrdNo": "OID201902210001",
  "trdNo": "T2019022100001",
  "mchtCustId": "AES암호화된고객아이디",
  "reqDt": "20191231",
  "reqTm": "120000",
  "mchtCustNm": "AES암호화된예금주명",
  "uii": "AES암호화된생년월일",
  "bankCd": "004",
  "custAcntNo": "AES암호화된계좌번호",
  "authMthdCd": "ARS",
  "custIp": "127.0.0.1",
  "pktHash": "해시값",
  "sexDivCd": "1",
  "ci": "고객CI값",
  "email": "customer@example.com"
}

응답 예시

{
  "outStatCd": "0021",
  "outRsltCd": "0000",
  "outRsltMsg": "정상처리되었습니다.",
  "mchtCustId": "AES암호화된고객아이디",
  "bankCd": "004",
  "custAcntNo": "234*******123",
  "custAcntKey": "d894kjd93kd9",
  "svcDivCd": "2",
  "mchtTrdNo": "OID201902210001",
  "trdNo": "STFP_FIRM12345678901234567890",
  "obPayerNo": "20220630123456789012",
  "fintechUseNo": "123456789012345678901234",
  "userSeqNo": "1234567890",
  "obRsltCd": "0000"
}
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?