헥토파이낸셜 개발자센터

오픈뱅킹 계좌등록 API

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

기존 펌뱅킹 시스템으로 출금이체 등록된 고객들에게서 오픈뱅킹 추가 등록 약관 동의후 오픈뱅킹 계좌등록 API를 추가로 호출이 필요하며, 최초 계좌 등록인경우에는 등록전문을 사용하여 복수 등록처리 요청할 수 있다.

API 정보

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

요청 파라미터

타입 표기법
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)
상점에서 보내주는 고유 고객아이디 혹은 Unique 한 Key
└reqDtN(8)숫자, 최대 8byte*
요청일자
*yyyyMMdd
└reqTmN(6)숫자, 최대 6byte*
요청시간
*HH24MISS
└mchtCustNmAN(10)영문+숫자, 최대 10byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
예금주명
*영문/숫자/한글 (한글 3byte)
└uiiN(6)숫자, 최대 6byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
생년월일
*생년월일: yyMMdd. 사업자번호 등록 불가
└bankCdN(3)숫자, 최대 3byte*
은행코드
*금융기관코드 테이블 참조
└custAcntNoAN(15)영문+숫자, 최대 15byte*AES-256AES-256/ECB/PKCS5Padding + Base64 (Standard)
계좌번호
*계좌번호 "-" 제외 최소 9, 최대 15
└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(200)영문+숫자, 최대 200byte*정상처리되었습니다.
결과메시지
*오류가 발생시 오류에 대한 메시지 전달
└mchtCustIdAN(100)영문+숫자, 최대 100byte*AES-256AES-256/ECB/PKCS5Paddingkimhecto
상점에서 보내주는 고유 고객아이디 혹은 Unique 한 Key
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└bankCdN(3)숫자, 최대 3byte*004
3자리 은행코드
└custAcntNoAN(15)영문+숫자, 최대 15byte*234*******123
계좌번호 마스킹 처리
└svcDivCdN(4)숫자, 최대 4byte*
출금이체 등록 된 서비스
1: 펌뱅킹 2: 오픈뱅킹 3: 펌뱅킹, 오픈뱅킹
└mchtTrdNoAN(100)영문+숫자, 최대 100byteOID201902210001
상점 주문번호
*한글제외
└trdNoAN(50)영문+숫자, 최대 50byte*STFP_FIRM12345678901234567890
헥토파이낸셜 거래번호
└obPayerNoAN(30)영문+숫자, 최대 30byte20220630123456789012
오픈뱅킹 납부자번호
*오픈뱅킹으로 등록된 고객 납부자번호
└fintechUseNoAN(24)영문+숫자, 최대 24byte123456789012345678901234
핀테크이용번호
*오픈뱅킹 사용자 계좌 식별번호
└userSeqNoAN(10)영문+숫자, 최대 10byte1234567890
사용자일련번호
*오픈뱅킹 사용자 식별번호

요청 예시

{
  "hdInfo": "SPAY_OR0W_1.0",
  "mchtId": "midtest",
  "mchtTrdNo": "OID201902210001",
  "mchtCustId": "AES암호화된고객아이디",
  "reqDt": "20191231",
  "reqTm": "120000",
  "mchtCustNm": "AES암호화된예금주명",
  "uii": "AES암호화된생년월일",
  "bankCd": "004",
  "custAcntNo": "AES암호화된계좌번호",
  "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",
  "svcDivCd": "2",
  "mchtTrdNo": "OID201902210001",
  "trdNo": "STFP_FIRM12345678901234567890",
  "obPayerNo": "20220630123456789012",
  "fintechUseNo": "123456789012345678901234",
  "userSeqNo": "1234567890"
}
❓

더 궁금한 내용이 있나요?

FAQ
💬

기술지원이 필요한가요?