노티서비스
KG 이니시스 거래 중 가상계좌 입금여부, 에스크로 거래상태 등을 노티를 통해 수신받기 위한 서비스
연동 준비하기
노티서비스 연동 전, 체크해야할 사항을 안내드립니다.
MID상점아이디
계약 완료 여부, 사용 가능 지불 수단 등은 계약담당자 문의노티수신URL세팅
각 서비스별 세팅방법 상이 (Quick Guide 참고)방화벽정보
항목 | PC 가상계좌 | 모바일 가상계좌 | 에스크로 |
---|---|---|---|
IP | 203.238.37.15 39.115.212.9 183.109.71.153 |
203.238.37.15 118.129.210.25 183.109.71.153 |
203.238.37.15 203.238.37.32 183.109.71.153 |
PORT | 가맹점포트 (80/443) | ||
연결방향 | INBOUND |
NOTIPC 가상계좌 입금노티
PC 가상계좌 노티 정보
- Header 정보
HTTP Method : POST
Content-type: application/x-www-form-urlencoded;charset=euc-kr
※ 유의사항
- KG이니시스에서 인입된 노티가 맞는지 IP 체크를 통해 반드시 확인하셔야 합니다.
- 리턴 메세지를 반드시 적용해주셔야 합니다.
상점 DB 등록 성공유무에 따라서 성공시에는 "OK" 문자열만 응답되어야 합니다.
"OK" 문자열이 응답되지 않을 경우, 24시간동안 약 10분 주기로 10회까지 노티가 재전송됩니다.
JSP : out.print("OK");
PHP : echo "OK";
ASP : response.write "OK"
Servlet(JAVA) : System.out.print("OK");
- 로그를 반드시 작성해주시기 바랍니다. 로그는 문제 발생시 이니시스와 데이터를 확인할 수 있는 근거 데이터이므로 반드시 적용해주시기 바랍니다.
- 입금통보 노티전송 시 파라미터는 추후 요건에 의해 추가될 수 있습니다.
no_tid | 거래번호 (입금거래에 대한 입금TID) 가상계좌 채번TID 와 상이 |
40 byte
|
---|---|---|
no_oid | 상점 주문번호 (가상계좌 채번요청 시 주문번호) |
40 byte
|
dt_trans | 금융기관 발생 거래 일자 |
8 byte
|
tm_trans | 금융기관 발생 거래 시각 |
6 byte
|
cd_bank | 가상계좌 발급 시 은행코드 |
8 byte
|
cd_deal | 고객 실입금 시 은행코드 |
8 byte
|
no_vacct | 가상계좌번호 |
20 byte
|
amt_input | 입금금액 |
13 byte
|
flg_close | 마감구분 [0:당일마감전, 1:당일마감후] |
1 byte
|
cl_close | 마감구분코드 [0:당일마감전, 1:당일마감후] |
1 byte
|
type_msg | 거래구분 [0200:정상] |
4 byte
|
nm_inputbank | 입금은행명 |
10 byte
|
nm_input | 입금자명 |
20 byte
|
dt_inputstd | 입금기준일자 |
8 byte
|
dt_calculstd | 정산기준일자 |
8 byte
|
dt_transbase | 거래기준일자 |
8 byte
|
cl_trans | 거래구분코드 [1100] |
4 byte
|
cl_kor | 한글구분코드 |
1 byte
|
dt_cshr | 현금영수증 발급일자 현금영수증 발행요청 건의 한함 |
8 byte
|
tm_cshr | 현금영수증 발급시간 현금영수증 발행요청 건의 한함 |
6 byte
|
no_cshr_appl | 현금영수증 발급번호 현금영수증 발행요청 건의 한함 |
9 byte
|
no_cshr_tid | 현금영수증 발급TID 현금영수증 발행요청 건의 한함 |
40 byte
|
NOTI모바일 가상계좌 입금노티
모바일 노티 정보
- Header 정보
HTTP Method : POST
Content-type: application/x-www-form-urlencoded;charset=euc-kr
※ 유의사항
- KG이니시스에서 인입된 노티가 맞는지 IP 체크를 통해 반드시 확인하셔야 합니다.
- 리턴 메세지를 반드시 적용해주셔야 합니다.
상점 DB 등록 성공유무에 따라서 성공시에는 "OK" 문자열만 응답되어야 합니다.
"OK" 문자열이 응답되지 않을 경우, 24시간동안 약 10분 주기로 노티가 계속 재전송됩니다.
JSP : out.print("OK");
PHP : echo "OK";
ASP : response.write "OK"
Servlet(JAVA) : System.out.print("OK");
- 로그를 반드시 작성해주시기 바랍니다. 로그는 문제 발생시 이니시스와 데이터를 확인할 수 있는 근거 데이터이므로 반드시 적용해주시기 바랍니다.
- 입금통보 노티전송 시 파라미터는 추후 요건에 의해 추가될 수 있습니다.
P_STATUS | 거래상태 "00":가상계좌 채번, "02":가상계좌입금통보 |
2 byte
|
---|---|---|
P_TID | 거래번호 가상계좌 채번TID |
40 byte
|
P_TYPE | 지불수단 [VBANK: 가상계좌] |
10 byte
|
P_AUTH_DT | 승인일시 [YYMMDDhhmmss] |
14 byte
|
P_MID | 상점아이디 |
10 byte
|
P_OID | 상점주문번호 |
100 byte
|
P_FN_CD1 | 은행코드 |
4 byte
|
P_FN_CD2 | 금융사코드 (빈값으로 전달) |
10 byte
|
P_FN_NM | 입금은행명 |
50 byte
|
P_AMT | 거래금액 |
12 byte
|
P_UNAME | 주문자명 |
30 byte
|
P_RMESG1 | 메시지1 [채번된 가상계좌번호|입금기한] |
500 byte
|
P_RMESG2 | 메시지2 (빈값전달) |
500 byte
|
P_NOTI | 가맹점 임의 데이터 |
600 byte
|
P_AUTH_NO | 승인번호 (빈값전달) |
30 byte
|
P_CSHR_AMT | 현금영수증 거래금액 현금영수증 발행요청 건의 한함 |
12 byte
|
P_CSHR_SUP_AMT | 현금영수증 공급가액 현금영수증 발행요청 건의 한함 |
12 byte
|
P_CSHR_TAX | 현금영수증 부가가치세 현금영수증 발행요청 건의 한함 |
12 byte
|
P_CSHR_SRVC_AMT | 현금영수증 봉사료 현금영수증 발행요청 건의 한함 |
12 byte
|
P_CSHR_TYPE | 현금영수증 거래구분
["0": 소득공제용, "1": 지출증빙용] 현금영수증 발행요청 건의 한함 |
14 byte
|
P_CSHR_DT | 현금영수증 발행일시
[YYYYMMDDhhmmss] 현금영수증 발행요청 건의 한함 |
14 byte
|
P_CSHR_AUTH_NO | 현금영수증 발행승인번호 현금영수증 발행요청 건의 한함 |
9 byte
|
NOTI에스크로 상태변경노티
에스크로 상태변경 노티 정보
- Header 정보
HTTP Method : POST
Content-type: application/x-www-form-urlencoded;charset=euc-kr
※ 유의사항
- KG이니시스에서 인입된 노티가 맞는지 IP 체크를 통해 반드시 확인하셔야 합니다.
- 리턴 메세지를 반드시 적용해주셔야 합니다.
상점 DB 등록 성공유무에 따라서 성공시에는 "cd_rslt=0000" 문자열만 응답되어야 합니다.
"OK" 문자열이 응답되지 않을 경우, 24시간동안 약 10분 주기로 노티가 계속 재전송됩니다.
JSP : out.print("cd_rslt=0000");
PHP : echo "cd_rslt=0000";
ASP : response.write "cd_rslt=0000"
Servlet(JAVA) : System.out.print("cd_rslt=0000");
- 에스크로 노티는 10분 간격으로 일괄 전송되는 구조입니다. 한 건의 거래가 10분 내 상태가 변경되면 여러 건의 노티(에스크로 상태별)가 전송 될 수 있습니다.
- 가맹점에서는 에스크로 노티 데이터를 히스토리로 관리하여 최종 에스크로 상태를 구분해야 합니다.
ex) 매시간 X0분에 에스크로 노티 전송
1. 05분 : 에스크로 상태 '2' (배송등록)
2. 07분 : 에스크로 상태 변경 '3' (구매확인)
3. 10분 : 에스크로 노티 처리시 배송등록과 구매확인에 대한 노티 전문 모두 전송(한건의 거래에 2번의 노티 전송)
- 노티 전문은 먼저 등록 요청된 순으로 전송됩니다. (배송등록 → 구매확인)
- 에스크로 노티 응답 실패시 재전송처리는 10회 수행됩니다.
- 상태변경노티를 수신받을 URL은 영업담당자분께 등록요청합니다.
담당자를 모르는 경우 1588-4954(고객센터) 로 문의부탁드립니다.
- 노티전문
- 노티응답(가맹점)
id_merchant | 에스크로 결제요청 시 상점아이디 |
10 byte
|
---|---|---|
no_oid | 주문번호 1. 배송등록 이전 - 승인시점 주문번호 전달 2. 배송등록 이후 - 배송등록 시에 인입 된 주문번호 전달 |
40 byte
|
no_tid | 에스크로 결제 승인 TID |
40 byte
|
dt_req | 요청일시 [YYYYMMDDhhmmss] |
14 byte
|
cl_status | 에스크로 상태구분 배송등록(2),구매확인(3),자동구매확인(31),강제구매확인(32),구매거절(4),거래취소(8),거절확인(10) |
2 byte
|
cl_paymethod | 에스크로 결제수단 신용카드(0),ISP(1),계좌이체(16),가상계좌(17) |
2 byte
|
msg_deny | 구매거절 사유 구매거절시 전달 |
256 byte
|
price | 거래금액 |
12 byte
|
tid_org | 원거래 거래번호 부분취소된 거래만 전달 |
40 byte
|
cd_rslt | 결과코드 "0000":정상처리, "9999":처리실패 |
4 byte
|
---|---|---|
msg_rslt | 처리 실패시 해당 오류메시지 |
1000 byte
|