010가상계좌 노티
고객이 010 가상계좌에 입금하면 헥토파이낸셜에서 가맹점으로 입금 결과를 통보합니다.
주의 사항
NOTE
노티 처리 권장사항
결제 관련 DB 처리는 반드시 notiUrl에서 처리해야 합니다. nextUrl은 화면 처리 용도로만 사용하세요.
- 노티는
notiUrl로 POST 방식으로 전달됩니다. - 노티 수신 후 응답이 없거나
FAIL이 아닌 경우 재전송됩니다. - 가맹점 서버의 방화벽에서 헥토파이낸셜 노티 서버 IP를 허용해야 합니다.
노티 개요
010가상계좌 거래는 채번 노티와 입금 노티 총 2번의 노티가 전달됩니다.
| 노티 종류 | outStatCd | bizType | 설명 |
|---|---|---|---|
| 채번 노티 | 0051 | A4 | 가상계좌번호 발급 시점에 전달 |
| 입금 노티 | 0021 | B1 | 고객이 입금하는 시점에 전달 |
노티 파라미터 (헥토파이낸셜 → 가맹점)
타입 표기법
N숫자A영문H한글AN영문+숫자AHN영문+한글+숫자예: AN(10) = 영문+숫자, 최대 10byte
└outStatCdAN(4)영문+숫자, 최대 4byte*거래상태
0021거래상태
0021: 성공(입금완료) 0051: 가상계좌 입금대기중(채번완료)└trdNoAN(40)영문+숫자, 최대 40byte*헥토파이낸셜에서 부여하는 고유 거래번호
STBK0123456789헥토파이낸셜에서 부여하는 고유 거래번호
└methodA(2)영문, 최대 2byte*결제수단
VA결제수단
VA: 가상계좌└bizTypeAN(2)영문+숫자, 최대 2byte*업무구분
B1업무구분
A4: 채번 A2: 채번취소 B1: 입금통보 C0: 환불└mchtIdAN(10)영문+숫자, 최대 10byte*상점아이디
nxva_sb_il상점아이디
└mchtTrdNoAN(100)영문+숫자, 최대 100byte*상점주문번호
ORDER20211231100000상점주문번호
└mchtCustNmAHN(30)영문+한글+숫자, 최대 30byte고객명
홍길동고객명
└mchtNameAHN(20)영문+한글+숫자, 최대 20byte상점한글명
헥토파이낸셜상점한글명
└pmtprdNmAHN(128)영문+한글+숫자, 최대 128byte상품명
테스트상품상품명
└trdDtmN(14)숫자, 최대 14byte*거래일시 (yyyyMMddHHmmss)
20211231010101거래일시 (yyyyMMddHHmmss)
└trdAmtN(9)숫자, 최대 9byte거래금액
1000거래금액
└bankCdAN(10)영문+숫자, 최대 10byte은행코드
089은행코드
└bankNmAHN(10)영문+한글+숫자, 최대 10byte은행명
K뱅크은행명
└vAcntNoN(64)숫자, 최대 64byte가상계좌번호
01012345678가상계좌번호
└expireDtN(14)숫자, 최대 14byte가상계좌 입금만료일시
20211231235959가상계좌 입금만료일시
└AcntPrintNmAHN(12)영문+한글+숫자, 최대 12byte통장인자명
010가상계좌통장인자명
*B2C: '010가상계좌' 고정, B2B: '010_고객명'
└dpstrNmAHN(30)영문+한글+숫자, 최대 30byte입금자명 (실제 입금한 사람의 이름)
홍길동입금자명 (실제 입금한 사람의 이름)
└emailAN(60)영문+숫자, 최대 60byte고객이메일
HongGilDong@example.com고객이메일
└mchtCustIdAN(50)영문+숫자, 최대 50byte상점고객아이디
HongGilDong상점고객아이디
└orgTrdNoAN(40)영문+숫자, 최대 40byte원거래번호 (부분취소 시)
STBK0123456789원거래번호 (부분취소 시)
└orgTrdDtN(8)숫자, 최대 8byte원거래일자 (부분취소 시)
20211231원거래일자 (부분취소 시)
└csrcIssNoN(9)숫자, 최대 9byte현금영수증 승인번호
0123456789현금영수증 승인번호
└cnclTypeN(2)숫자, 최대 2byte취소거래타입
00취소거래타입
00: 전체취소 10: 부분취소└mchtParamAHN(4000)영문+한글+숫자, 최대 4000byte상점 예약 필드
상점 예약 필드상점 예약 필드
└pktHashAN(64)영문+숫자, 최대 64byte*SHA256 해쉬값
SHA256 해쉬값
*거래상태코드 + 거래일자 + 거래시간 + 상점아이디 + 상점주문번호 + 거래금액 + 해쉬키
노티 응답 (가맹점 → 헥토파이낸셜)
가맹점에서 헥토파이낸셜로 노티 수신 결과를 응답합니다.
| 응답 | 설명 |
|---|---|
OK | 성공 (대문자) |
FAIL | 실패 (대문자) - 명확한 실패로 인식하여 노티 재전송 |
| 그 외 | 비정상 실패로 인식하여 설정된 횟수만큼 노티 재발송 처리 |
노티 전문 예시
outStatCd=0021&trdNo=STBK0123456789&method=VA&bizType=B1&mchtId=nxva_sb_il&mchtTrdNo=ORDER20211231100000&mchtCustNm=홍길동&mchtName=헥토파이낸셜&pmtprdNm=테스트상품&trdDtm=20211231010101&trdAmt=1000&bankCd=089&bankNm=K뱅크&vAcntNo=01012345678&expireDt=20211231235959&AcntPrintNm=010가상계좌&dpstrNm=홍길동&mchtCustId=HongGilDong&pktHash=해시값
