우선 에스크로 결제 시 사용하는 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
메시지는 월요일 발송으로, 프로모션 기간은 일주일(월 ~ 일) 고정입니다.
서비스 신청 후 이용료 입금이 확인된 시점부터 메시지 발송 시까지 최대 약 10 영업일 소요됩니다.
단, 카드사 심사 결과, 내용 및 URL 주소 부적합 또는 발송 가능 타겟 고객 부족 등의 경우 반려 혹은 보류될 수 있습니다.
서비스 신청 시 해당 가맹점에 기존 구매경험이 있는 고객의 포함 여부를 선택할 수 있으며, 특별히 원하시는 타겟 고객이 있으신 경우(예. 2,30대 여성) 서비스 신청서 내에 기재해주세요.
메시지를 수신한 타겟 고객만 혜택이 적용됩니다.
과도한 청구할인이 발생할 경우, 카드사의 안내에 따라 청구할인 프로모션은 중도에 중단할 수 있습니다.
상세 내용은 카드사 별 상이하오니 상세 서비스 신청 시 유의사항을 확인해주세요.
가맹점 관리자페이지 내 상담좌측 메뉴 상점정보 -> 결제수단정보 에서 지불수단 별 수수료를 확인하실 수 있습니다.