가상계좌입금통보

해당 가상계좌 입금통보 부분은 PC 가상계좌에 대한 내용이며,
모바일 가상계좌 입금통보 처리는 모바일새창에서 확인하시면 됩니다.

상점 입금통보 수신 페이지는 고객이 가상계좌이체 서비스를 사용하여 가상계좌번호를 발급 받은 후,
무통장 입금을 하였을 때, 은행으로부터 통보된 입금결과를 상점으로 전송해 주기 위해 상점 측에 필요한 페이지입니다.
URL 입금내역 통보 방식으로 안내해 드리고 있으며, HTTP/HTTPS 모두 지원합니다.

방화벽정보

가상계좌 내역 수신을 위해서는 아래의 가맹점 방화벽이 허용되어 있어야합니다.
항목 설명
연결방향 INBOUND
IP 203.238.37.15 / 39.115.212.9 / 183.109.71.153

기준정보 확인사항

이니시스 PG에서 보내는 전문을 정상적으로 처리되도록 하기 위해서는 이니시스의 기준정보를 확인하셔야 합니다.

입금내역통보방법 설정을 "실시간 통보함"으로 설정 되어있는지 확인하셔야 합니다.
아래 절차에 따라 수신 페이지 url을 설정하시기 바랍니다.

1. 이니시스 상점관리자 페이지새창에 접속하세요.
2. 거래내역 > 거래조회 > 가상계좌 > 입금 통보방식선택 메뉴를 클릭하세요.
3. 입금방식선택에서 URL수신사용을 선택하세요.
4. 입금내역통보URL 필드에 상점의 페이지 위치를 full 경로로 작성해 주세요.
  ex) http://ts.inicis.com:8881/INIpayJAVA/vacct/vacctinput.jsp

VacctUrl

유의사항

1. 이니시스 PG에서 요청했는지 여부( IP로 체크)를 반드시 확인하셔야합니다.
2. 리턴 메시지를 반드시 적용해주셔야합니다.
  상점 데이터베이스 등록 성공 유무에 따라서 성공시에는 "OK" 문자열만 응답되어야합니다.
  ASP : response.write "OK"
  JSP : out.print("OK");
  PHP : echo "OK";
3. 로그를 반드시 작성해주시기 바랍니다.
  로그는 문제 발생시 이니시스와 데이터를 확인할 수 있는 근거 데이터이므로 반드시 적용해주시기 바랍니다.

이체결과

가상계좌 이체 결과 파라미터를 전달합니다.

<<이체결과 파라미터>>
파라미터 설명 SIZE
no_tid 이니시스 거래번호 VARCHAR(40)
no_oid 상점의 주문번호 VARCHAR(40)
cd_bank 계좌를 발급한 은행 코드 VARCHAR(8)
cd_deal 거래 취급 기관 코드 (실제입금은행) VARCHAR(8)
dt_trans 금융기관 발생 거래 일자 VARCHAR(8)
tm_trans 금융기관 발생 거래 시각 VARCHAR(6)
no_vacct 계좌번호 VARCHAR(20)
amt_input 입금금액 NUMBER(13)
flg_close 마감구분 (0:당일마감전, 1:당일마감후) CHAR(1)
cl_close 마감구분코드 (0:당일마감전, 1:당일마감후) CHAR(1)
type_msg 거래구분 (0200:정상, 0400:취소) VARCHAR(4)
nm_inputbank 입금은행명 VARCHAR(10)
nm_input 입금자명 VARCHAR(20)
dt_inputstd 입금기준일자 NUMBER(8)
dt_calculstd 정산기준일자 NUMBER(8)
dt_transbase 거래기준일자 NUMBER(8)
cl_trans 거래구분코드 (1100) VARCHAR(4)
cl_kor 한글구분코드 NUMBER(1)
dt_cshr 현금영수증 발급일자 NUMBER(8)
tm_cshr 현금영수증 발급시간 NUMBER(6)
no_cshr_appl 현금영수증 발급번호 NUMBER(9)
no_cshr_tid 현금영수증 발급TID VARCHAR(40)

입금정보 수신 실패 사유 확인

1. 채번된 가상계좌로 정상입금되었는지 확인
상점관리자새창 > 거래내역 > 가상계좌 > 입금결과조회

2. 입금결과조회 내역에서 정상조회되며, 입금TID (IniTechPG_) 가 생성된 경우
  가상계좌 > 입금통보 재전송 메뉴에서 가상계좌 번호 조회

3. 거래일자 선택 후 해당 가상계좌 거래의 "입금통보결과" 확인

1) 상점으로부터 성공 응답받기 실패
   가맹점 노티수신페이지에서 입금통보 노티 수신 후 "OK" 를 응답해야하나,
   OK 가 아닌 다른 응답을 한 경우 입니다.

   가맹점 노티수신페이지에서 OK 응답을 하지 않거나 HTTP 500 에러 또는 404 에러 등으로 인해
   정상 응답하지 못한 경우 등 10회까지 노티가 재전송 됩니다.
   (OK 응답을 하지 않아도 가상계좌 거래건이 취소되지는 않습니다.)

   노티수신페이지에서 정상응답하지 못한 사유는 가맹점 내부적으로 확인이 필요합니다.

   ** 가맹점 노티수신페이지 세팅
   PC 가상계좌 --> 상점관리자 > 거래내역 > 가상계좌 > 입금통보방식 선택 > "URL 수신사용" 설정 및 URL 세팅
   모바일 가상계좌 --> 모바일 결제요청 데이터 내 P_NOTI_URL 세팅

2) 통보전문구분오류
   통보전문 방식이 선택되지 않은 경우 발생됩니다.
   상점관리자 > 상점정보 > 계약정보 > 결제수단정보 > 가상계좌 내 통보전문 --> "URL 수신사용(일반)" 으로 설정

3) 상점서버정보 없음 (IP, PORT, 전문구분)
   통보전문 방식을 "수신모듈사용" 으로 설정 후 입금내역통보 IP/PORT 가 세팅되지 않은 경우 발생됩니다.
   통보전문 방식을 "URL 수신사용" 으로 설정하시고 입금통보 URL 을 세팅바랍니다.

   상점관리자 > 상점정보 > 계약정보 > 결제수단정보 > 가상계좌 내 통보전문 --> "URL 수신사용(일반)" 으로 설정 및 가맹점 노티수신 URL 세팅

   ** PC 가상계좌 입금통보 수신페이지 가이드 확인새창(상점관리자 내 세팅)

   ** 모바일 가상계좌 입금통보 수신페이지 가이드 확인새창 (모바일 결제요청 데이터 내 세팅)