KG INICIS MANUAL

PC(웹표준)결제

PC에서 ActiveX 설치 없이 여러 지불수단을 이용하여 결제할 수 있도록 지원하는 인터넷 전자지불 서비스입니다.

PC(웹표준)결제 서비스 연동을 위한 환경정보 안내드립니다.

연동가능환경

소프트웨어 요구사항 :

HTTPS 통신이 가능한 웹서버 (또는 웹 컨테이너)
* SHA256 Hash 값 생성, httpClient (HTTP Background) 통신이 가능한지 확인

하드웨어 요구사항 :

일반적인 서버 운영체제의 운용환경에 준하며, 특별한 하드웨어 요구사항은 없습니다.

방화벽정보

PC(웹표준)결제 서비스 통신을 위해서는 아래의 가맹점 방화벽이 허용되어 있어야합니다.

- 연결방향(가맹점기준) : OUTBOUND
- PORT : 443 (https)

항목	URL	IP	비고
스테이징 환경	stgstdpay.inicis.com	118.129.210.47	테스트MID 만 사용가능
운영환경	stdpay.inicis.com fcstdpay.inicis.com ksstdpay.inicis.com	118.129.210.86 118.129.210.86 183.109.71.30

※ 참고사항

웹표준 결제창호출 시 stdpay.inicis.com:443 / stdux.inicis.com:443 의 도메인을 사용합니다.

일반적으로 고객 클라이언트 PC에서는 80/443포트가 기본으로 오픈되어 있으나,
별도의 보안정책 사용 시, 결제창 호출을 위해 위 도메인의 오픈이 필요합니다.

대칭키 (signkey)

PC 결제에서는 대칭키로 "signkey"를 사용하며 사용자 위변조 방지를 위해 HASH 값을 생성하여 대조할 때 사용됩니다.

signkey 는 반드시 상점아이디(MID) 와 매칭되는 key 로 세팅하셔야 합니다.

<< 테스트MID 대칭키 >>

용도	MID	Signkey
일반결제	INIpayTest	SU5JTElURV9UUklQTEVERVNfS0VZU1RS
빌링결제(정기과금)	INIBillTst	SU5JTElURV9UUklQTEVERVNfS0VZU1RS
에스크로결제	iniescrow0	SU5JTElURV9UUklQTEVERVNfS0VZU1RS

※ 테스트MID 사용 시 유의사항

- 결제테스트 시 지불수단별로 거래가 실승인 됩니다.

- 테스트 MID 로 진행한 거래건은 당일 자정 이전에 자동취소 됩니다. (매입전송X)
(부분취소 진행건은 정상취소 되지 않을 수 있으므로 부분취소 테스트는 권장하지 않음)

- 국민카드사 정책상, 국민카드 (카카오뱅크카드 포함) 는 카카오페이 결제테스트, 빌링키발급 테스트 가 불가합니다.

HASH 방법

결제요청/승인요청 시 사용자의 위변조 방지를 위해 일부데이터를 SHA256 으로 HASH 합니다.

mkey 개요

mid(상점아이디)와 매칭되는 signkey 를 SHA256으로 hash한 값 입니다.

     ex) hash생성 예시
     PlainText: SU5JTElURV9UUklQTEVERVNfS0VZU1RS
     Hash 데이터: 3a9503069192f207491d4b19bd743fc249a761ed94246c8c42fed06c3cd15a33

signature 개요

언어별 제공된 라이브러리 소스를 통해서 생성가능합니다.
생성방법: NVP 방식으로 연결한 데이터를 SHA256으로 Hash한 값 입니다.

※ NVP 방식: oid=oidValue&price=priceValue&timestamp=timestampValue

     ex) hash생성 예시
     PlainText: oid=INIpayTest_1361252896871&price=1004&timestamp=1361252896871
     Hash 데이터: ec1e9c63ddad0b81f316ada2e3861e81db5f4f6652d9ff0f255b4cb5499ce893

주의: 필드 순서 유지(알파벳순), 마지막 &는 생략, 공백생략, 모든대상 필드는 Form에 설정되는 데이터와 동일한 값을 이용합니다.

<< 결제요청 시 signature 생성 >>

대상파라미터	설명
oid	주문번호
timestamp	타임스템프 [TimeInMillis(Long형)]
price	결제요청금액

<< 승인요청 시 signature 생성 >>

대상파라미터	설명
authToken	승인요청 검증 토큰
timestamp	타임스템프 [TimeInMillis(Long형)] * 인증요청 시 timestamp값과 상이

• 유의사항

PC(웹표준)결제 연동 시 유의할 사항에 대하여 안내드립니다.

※ 유의사항을 준수하지 않음으로 인해 발생되는 문제에 대하여는 당사에서 책임지지 않습니다.

1. 웹표준 모듈은 반드시 HTTPS 로 통신해야 합니다.

2. 실운영 반영 시에는 반드시 상용 JS 로 수정이 필요합니다.

// 상용JS (테스트JS 에서 stg 제거)

3. 가맹점 주문페이지 내 iframe 에서 결제모듈 호출 시 IE, 크롬 브라우저에서
크로스 브라우저 미지원으로 정상동작 되지 않을 수 있습니다.