모바일 

모듈연동 FAQ

모듈연동에 대한 궁금증을 해결해 보세요.
[오류원인]

IOS의 경우 기본브라우저인 safari 외 앱(크롬,다음,네이버, 가맹점앱 등) 에서 ISP, 삼성앱카드 등의
카드사앱을 호출하여 결제진행 시 기존에 결제를 진행하던 앱은 Background 에 머물게 됩니다.

이후 카드사창에서 인증 종료 후 기본브라우저인 safari 를 호출하는 특성이 있습니다.


[조치방법]

- 브라우저 앱을 통해 결제진행하는 경우 (크롬, 다음, 네이버 등)
Safari 외 브라우저 앱에서 결제를 진행하는 경우, 앱브라우저의 user-agent를 확인하여
P_RESERVED 필드에 app_scheme={앱스키마}:// 형태를 설정하시면 됩니다.

ex) 크롬 앱에서 결제진행 시
P_RESERVED=app_scheme=googlechromes://


** 확인된 App Scheme ( 18.12.31 기준 )

다음 daumapps://open
네이버 naversearchapp://
크롬 googlechromes://
페이스북 fb://
카카오톡 kakaotalk://


-가맹점 앱을 통해 결제진행하는 경우
가맹점 앱에서 ISP, 삼성앱카드 등의 카드사앱을 통해 결제하는 경우,
카드사 앱 종료 후 가맹점 앱을 다시 호출하기 위해서는 아래와 같이 앱스키마 설정이 필요합니다.

P_RESERVED=app_scheme={가맹점앱스키마}://
당사에서는 모바일 웹만 지원합니다.

앱을 사용하실 경우, 앱내 웹을 띄울수있는 환경을 구성해 주셔야 합니다.
ex> 웹뷰

이때 발생하는 앱단에서 체크되어야 하는 부분은 참고문서를 통해 제공되고 있습니다.

https://manual.inicis.com/mobile/ > 앱 연동 시 참고문서


추가문의사항이 있으신 경우 ts@kggroup.co.kr 로 문의주시기 바랍니다.

[신버전URL 과 구버전 URL 구분하기]

신버전URL 은 결제요청URL 이 통합되어 있으나, 구버전URL 은 지불수단에 따라 결제요청URL 이 상이합니다.

신버전URL : https://mobile.inicis.com/smart/payment
                (지불수단은 P_INI_PAYMENT 필드에 세팅)

구버전URL : https://mobile.inicis.com/smart/{지불수단}
                신용카드 –> https://mobile.inicis.com/smart/wcard
                실시간계좌이체 –> https://mobile.inicis.com/smart/bank


구버전URL 로 모바일 결제요청하는 경우 지불수단에 따라 1trs/2trs 두가지 방식으로 진행됩니다.

1트렌젝션(1trs) 방식 – ISP계열 카드, 계좌이체, KPAY, 가상계좌입금통보
: 1trs는 인증과 승인이 동시에 처리됩니다.

1. 결제요청페이지에서 결제창 호출하여 인증/승인 진행
2. 승인결과 P_NOTI_URL Back단으로 전달
3. P_NOTI_URL 로 전달된 결과를 P_RETURN_URL 에서 보여줌

** ISP카드와 계좌이체의 경우 옵션 적용 시 2trs 로 진행

    신용카드 필수옵션 => “P_RESERVED”  value=”twotrs_isp=Y&block_isp=Y&twotrs_isp_noti=N”
    계좌이체 필수옵션 => “P_RESERVED”  value=”twotrs_bank=Y&apprun_check=Y”


2트렌젝션(2trs) 방식 – 안심클릭계열 카드, 가상계좌 채번, 휴대폰
: 2trs는 P_NEXT_URL 로 인증/승인 단계가 분기되어 있습니다.

1. 결제요청페이지에서 결제창 호출하여 인증진행
2. P_NEXT_URL 로 인증결과 수신 ( P_REQ_URL, P_TID, P_STATUS, P_RMESG1, P_NOTI , P_AMT )
3. 인증결과로 받은 P_REQ_URL 로 P_MID 와 P_TID 를 전송하여 승인요청
이 때, Http-Socket 통신을 통해 Back-End 단으로 요청
4. P_NEXT_URL 로 Socket의 Receive-Data로 출력된 승인결과 수신

[신버전URL 과 구버전 URL 구분하기]

신버전URL 은 결제요청URL 이 통합되어 있으나, 구버전URL 은 지불수단에 따라 결제요청URL 이 상이합니다.

신버전URL : https://mobile.inicis.com/smart/payment
                (지불수단은 P_INI_PAYMENT 필드에 세팅)

구버전URL : https://mobile.inicis.com/smart/{지불수단}
                신용카드 –> https://mobile.inicis.com/smart/wcard
                실시간계좌이체 –> https://mobile.inicis.com/smart/bank


신버전URL 로 모바일 결제요청하는 경우 2trs 로 결제가 진행되어 P_NEXT_URL 로 처리됩니다.
(가상계좌 입금통보는 P_NOTI_URL 로 전송됩니다.)

