PC(웹표준)결제 서비스에서 추가적으로 이용가능한 기능에 대하여 소개합니다.
PC(웹표준)결제창에서 빌링서비스, 에스크로서비스를 사용하기 위한 옵션을 안내합니다. 결제창 호출규격은 동일하며, acceptmethod 필드에 하기 옵션을 세팅하시면 됩니다.
구분 | 파라미터 | 옵션value | 비고 |
---|---|---|---|
신에스크로 | acceptmethod | useescrow | 신에스크로 MID는 해당옵션이 없을 경우 일반결제 진행됨 |
신용카드 빌링키발급 | acceptmethod | BILLAUTH(Card) | |
휴대폰 빌링키발급 | acceptmethod | BILLAUTH(HPP):HPP(4) | [ 컨텐츠: HPP(4) / 실물: HPP(5) ] |
※ 휴대폰 빌링 시 주의사항 휴대폰 빌링의 경우는 통신사 정책으로 빌키 발급시 인증+승인이 자동으로 됩니다. 2회차 부터는 1회차 동일금액, 익월+-5일이내 로 승인요청이 되어야 합니다. 휴대폰 빌링의 경우는 계약에 따라 회차 처리 로직이 다를 수 있으니 필히 계약 상태 확인후 진행바랍니다.
가맹점에서 승인결과 전문 처리 중 예외발생 시 망취소 요청할 수 있습니다. 승인요청 전문과 동일한 스펙으로 진행되며, 인증결과 수신 시 전달받은 "netCancelUrl" 로 망취소요청합니다. 제공된 샘플 INIStdPayReturn 에서 망취소 요청에 대한 예시 참고부탁드립니다. ** 망취소를 일반 결제취소 용도로 사용하지 마십시오. 일반 결제취소는 INIAPI 취소/환불 서비스를 통해 진행해주시기 바랍니다.
파라미터 | 설명 | SIZE(Byte) | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
mid | 상점아이디 | 10 | ||||||||||||
authToken | 승인요청 검증 토큰 | N/A | ||||||||||||
timestamp | 타임스템프 [TimeInMillis(Long형)] | 20 | ||||||||||||
signature | SHA256 Hash값 [대상: authToken, timestamp]
HASH
×
signature 개요
언어별 제공된 라이브러리 소스를 통해서 생성가능합니다.
생성방법: NVP 방식으로 연결한 데이터를 SHA256으로 Hash한 값 입니다.
관련 웹매뉴얼로 이동하기
|
60 | ||||||||||||
charset | 인증결과 인코딩 [Default: UTF-8] | 6 | ||||||||||||
format | 리턴형식 [XML, JSON, NVP]
example
×
리턴 형식별 승인결과 예시
|
5 | ||||||||||||
price | 인증가격 * 옵션필드 (제외가능) | 64 |
파라미터 | 설명 | SIZE(Byte) | ||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
resultCode | 결과코드 ["0000":정상, 그외 실패] * 승인처리가 되지 않은 거래건 망취소 시 실패코드 전달됨 | 10 | ||||||||||||||||||||||||||||||
resultMsg | 결과메세지 | 100 | ||||||||||||||||||||||||||||||
timestamp | 타임스템프 [TimeInMillis(Long형)] | 20 | ||||||||||||||||||||||||||||||
tid | 거래번호 | 40 | ||||||||||||||||||||||||||||||
mid | 상점아이디 | 10 | ||||||||||||||||||||||||||||||
MOID | 주문번호 | 40 | ||||||||||||||||||||||||||||||
selectPayMethod | 지불수단
Info
×
지불수단
|
10 |
가상계좌 입금통보 수신 페이지는 고객이 가상계좌이체 서비스를 사용하여 가상계좌번호를 발급 받은 후, 무통장 입금을 하였을 때, 은행으로부터 통보된 입금결과를 상점으로 전송해 주기 위해 상점 측에 필요한 페이지입니다. URL 입금내역 통보 방식으로 안내해 드리고 있으며, HTTP/HTTPS 모두 지원합니다.
PC 가상계좌 입금내역 수신을 위해서는 아래의 가맹점 방화벽이 허용되어 있어야합니다.
항목 | 내용 |
---|---|
연결방향 | INBOUND |
IP | 203.238.37.15 / 39.115.212.9 / 183.109.71.153 |
<?php
//@extract($_POST);
@extract($_SERVER);
$TEMP_IP = getenv("REMOTE_ADDR");
$PG_IP = substr($TEMP_IP, 0, 10);
if($PG_IP == "203.238.37" || $PG_IP == "39.115.212" || $PG_IP == "183.109.71") //PG에서 보냈는지 IP로 체크
{
// 이니시스 NOTI 서버에서 받은 Value
$no_tid = $_REQUEST["no_tid"]; // 거래TID
$no_oid = $_REQUEST["no_oid"]; // 상점주문번호
$cd_bank = $_REQUEST["cd_bank"]; // 은행코드
$cd_deal = $_REQUEST["cd_deal"]; // 거래취급 기관코드(실제입금은행)$dt_trans = $_REQUEST["dt_trans"]; // 금융기관 발생 거래일자
$tm_trans = $_REQUEST["tm_trans"]; // 금융기관 발생 거래시각
$no_vacct = $_REQUEST["no_vacct"]; // 계좌번호
$amt_input = $_REQUEST["amt_input"]; // 입금금액
$flg_close = $_REQUEST["flg_close"]; // 마감구분[0:당일마감전, 1:당일마감후]
$cl_close = $_REQUEST["cl_close"]; // 마감구분코드[0:당일마감전, 1:당일마감후]
$type_msg = $_REQUEST["type_msg"]; // 거래구분[0200:정상]
$nm_inputbank = $_REQUEST["nm_inputbank"]; // 입금은행명
$nm_input = $_REQUEST["nm_input"]; // 입금자명
$dt_inputstd = $_REQUEST["dt_inputstd"]; // 입금기준일자
$dt_calculstd = $_REQUEST["dt_calculstd"]; // 정산기준일자
$dt_transbase = $_REQUEST["dt_transbase"]; // 거래기준일자
$cl_trans = $_REQUEST["cl_trans"]; // 거래구분코드
$cl_kor = $_REQUEST["cl_kor"]; // 한글구분코드
$dt_cshr = $_REQUEST["dt_cshr"]; // 현금영수증 발급일자
$tm_cshr = $_REQUEST["tm_cshr"]; // 현금영수증 발급시간
$no_cshr_appl = $_REQUEST["no_cshr_appl"]; // 현금영수증 발급번호
$no_cshr_tid = $_REQUEST["no_cshr_tid"]; // 현금영수증 발급TID
// if(데이터베이스 등록 성공 유무 조건변수 = true)
// 주의 : DB처리후 정상일경우만 OK출력
echo "OK";
// else//echo "FAIL";
}
?>
파라미터 | 설명 | SIZE(Byte) |
---|---|---|
no_tid | 거래번호 (입금거래에 대한 입금TID) * 가상계좌 채번TID 와 상이 | 40 |
no_oid | 상점 주문번호 (가상계좌 채번요청 시 주문번호) | 40 |
cd_bank | 가상계좌 발급 시 은행코드 Code | 8 |
cd_deal | 고객 실입금 시 은행코드 Code | 8 |
dt_trans | 금융기관 발생 거래 일자 | 8 |
tm_trans | 금융기관 발생 거래 시각 | 6 |
no_vacct | 가상계좌번호 | 20 |
amt_input | 입금금액 | 13 |
flg_close | 마감구분 [0:당일마감전, 1:당일마감후] | 1 |
cl_close | 마감구분코드 [0:당일마감전, 1:당일마감후] | 1 |
type_msg | 거래구분 [0200:정상] | 4 |
nm_inputbank | 입금은행명 | 10 |
nm_input | 입금자명 | 20 |
dt_inputstd | 입금기준일자 | 8 |
dt_calculstd | 정산기준일자 | 8 |
dt_transbase | 거래기준일자 | 8 |
cl_trans | 거래구분코드 [1100] | 4 |
cl_kor | 한글구분코드 | 1 |
dt_cshr | 현금영수증 발급일자 * 현금영수증 발행요청 건의 한함 | 8 |
tm_cshr | 현금영수증 발급시간 * 현금영수증 발행요청 건의 한함 | 6 |
no_cshr_appl | 현금영수증 발급번호 * 현금영수증 발행요청 건의 한함 | 9 |
no_cshr_tid | 현금영수증 발급TID * 현금영수증 발행요청 건의 한함 | 40 |
PC 에서 에스크로 구매결정 시 호출JS 와 파라미터에 대하여 안내합니다.
파라미터 | 설명 | 필수(O/X) | SIZE(Byte) |
---|---|---|---|
version | 전문 버전 ["1.0" 고정] | O | 20 |
mid | 결제요청 시 설정한 P_MID 값 | O | 10 |
tid | 에스크로 결제 승인 TID | O | 40 |
currency | 통화구분 ["WON":한화, "USD":달러] * USD는 카드 결제만 가능 | O | 40 |
timestamp | 타임스템프 (TimeInMillis(Long형)) | O | 20 |
mKey | SHA256 Hash값 [대상: mid 와 매칭되는 signkey]
HASH
×
mkey 개요
mid(상점아이디)와 매칭되는 signkey 를 SHA256으로 hash한 값 입니다.
ex) hash생성 예시
PlainText: SU5JTElURV9UUklQTEVERVNfS0VZU1RS
Hash 데이터: 3a9503069192f207491d4b19bd743fc249a761ed94246c8c42fed06c3cd15a33
관련 웹매뉴얼로 이동하기
|
O | 64 |
returnUrl | 결과수신URL | O | N/A |
closeUrl | 결제창 닫기 URL | O | N/A |
popupUrl | 팝업처리 URL | O | N/A |
payViewType | 결제창 표시 방법 [overlay,popup] * Default: Default: overlay | X | 2 |
charset | 결과 수신 인코딩 [UTF-8,EUC-KR] | X | 6 |
acceptmethod | 복합파라미터 구매확인만 표시 : value="escrow_buyd(co)" 구매거절만 표시 : value="escrow_buyd(re)" * Default: 구매확인/거절 모두 표시 | X | N/A |
* 참고) 1. PC(웹표준) 구매결정 응답파라미터는 추후 요건에 의해 추가될 수 있습니다. 2. 실패 응답시 일부 파라미터 응답이 null 일 수 있습니다.
파라미터 | 설명 | SIZE(Byte) |
---|---|---|
resultCode | 결과코드 ["00": 정상, 그 외 실패] | 6 |
resultMsg | 결과메시지 | 100 |
CNF_Date | 구매확정일 경우, 처리일자 [YYYYMMDD] | 8 |
CNF_Time | 구매확정일 경우, 처리시간 [hhmmss] | 6 |
DNY_Date | 구매거절일 경우, 처리일자 [YYYYMMDD] | 8 |
DNY_Time | 구매거절일 경우, 처리시간 [hhmmss] | 6 |
매출전표(영수증) 발급 확인은 하기 URL 방식 참고하셔서 구성이 필요합니다.