메시지를 수신한 타겟 고객만 혜택이 적용됩니다.
과도한 청구할인이 발생할 경우, 카드사의 안내에 따라 청구할인 프로모션은 중도에 중단할 수 있습니다.
상세 내용은 카드사 별 상이하오니 상세 서비스 신청 시 유의사항을 확인해주세요.
여신금융업법 상 준법심의필을 받는 내용만 발송 가능하기에 광고주 영역을 제외한 내용은 변경이 불가합니다.
홍보 문구는 해시태그 방식을 활용한 간결한 문구로, 프로모션URL 및 타겟을 고려한 추천 키워드로 자동 구성됩니다.
희망하시는 문구가 있는 경우, 서비스 신청서 내에 기재해주세요.
프로모션 진행 시 제공되는 청구할인 혜택 관련 유의사항은 메시지 내에 자동 명시됩니다.
서비스 신청 시 해당 가맹점에서 기존 구매한 경험이 있는 고객의 포함 여부를 선택할 수 있습니다. 또한, 특별히 원하시는 타겟 고객이 있으신 경우(예. 2,30대 여성, 유사 경쟁업체에서 구매한 경험이 있는 소비자 등) 서비스 신청서 내에 기재해주세요.
메시지는 월요일 발송으로, 프로모션 기간은 일주일(월~일) 고정입니다.
서비스 신청 후 이용료 입금이 확인된 시점부터 메시지 발송 시까지 최대 약 10 영업일 소요됩니다.
단, 카드사 심사 결과, 내용 및 URL 주소 부적합 또는 발송 가능 타겟 고객 부족 등의 경우 반려 혹은 보류될 수 있습니다.
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
hashdata 불일치 오류가 발생되는 경우, 요청 파라미터 내 세팅된 값과
hashdata 생성 시 PlainText (평문데이터) 값이 일치하는지 비교검토가 필요합니다.
hash 대상 파라미터는 각 API 별로 상이하며, 결제/승인 취소 API 를 통해 예시 드립니다.
ex) 결제/승인 취소 API
URL = https://iniapi.inicis.com/api/v1/refund
————————————————————————————————-
[요청파라미터]
type = Refund
paymethod = Card
timestamp = 20191128121211
clientIp = 123.123.123.123
mid = INIpayTest
tid = StdpayCARDINIpayTest20191128121211123456
msg = 테스트
hashdata = b2dc4d4308d836a77187fa1f4ce8c540006a41e6a708a63aded363510c7d445600601c
9035825fe32f48fe1b7d2ea130f690a2895a41b6fa0a99c6c5f92d6d69
————————————————————————————————–
PlainText :
ItEQKi3rY7uvDS8lRefundCard20191128121211123.123.123.123INIpayTest
StdpayCARDINIpayTest20191128121211123456
SHA512 hash :
b2dc4d4308d836a77187fa1f4ce8c540006a41e6a708a63aded363510c7d445600601c
9035825fe32f48fe1b7d2ea130f690a2895a41b6fa0a99c6c5f92d6d69
위와 같이 정상 세팅했음에도 오류가 발생되는 경우,
mid 와 매칭되는 API KEY 값으로 hash 한 것이 맞는지 확인이 필요합니다.
가맹점관리자페이지https://iniweb.inicis.com/ 에서 상점정보 > 계약정보 > 부가정보 > INIAPI KEY 생성 갱신
오류원인 확인이 어려우신 경우 호출한 하기내용 첨부하여 ts@kggroup.co.kr 으로 문의바랍니다.
호출 URL :
요청파라미터 :
PlainText :
1) MID 의 INIAPI key 가 생성되었는지 확인
상점관리자 > 상점정보 > 계약정보 > 부가정보 > INIAPI key 생성 갱신
위 경로에서 확인되는 key 값으로 모듈에 세팅하였는지 확인바랍니다.
2) 실운영 MID 로 거래요청 시 운영계 URL 세팅여부 확인
운영계 URL = https://iniapi.inicis.com
실운영 MID 로는 개발계 URL 로 거래요청이 불가합니다.
위 내용으로 원인확인이 되지 않는 경우,
API URL 과 전체 파라미터 세팅값을 첨부하여 ts@kggroup.co.kr 로 문의바랍니다.
오류메세지와 같이 mid 값이 세팅되지 않았거나, 파라미터명이 오세팅 된 경우 발생되는 오류입니다.
또는 INIAPI 모듈에서 지원하지 않는 방식으로 전문전송 경우에도 발생될 수 있습니다. (JSON 방식 등)
INIAPI 의 경우 JSON 방식으로 데이터 전송이 불가하며,
key=value 형태의 파라미터를 POST로 요청해야합니다.
** PHP 언어로 연동 시
PHP에서 POST요청을 curl로 처리할 때 배열의 파라미터가 제대로 전달되지 않는 경우에 mid is null 오류가 발생할 수 있습니다.
이 경우, http_build_query() 함수를 사용하여 URL 인코딩된 쿼리 문자열을 생성하신 후 재시도바랍니다.
ex) curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($form_data));
1. 매뉴얼에 안내된 value 값 길이가 초과된 경우 오류발생
매뉴얼 우측에 안내된 파라미터 SIZE 를 초과하지 않도록 수정 후 재시도 바랍니다.
2, 특정 파라미터의 파싱이 잘못된 경우 오류발생
오류가 발생된 파라미터의 파싱이 정상적으로 처리되었는지 확인바랍니다.
위 내용으로 오류확인이 되지 않는 경우,
당사로 거래요청 시 세팅한 파라미터 값 전체를 하기 메일로 첨부하여 문의부탁드립니다.
기술지원 : ts@kggroup.co.kr