연동준비하기
• 연동가능환경 • 방화벽정보 • 유의사항

연동파라미터 규격 추가기능 모바일빌링

모바일결제


당사에서는 모바일 웹(Web) 기반의 결제서비스를 제공하고 있습니다.

모바일결제 서비스 연동을 위한 환경정보 안내드립니다.

 
 
 

연동가능환경


소프트웨어 요구사항 :

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

하드웨어 요구사항 :

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

 
 
 

방화벽정보


모바일결제 서비스 통신을 위해서는 아래의 가맹점 방화벽이 허용되어 있어야합니다.


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

항목 URL IP 비고
스테이징 환경 stgmobile.inicis.com 118.129.210.154 테스트MID 만 사용가능
운영환경 fcmobile.inicis.com
ksmobile.inicis.com
118.129.210.57
183.109.71.50

 
 
 

유의사항


모바일결제 연동 시 유의할 사항에 대하여 안내드립니다.

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


1) iFrame issue

INIpayMobile은 Non-iframe 에 최적화되어 있습니다. 이에 iframe 내에 구현하는 것을 권장하지 않습니다.



2) Parameter issue

P_RESERVED 복합필드 외 일반필드에서는 Value 값에 하기 특수기호 사용을 불허합니다.
(특히, 주문번호필드(P_OID)와 기타주문정보필드(P_NOTI) 에는 절대 불허!)

 



3) DNS 설정관련 issue

① 가맹점의 웹 서버의 언어가 java인 경우 반드시 DNS캐쉬 기능을 꺼주셔야 합니다.
   (단말기와 웹서버에 Cache 된 DNS 정보가 상이할 경우, 결제 실패됨)

② JVM(JDK)설정 파일 networkaddress.cache.ttl 항목 설정 (java.security)
   이중화 서비스 이용을 위해 반드시 필요한 설정입니다(설정 후 WAS 재 시작.)

   $JAVA_HOME/jre/lib/security/java.security 설정파일에 “networkaddress.cache.ttl=0” 설정



4) 인증결과 수신 및 승인결과 수신시 issue

INIpayMobile 에서 전달하는 응답파라미터 파싱 시 주의사항입니다.

응답파라미터의 경우, 파라미터의 순서를 변경하거나 추가적으로 삽입할 수 있습니다.
POST 또는 GET 으로 넘어오는 데이터 전체를 Array 에 담아, 순서를 정한채 사용하지 마십시오.

또한, 항시 key & Value 의 형태를 유지하시기 바랍니다.

잘못된 세팅 예시 )




5) P_NEXT_URL 의 Scheme issue

P_NEXT_URL 의 Scheme 이 http 일 경우, 인증결과를 정상수신받지 못할 수 있습니다.

최근 보안페이지에서 비보안페이지로의 Submit 에 대한 제약이 강화되고 있습니다.

INIpayMobile 은 Https Scheme 을 사용한 보안페이지이며, 가맹점의 P_NEXT_URL 로 인증결과 송신 시
P_NEXT_URL 의 Scheme 이 http 일 경우, 아래와 같이 오류가 발생될 수 있습니다.


또한 사설 SSL인증서 사용시, 전송이 불가할 수 있사오니 반드시 체크바랍니다.

iOS 11.3 업데이트 이후 보안정책이 강화됨에 따라 http 프로토콜을 사용하는 경우, 인증결과를 받을 수 없습니다.
- 가맹점 주문정보 값 중 P_NEXT_URL(인증결과수신URL) 값이 http 일 경우, https 로 변경필요



6) 네이버/카카오톡 앱 환경 최적화 issue

INIpayMobile 호출 시 새창(_blank)이 아닌 _self 형태로 호출하는 것을 권장합니다.
(네이버/카카오 앱에서는 해당 앱 특성에 따라 결제창을 새창(_blank)으로 띄울 경우, 결제가 진행되지 않을 수 있습니다.)



7) 인증결과 수신시 Method issue

인증결과 수신 시 POST 와 GET 모두 수용할 수 있도록 처리해야 합니다.

INIpayMobile 은 다양한 카드사 및 인증사와의 복잡한 연계시스템을 구축하고 있습니다.
때문에 상황에 따라 인증결과 송신과정에 대하여 POST 혹은 GET 방식을 선택적으로 운영해야 합니다.

가맹점에서 인증결과 수신 시 개별 파라미터에 대하여 POST 와 GET 을 모두 수용할 수 있도록 처리하시기 바랍니다.



8) 브라우저 환경에서의 쿠키허용 issue

INIpayMobile 을 정상적으로 사용하기 위해서는 사용자의 브라우저에서 쿠키를 허용하는 상태여야 합니다.




9) 삼성페이 연동 시 유의사항

삼성페이 결제는 안드로이드 단말기의 삼성페이 지원 단말기에서만 사용 가능합니다.



10) TLS 1.2 연동 시 유의사항

INIpayMobile 은 TLS 1.2 서비스를 지원하고 있습니다. (sslv3, TLS 1.0, TLS 1.2 모두 지원)

TLS 1.2 와 관련하여 가맹점 확인필요사항을 안내드립니다.

① TLS 1.2 통신을 위해서는 가맹점 서버 및 어플리케이션에서 TLS 1.2 통신을 지원해야 합니다.

② TLS 1.2 통신은 당사 페이지 구간에 한하며, 일부 원천사(카드사/은행 등) 페이지의 경우,
   해당 원천사에서 WLS 1.2 통신을 지원하지 않을 수 있습니다.

③ 각 OS/브라우저 별 지원 가능한 통신방식이 다를 수 있습니다.(OS정책)
  - Android(API 20), iOS 5 미만 : TLS 1.2 미지원
  - Android 8.0 이상 : sslv3 미지원