고객센터

고객센터

KG이니시스와 전자결제서비스에 대한 새로운 소식을 알려드립니다.
언제나 고객님께 가치 있는 소식을 전할 수 있도록 노력하겠습니다.

INIAPI 는 REST API 로, 정의된 API URL 에 필수파라미터를 key=value 형태로 나열하여
POST 로 데이터 전송하는 모듈입니다.(JSON 방식으로는 데이터 전송이 불가합니다.)

API URL 은 도메인 + API 호출 경로 를 세팅해주시면 됩니다.


ex) INIAPI 결제/승인 취소

url = https://iniapi.inicis.com/api/v1/refund

[오류원인]

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={가맹점앱스키마}://

[오류원인]

안드로이드 상점앱(웹뷰)으로 진행 시 타앱 호출 혹은 타앱에 대한 처리가 정상적으로 안되어 오류발생되는 오류입니다.


[조치방법]

상점앱 내 타앱에 대한 처리될 수 있도록 앱 내 체크가 필요합니다.

– 앱내 처리 샘플
하기 AppCallSample.java 페이지 참고

AppCallSample.java

– 관련 매뉴얼
모바일웹 매뉴얼 33p “2. 앱 환경의 설치방법(안드로이드)” 부분 참고

당사에서는 모바일 웹만 지원합니다.

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

이때 발생하는 앱단에서 체크되어야 하는 부분은 모바일매뉴얼(INIpayMobile_WEB_manual.pdf)
30페이지 이하에 정리 되어있습니다.

https://manual.inicis.com/mobile/ > 상세메뉴얼 확인


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

연동매뉴얼 INIpay_V5.3_mobile_bill_manual.pdf 을 참고하여 연동하시면 되며,
해당 매뉴얼은 영업담당자를 통해 계약설정(이니라이트 상점) 여부 확인 후 배포받으실 수 있습니다.

(담당자를 모르는 경우 고객센터 1588-4954 를 통해 연결요청바랍니다.)


모바일 빌키발급 모듈은 OPEN API 로, 모바일 빌키발급 요청URL 로 필수파라미터를
key=value 형태로 나열하여 POST 로 전송하시면 됩니다.

모바일 빌키발급 URL : https://inilite.inicis.com/inibill/inibill_card.jsp

모바일 빌키발급 모듈을 통해 billkey 를 발급한 후, 해당 billkey 로 승인요청까지 진행해주셔야 실결제 됩니다.
(신용카드 빌링은 billkey만 발급할 경우 실결제되지 않습니다.)

빌링 승인요청 모듈은 하기 경로에서 확인가능합니다.
https://manual.inicis.com/iniapi/#billing

모바일 빌키발급 모듈을 연동하는 경우, 모바일에서도 billkey 를 발급받을 수 있습니다.
일반결제 모바일 모듈과는 요청URL 및 세팅파라미터가 상이하므로 모바일 빌키발급 모듈을 별도로 연동이 필요합니다.

연동매뉴얼은 INIpay_V5.3_mobile_bill_manual.pdf 파일이며,
영업담당자를 통해 계약설정(이니라이트 상점) 여부 확인 후 배포받으실 수 있습니다.

담당자를 모르는 경우 고객센터 1588-4954 를 통해 연결요청바랍니다.


모바일 빌키발급 모듈로 billkey 를 발급한 후, 해당 billkey 로 승인요청까지 진행해주셔야 실결제 됩니다.
(신용카드 빌링은 billkey만 발급할 경우 실결제되지 않습니다.)

빌링 승인요청 모듈은 하기 경로에서 확인가능합니다.
https://manual.inicis.com/iniapi/#billing

세팅하신 MID 가 에스크로 서비스가 계약된 MID 가 맞는지 확인을 부탁드립니다.
에스크로 결제용 MID 가 아닌 경우, 에스크로 옵션을 세팅하여도 정상작동하지 않습니다.

참고로, 당사 테스트MID 인 INIpayTest 는 일반결제 에 대한 설정이 되어 있는 MID 입니다.
따라서 에스크로 옵션을 세팅하여도 정상동작하지 않으며, 일반결제로 진행됩니다.

에스크로 결제 테스트를 하고자 하시는 경우, 하기 테스트MID 를 사용하여 주시기 바랍니다.

구에스크로 : iniescrow0
신에스크로 : iniescrow2


[구에스크로와 신에스크로 의 차이]

* 구에스크로
1) 에스크로 결제만 가능 (일반결제 불가)
2) P_MID 적용 시 에스크로 결제

* 신에스크로
1) 에스크로 옵션 미적용 시 일반결제 / 옵션 적용 시 에스크로 결제
2) P_MID 적용 + P_RESERVED value = useescrow=Y 옵션적용 필요 <– 모바일 모듈 기준
    (PC웹표준 모듈은 acceptmethod = useescrow 옵션적용 필요)


구에스크로, 신에스크로 여부는 상점아이디 계약 시 결정됩니다.
(확인이 필요한 경우 영업담당자분께 문의바랍니다. 담당자를 모르는 경우 고객센터 1588-4954 로 확인요청합니다.)

모바일 에스크로 구매결정 모듈을 연동하시는 경우,
모바일 기기에서도 구매확정 또는 구매거절을 할 수 있습니다.

모바일 에스크로 구매결정 모듈 연동에 대한 가이드는 하기 링크에서 확인가능하오니 참고하셔서 연동부탁드립니다.

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

우선 에스크로 결제 시 사용하는 MID 의 계약사항 확인이 필요합니다.
(구에스크로, 신에스크로)

구에스크로 MID 인 경우, 별도의 옵션 필요없이 MID 만 세팅하시면 에스크로로 결제됩니다.

신에스크로 MID 인 경우, 에스크로 결제를 위해서는 P_RESERVED 필드에 useescrow=Y 옵션값을 세팅해주셔야 합니다.


정리하면 아래와 같습니다.

구에스크로 MID 는 에스크로 결제만 가능
신에스크로 MID 는 에스크로 옵션 미적용 시 일반결제 / 옵션 적용 시 에스크로 결제

계약사항에 따른 에스크로 결제세팅 방법 안내드립니다.

모바일 모듈
* 구에스크로 : P_MID 적용 시 에스크로 결제
* 신에스크로 : P_MID 적용 + P_RESERVED value = useescrow=Y 적용 필요
    (PC웹표준 모듈은 acceptmethod = useescrow 옵션적용 필요)

[신버전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로 출력된 승인결과 수신