세팅하신 MID 가 에스크로 서비스가 계약된 MID 가 맞는지 확인을 부탁드립니다.
에스크로 결제용 MID 가 아닌 경우, 에스크로 옵션을 세팅하여도 정상작동하지 않습니다.
참고로 당사 테스트MID 인 INIpayTest 는 일반결제 에 대한 설정이 되어 있는 MID 입니다.
따라서 에스크로 옵션을 세팅하여도 정상동작하지 않으며, 일반결제로 진행됩니다.
에스크로 결제 테스트를 하고자 하시는 경우, 하기 테스트MID 를 사용하여 주시기 바랍니다.
구에스크로 : iniescrow0
신에스크로 : iniescrow2
PC웹표준 에스크로 구매결정 모듈도 존재하며, 해당 모듈을 연동하시는 경우,
플러그인(ActiveX) 설치없이 구매확정 또는 구매거절을 할 수 있습니다.
PC웹표준 에스크로 구매결정 모듈 연동에 대한 가이드는 하기 링크에서 상세매뉴얼을 통해 확인가능하오니 참고하셔서 연동부탁드립니다.
https://manual.inicis.com/stdpay/std-add.html#escrow
우선 에스크로 결제 시 사용하는 MID 의 계약사항 확인이 필요합니다.
(구에스크로, 신에스크로)
구에스크로 MID 인 경우, 별도의 옵션 필요없이 MID 만 세팅하시면 에스크로로 결제됩니다.
신에스크로 MID 인 경우, 에스크로 결제를 위해서는 acceptmethod 필드에 useescrow 옵션값을 세팅해주셔야 합니다.
정리하면 아래와 같습니다.
구에스크로 MID 는 에스크로 결제만 가능
신에스크로 MID 는 에스크로 옵션 미적용 시 일반결제 / 옵션 적용 시 에스크로 결제
계약사항에 따른 에스크로 결제세팅 방법 안내드립니다.
웹표준 모듈
* 구에스크로 : MID 적용 시 에스크로 결제
* 신에스크로 : MID 적용 + acceptmethod value = useescrow 적용 필요
(모바일 모듈은 P_RESERVED value = useescrow=Y 옵션적용 필요)
당사 에스크로 거래진행 시 프로세스는 아래와 같이 진행됩니다.
1. 고객이 웹표준 결제창을 통해 결제승인
(매뉴얼 : https://manual.inicis.com/stdpay/ )
2. 판매자가 배송등록
(매뉴얼 : https://manual.inicis.com/iniapi/escrow.html#Dlv)
3. 배송완료 시 고객이 구매결정
(매뉴얼 : https://manual.inicis.com/stdpay/std-add.html#escrow)
3-1 구매결정 모듈로 구매확정
3-2 구매결정 모듈로 구매거절
고객이 배송완료 후 +3일동안 구매확정을 하지 않는경우 자동구매확정 처리됩니다.
(배송추적이 불가한 '기타택배' 등록 건은 배송등록 +9일 후 자동구매확정 처리됩니다.)
고객이 구매결정 모듈로 구매거절 시에는 판매자가 구매거절확인 모듈로
구매거절 확인 처리해야만 고객에게 환불처리됩니다.
(매뉴얼 : https://manual.inicis.com/iniapi/escrow.html#Dncf)
혹 가맹점에서 고객과 협의하여 다시 '구매확정'으로 상태를 변경하고자 하는 경우
구매결정 모듈을 재호출 하여 구매확정으로 변경하면 됩니다.
INIAPI 매뉴얼 내 아래와 같이 [ENC] 표기가 된 파라미터가 AES 암호화 대상입니다.
특정파라미터에 [ENC] 표시가 있다면 반드시 value 값을 AES암호화 후 세팅해주시기 바랍니다.
ex) 조건 : 환불계좌번호=123456789, MID=INIpayTest
refundAcctNum = qwMHVJqsmXKoR+d8wQTS4g==
*** 주의 ***
– hashData 생성 시에도 refundAcctNum 부분에 AES암호화 한 값을 세팅하셔야 합니다.
– api 통신구간에서 요청전문을 반드시 urlencode 하셔야 합니다.
(urlencode 하지 않을 경우 AES 암호화데이터 내 특수문자(+) 가 누락될 수 있습니다.)
INIAPI 에서 사용되는 key 는 signkey 가 아닌 INIAPI key 가 사용됩니다.
signkey 는 INIpay standard(PC) 모듈에서만 사용되는 key 값입니다.
따라서 INIAPI 연동 시 해당 MID 로 상점관리자에 접속하여
별도의 INIAPI key 를 확인하시기 바랍니다.
[INIAPI 확인경로]
상점관리자 > 상점정보 > 계약정보 > 부가정보 > INIAPI key 생성 갱신
참고로, INIAPI 매뉴얼 상에 INIAPI key 확인경로 및 테스트 상점아이디의 INIAPI key 가
안내되어 있습니다.
매뉴얼 : https://manual.inicis.com/iniapi/api-info.html#iniapikey
INIAPI 요청 시 API URL 이 오세팅 된 경우, 정상응답이 전달되지 않고 URL 만 응답됩니다.
API URL 은 아래와 같이 https:// (프로토콜) + HOST + API 경로 로 세팅해주셔야 합니다.
https://iniapi.inicis.com/api/v1/(서비스)/
ex) 결제/승인 취소 api 요청 시
https://iniapi.inicis.com/api/v1/refund/
1. 운영계 거래건을 개발계로 취소요청할 경우 오류발생
PC웹표준 또는 모바일 모듈로 결제완료 후
INIAPI 거래취소 모듈로 취소요청 시 운영환경으로 취소요청 해야합니다.
취소요청URL 을 운영환경 (https://iniapi.inicis.com/api/v1/refund) 으로 세팅하여 재시도 바랍니다.
** PC웹표준 모듈에서 테스트JS 로 결제요청 하더라도 실 승인은 운영계로 처리되므로 취소요청 시 운영계로 요청해야만 정상처리됩니다.
2. 인증TID 로 취소요청할 경우 오류발생
모바일 모듈의 경우 인증TID 와 승인TID 로 TID 가 2번 전달됩니다.
인증TID –> INIMX_AUTH
승인TID –> INIMX_CARD / INIMX_ISP
인증TID 는 실결제에 대한 TID 가 아니므로 승인TID 로 취소요청 바랍니다.
3. 취소요청 TID 에 오타 또는 누락된 부분이 있을 경우 오류발생
취소요청 하는 거래건TID 가 올바른지 재확인 바랍니다.
위 내용으로 오류확인이 되지 않는 경우
거래건 TID 또는 당사로 거래요청 시 세팅한 파라미터 값 전체를 하기 메일로 첨부하여 문의부탁드립니다.
기술지원 : ts@kggroup.co.kr
INIAPI 의 경우 대소문자를 체크합니다.
따라서 파라미터명과 value 값 세팅 시 반드시 매뉴얼에 안내된 대소문자를 구분하여 세팅하셔야 합니다.
value 에 세팅된 값에 대소문자가 맞지않는 경우, ERR012 오류가 발생될 수 있습니다.
ex) paymethod = card ( X ) –> Card ( O )
1. 암호화 대상 필드의 값이 암호화되지 않은 상태로 거래요청 된 경우 오류발생
매뉴얼 내 파라미터 설명 부분에 “ENC” 표기가 있는 경우 AES암호화 전송해야 합니다.
ex) 가상계좌 환불 모듈 내 “환불계좌번호”
2. 암호화 시 사용한 KEY 또는 IV 값이 누락되거나 상이할 경우 오류발생
MID 와 매칭되는 KEY 값과 IV 값을 통해 암호화 한 것이 맞는지 확인합니다.
KEY 와 IV 는 상점관리자페이지(https://iniweb.inicis.com)에서 확인가능합니다.
–> 상점정보 > 계약정보 > 부가정보 > INIAPI key 생성 갱신
위 내용으로 오류확인이 되지 않는 경우,
당사로 거래요청 시 세팅한 파라미터 값 전체를 하기 메일로 첨부하여 문의부탁드립니다.
기술지원 : ts@kggroup.co.kr