2트렌젝션(2trs) 방식 – 안심클릭/ISP계열 카드, 계좌이체, 가상계좌 채번, 휴대폰, Kpay
: 2trs는 P_NEXT_URL 로 인증/승인 단계가 분기되어 있습니다.

1. 결제요청페이지에서 결제창 호출하여 인증진행
2. P_NEXT_URL 로 인증결과 수신 ( P_REQ_URL, P_TID, P_STATUS, P_RMESG1, P_NOTI , P_AMT )
3. 인증결과로 받은 P_REQ_URL 로 P_MID 와 P_TID 를 전송하여 승인요청
이 때, Http-Socket 통신을 통해 Back-End 단으로 요청
4. P_NEXT_URL 로 Socket의 Receive-Data로 출력된 승인결과 수신

[오류원인]

모바일 결제요청 시 필수파라미터 P_AMT (금액) 필드가 누락되었거나, 형식이 잘못된 경우 오류가 발생됩니다.

[조치방법]

결제요청페이지 내 P_AMT 필드가 정상세팅되어 있는지 확인합니다.

정상세팅되었음에도 오류가 발생하는 경우, 하기 결제요청 정보를 포함하여 ts@kggroup.co.kr (이니시스 기술지원) 으로 확인요청바랍니다.

** 결제요청정보
P_MID (상점아이디) :
P_OID (주문번호) :
P_AMT (거래금액) :
결제요청일자 :

[오류원인]

모바일 휴대폰(소액)결제 요청 시 실물/컨텐츠 값이 잘못된 경우 발생됩니다.

[조치방법]

결제요청페이지 내 P_HPP_METHOD 필드가 정상세팅되어 있는지 확인합니다.

컨텐츠일 경우 : 1
실물일 경우 : 2

컨텐츠/실물 계약여부는 계약담당자를 통해 확인가능합니다. (담당자를 모를 경우 고객센터 1588-4954 를 통해 확인요청)

정상세팅되었음에도 오류가 발생하는 경우, 하기 결제요청 정보를 포함하여 ts@kggroup.co.kr (이니시스 기술지원) 으로 확인요청바랍니다.

** 결제요청정보
P_MID (상점아이디) :
P_OID (주문번호) :
P_AMT (거래금액) :
결제요청일자 :

모바일 연동 매뉴얼은 하기 경로에서 확인할 수 있습니다.

https://manual.inicis.com/mobile/

당사 모바일 모듈은 OPEN API 로, 모듈특성상 매뉴얼을 기반으로 연동하시도록 안내하고 있으며,
현재 공식적으로 배포중인 샘플은 존재하지 않습니다.

모바일 결제요청URL 인 https://mobile.inicis.com/smart/payment/ 로
결제요청데이터를 key=value 형태의 폼데이터로 세팅하여 POST 로 전달하시면 모바일 결제창이 호출됩니다.

매뉴얼을 참고로 모바일모듈 연동바라며, 어려움이 있으신 경우 ts@kggroup.co.kr 로 문의바랍니다.

모바일 모듈의 경우 가상계좌 입금 시, “입금자명” 을 전달하는 필드는 존재하지 않습니다.

PC 모듈 가상계좌 거래 시 입금자명을 전달하는 필드 (nm_input) 가 존재하기는 하나 구매자명과 비교하지는 않습니다.  (구매자명과 입금자명이 상이해도 정상 입금처리)

가상계좌 거래는 가상계좌와 입금금액 이 채번정보와 일치할 경우 정상입금처리됩니다.

A001 오류의 경우, 카드사에서 노출 시켜주는 오류로 당사(이니시스) 에서는 정확한 원인확인이 어렵습니다.

다만 하기와 같은 경우 A001 오류 메시지가 노출되는 부분으로 확인되오니 참고하여 주시기 바랍니다.

– 세션이 끊어진 경우

1. 앱(인앱 브라우저 등) 내에서 쿠키 사용 불가 혹은 세션이 끊긴 경우

2. 네트워크 환경 변경 등의 이슈로 세션이 변경되어 거래에 대한 값을 찾을 수 없을 때

– 사용자 단의 이슈

1. 결제 완료 후 자동으로 페이지가 전환 되도록 구성되어 있으나

사용자가 기다리지 않고 확인 혹은 결제완료 버튼을 클릭하여 카드사 내부적으로 처리가 정상적으로 되지 않은 경우

[오류원인]

상점아이디(MID) 에 계약되지 않은 정보로 결제요청 한 경우 발생


[조치방법]

1. 영업담당자분을 통해 상점아아디(MID) 에 계약된 지불수단을 확인한 후
계약된 지불수단으로 결제요청합니다.

2. "휴대폰 결제" 계약이 되어 있으나 MX2003 오류가 발생된다면,
결제요청 시 P_HPP_METHOD 필드값을 확인바랍니다.

휴대폰 결제 계약사항 확인하시어 계약사항에 맞는 값으로 세팅하셔야 합니다.

컨텐츠 일 경우 : 1
실물일 경우 : 2


** 영업담당자를 모르실 경우 고객센터 1588-4954 를 통해 연결부탁드립니다.