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포트가 기본으로 오픈되어 있으나, 별도의 보안정책 사용 시, 결제창 호출을 위해 위 도메인의 오픈이 필요합니다.
PC 결제에서는 대칭키로 "signkey"를 사용하며 사용자 위변조 방지를 위해 HASH 값을 생성하여 대조할 때 사용됩니다.
signkey 는 반드시 상점아이디(MID) 와 매칭되는 key 로 세팅하셔야 합니다.
* GID(그룹아이디)로 로그인하는 경우, signkey 메뉴 확인이 불가합니다.
2) 상단 메뉴에서 상점정보 > 계약정보 > 부가정보 로 이동합니다.
3) 웹결제 signkey 생성 조회 에서 "조회" 버튼을 클릭하여 signkey 값을 확인합니다.
4) signkey 는 최초 생성 후 갱신하지 않습니다.
(PC웹표준 결제 시 key 가 상이한 경우 오류가 발생됩니다.)
| 용도 | MID | Signkey |
|---|---|---|
| 일반결제 | INIpayTest | SU5JTElURV9UUklQTEVERVNfS0VZU1RS |
| 빌링결제(정기과금) | INIBillTst | SU5JTElURV9UUklQTEVERVNfS0VZU1RS |
| 에스크로결제 | iniescrow0 | SU5JTElURV9UUklQTEVERVNfS0VZU1RS |
※ 테스트MID 사용 시 유의사항 - 결제테스트 시 지불수단별로 거래가 실승인 됩니다. - 테스트 MID 로 진행한 거래건은 당일 자정 이전에 자동취소 됩니다. (매입전송X) (부분취소 진행건은 정상취소 되지 않을 수 있으므로 부분취소 테스트는 권장하지 않음) - 국민카드사 정책상, 국민카드 (카카오뱅크카드 포함) 는 카카오페이 결제테스트, 빌링키발급 테스트 가 불가합니다.
결제요청/승인요청 시 사용자의 위변조 방지를 위해 일부데이터를 SHA256 으로 HASH 합니다.
| 대상파라미터 | 설명 |
|---|---|
| oid | 주문번호 |
| timestamp | 타임스템프 [TimeInMillis(Long형)] |
| price | 결제요청금액 |
| 대상파라미터 | 설명 |
|---|---|
| authToken | 승인요청 검증 토큰 |
| timestamp | 타임스템프 [TimeInMillis(Long형)] * 인증요청 시 timestamp값과 상이 |
PC(웹표준)결제 연동 시 유의할 사항에 대하여 안내드립니다.
※ 유의사항을 준수하지 않음으로 인해 발생되는 문제에 대하여는 당사에서 책임지지 않습니다.
1. 웹표준 모듈은 반드시 HTTPS 로 통신해야 합니다. 2. 실운영 반영 시에는 반드시 상용 JS 로 수정이 필요합니다. // 상용JS (테스트JS 에서 stg 제거)
3. 가맹점 주문페이지 내 iframe 에서 결제모듈 호출 시 IE, 크롬 브라우저에서 크로스 브라우저 미지원으로 정상동작 되지 않을 수 있습니다.