가상계좌 채번정보 변경 API
발급된 가상계좌의 입금만료일시, 거래금액을 변경하는 API입니다.
테스트용 키 정보
API 정보
POST/spay/APIVBank.do
Content-Type
application/json테스트
https://tbgw.settlebank.co.kr/spay/APIVBank.do운영
https://gw.settlebank.co.kr/spay/APIVBank.do주의 사항
NOTE
채번정보 변경 안내
이미 발급된 가상계좌의 입금만료일시와 거래금액을 변경할 수 있습니다.
- 회전식, 고정식, 고정무제한 모든 유형의 가상계좌에서 사용 가능합니다.
- 입금만료일시의 최대기한은 회전식·고정식의 경우 현재일 기준 +365일 23:59:59, 고정식 무제한(acntType=3)의 경우 무제한으로 설정 가능합니다.
- 변경 전 발급받았던 가상계좌번호와 은행코드를 정확히 입력해야 합니다.
- 입금만료일이 이미 경과한 가상계좌는 채번정보 변경이 불가능합니다. 이 경우 새로 채번해야 합니다.
요청 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
params 객체
└mchtIdAN(10)영문+숫자, 최대 10byte*헥토파이낸셜에서 부여하는 고유 상점아이디
헥토파이낸셜에서 부여하는 고유 상점아이디
nx_mid_il: 회전식 테스트 nxva_fix: 고정식 테스트 nxva_fix2: 고정무제한 테스트└verAN(4)영문+숫자, 최대 4byte*전문의 버전
전문의 버전
*고정값
└methodA(2)영문, 최대 2byte*결제수단
결제수단
*고정값 (VA: 가상계좌)
└bizTypeAN(2)영문+숫자, 최대 2byte*업무 구분코드
업무 구분코드
*고정값 (A1: 채번정보변경)
└encCdN(2)숫자, 최대 2byte*암호화 구분 코드
암호화 구분 코드
*고정값
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점에서 생성하는 고유한 주문번호
상점에서 생성하는 고유한 주문번호
└trdDtN(8)숫자, 최대 8byte*요청일자 (YYYYMMDD)
요청일자 (YYYYMMDD)
└trdTmN(6)숫자, 최대 6byte*요청시간 (HHMMSS)
요청시간 (HHMMSS)
└mobileYnA(1)영문, 최대 1byte모바일 여부
모바일 여부
Y: 모바일웹/앱 N: PC 또는 그 외└osTypeA(1)영문, 최대 1byteOS 구분
OS 구분
A: Android I: iOS W: Windows M: Mac E: 기타data 객체
└pktHashAN(64)영문+숫자, 최대 64byte*
SHA-256SHA256 방식으로 생성한 해쉬값(실시간 생성)SHA256 방식으로 생성한 해쉬값
NOTE
해쉬 생성 조합
trdDt + trdTm + mchtId + mchtTrdNo + trdAmt(평문) + hashKey
└vAcntNoN(16)숫자, 최대 16byte*
AES-256AES-256/ECB/PKCS5Padding + Base64발급받았던 가상계좌번호발급받았던 가상계좌번호
└expireDateN(14)숫자, 최대 14byte*변경할 입금만료일시 (yyyyMMddHHmmss)
변경할 입금만료일시 (yyyyMMddHHmmss)
*회전식·고정식은 현재일 기준 최대 +365일 23:59:59까지 설정 가능. 고정식 무제한(acntType=3)은 무제한 설정 가능
└trdAmtN(12)숫자, 최대 12byte*
AES-256AES-256/ECB/PKCS5Padding + Base64거래금액거래금액
└acntTypeN(1)숫자, 최대 1byte*가상계좌 구분
가상계좌 구분
1: 회전식 2: 고정식 3: 고정무제한응답 파라미터
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
params 객체
└mchtIdAN(10)영문+숫자, 최대 10byte*상점아이디
nx_mid_il상점아이디
└verAN(4)영문+숫자, 최대 4byte*전문의 버전
0A19전문의 버전
└methodA(2)영문, 최대 2byte*결제수단
VA결제수단
└bizTypeAN(2)영문+숫자, 최대 2byte*업무 구분코드
A1업무 구분코드
└encCdN(2)숫자, 최대 2byte*암호화 구분 코드
23암호화 구분 코드
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점주문번호
ORDER20211231100000상점주문번호
└trdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜 거래번호
STBK_0123456789헥토파이낸셜 거래번호
└trdDtN(8)숫자, 최대 8byte*요청일자 (YYYYMMDD)
20211231요청일자 (YYYYMMDD)
└trdTmN(6)숫자, 최대 6byte*요청시간 (HHMMSS)
120000요청시간 (HHMMSS)
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태코드 (성공/실패)
0021거래상태코드 (성공/실패)
0021: 성공 0031: 실패└outRsltCdAN(4)영문+숫자, 최대 4byte*결과코드
0000결과코드
└outRsltMsgAHN(200)영문+한글+숫자, 최대 200byte*결과메시지
정상적으로 처리되었습니다.결과메시지
data 객체
└pktHashAN(64)영문+숫자, 최대 64byte*요청시 hash 값 그대로 return
f395b6725a9a18...요청시 hash 값 그대로 return
└bankCdAN(3)영문+숫자, 최대 3byte*은행코드 (요청시 값 그대로 return)
011은행코드 (요청시 값 그대로 return)
└vAcntNoN(16)숫자, 최대 16byte*
AES-256AES-256/ECB/PKCS5Padding가상계좌번호 (요청시 값 그대로 return)1234567890가상계좌번호 (요청시 값 그대로 return)
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└expireDateN(14)숫자, 최대 14byte*입금만료일시 (요청시 값 그대로 return)
20221231235959입금만료일시 (요청시 값 그대로 return)
└trdAmtN(12)숫자, 최대 12byte*
AES-256AES-256/ECB/PKCS5Padding거래금액 (요청시 값 그대로 return)1000거래금액 (요청시 값 그대로 return)
*실제 응답값은 AES-256 암호화된 값입니다. 복호화 후 사용하세요.
└acntTypeN(1)숫자, 최대 1byte*가상계좌 구분 (요청시 값 그대로 return)
1가상계좌 구분 (요청시 값 그대로 return)
