자주묻는 질문
개발환경
Q. 개발을 위해 KICC가 지원하는 테스트 결제수단(카드 또는 계좌)이 있나요?
A. 개발 테스트를 위해 별도로 제공되는 카드 또는 계좌는 지원하지 않으며, 실 카드 또는 계좌번호를 사용하셔야 합니다. 개발(테스트) 환경에서는 실제 결제가 이루어 지지 않고, 임의로 가 승인 형태로 제공됩니다.
- 제휴 간편결제 중 카카오페이, PAYCO, SSG페이, 토스페이 머니, 네이버페이 머니, 휴대폰 소액결제 테스트거래는 실 승인이 발생할 수 있으므로 테스트 후 반드시 취소하셔야 합니다.(해당 결제승인 거래는 당일 23시에 일괄 취소처리 됩니다.)
Q. 테스트 환경에서 가상계좌 입금 테스트는 어떻게 진행할 수 있나요?
Q. 운영환경의 상점ID 및 시크릿 키는 어떻게 발급받을 수 있나요?
A. 사용할 결제 서비스에 따라 필요한 상점 ID와 시크릿 키가 다를 수 있습니다.
- 온라인 결제 서비스: 서비스 이용 절차에서 구비서류 접수 이후 발급 받을 수 있습니다.
- 간편결제 서비스: 서비스 ID와 시크릿 키는 ... 어떻게 하면 될까요?
- VAN 결제 서비스: 별도의 상점ID를 받을 필요 없이 현재 사용하고 있는 상점ID를 그대로 사용하면 됩니다.
온라인 결제
Q. 테스트 환경에서 결제한 내역은 어디서 확인할 수 있나요?
A. 테스트 가맹점 관리자에서 확인할 수 있습니다.
테스트 가맹점 관리자 로그인 ID와 비밀번호는 영업담당자를 통해 요청하시면 됩니다.
Q. 테스트할 수 있는 상점ID는 어떻게 받을 수 있나요?
A. 테스트 상점ID 신청하러 가기
테스트 MID를 신청하시면 시크릿 키도 받을 수 있습니다.
Q. 운영환경에서 온라인 결제 서비스(신용카드)를 테스트를 하려면 어떤 절차로 진행하나요?
A. 우선 테스트 연동이 완료되어 있다면 카드사 심사를 요청하셔야 해요.
카드사 심사는 실제 상품이 판매되는 쇼핑몰 사이트 또는 앱에서 결제창이 정상적으로 동작하는지 확인합니다.
이지페이에서 카드사로 심사요청을 하면 보통 영업일 기준으로 5 ~ 10일 가량 소요됩니다.
심사요청 및 진행여부는 이지페이 홈페이지 > 서비스 신청·조회에서 확인할 수 있습니다.
Q. 결제창에 특정 카드만 노출하거나 특정 간편결제사만 노출할 수 있나요?
A. 가맹점 서비스 정보 설정 또는 가맹점에서 결제 등록 API 요청 시 파라메터 지정을 통해 특정 카드사나 간편결제사만 노출하도록 설정할 수 있습니다. 가맹점 서비스 정보 설정은 계약시 지정된 KICC 영업 담당자에게 요청하시면 됩니다. 파라메터 지정은 아래와 같이 진행하시면 됩니다.
-
결제수단 타입 지정 (payMethodTypeCode) 결제 등록 API 요청 시 결제수단 타입을(payMethodTypeCode) 신용카드(11)로 지정합니다.
-
노출 영역 지정 (payMethodInfo > cardMethodInfo > displayArea) 고객에게 노출할 결제수단 노출 영역(displayArea)을 신용카드(CARD) 또는 간편결제(SPAY)로 지정합니다.
-
특정 카드 또는 간편결제 지정 3.1 신용 카드사 목록 지정 (payMethodInfo > cardMethodInfo > cardInfoList) 특정 카드만 노출하려면 신용 카드사 목록(cardInfoList)에 카드 정보 지정 3.2 간편결제 노출 목록 지정 (payMethodInfo > cardMethodInfo > usedSpayCode) 특정 간편결제만 노출하려면 간편결제 노출 목록(usedSpayCode)에 제휴서비스사 코드 지정
Q. 결제창에 다른 카드는 무이자를 적용하지 않고, 특정 카드만 무이자를 진행하고 싶어요.
A. 가맹점 서비스 정보 설정 또는 가맹점에서 결제 등록 API 요청 시 파라메터 지정을 통해 특정 카드사에만 무이자 할부를 적용할 수 있습니다. 가맹점 서비스 정보 설정은 계약시 지정된 KICC 담당자에게 요청하시면 됩니다. 파라메터 지정은 아래와 같이 진행하시면 됩니다.
-
무이자 사용 여부 지정 (payMethodInfo > cardMethodInfo > setFreeInstallment) 결제 등록 API 요청 시 무이자 사용 여부 사용(Y)로 지정
-
신용 카드사 목록 지정 (payMethodInfo > cardMethodInfo > cardInfoList) 신용 카드사 목록(cardInfoList)에 카드(cardCd)와 무이자 할부개월(freeInstallmentMonthList) 지정
Q. 결제창에 WN14 "해당 결제번호는 이전에 실패 처리된 거래입니다." 오류가 발생해요.
A. 오류원인
결제창 호출 후 카드사(또는 대외기관) 인증을 실패했던 거래의 결제창 URL을 그대로 호출해서 발생하는 문제 입니다.
해결방법
거래등록 API를 통해 결제창 호출 URL을 재요청해야 합니다.
이지페이 간편결제
Q. 테스트 환경에서 사용할 서비스 ID는 어떻게 발급받나요?
A. 계약/가맹점 담당 부서에 서비스 ID 발급 요청을 주시면 테스트 서비스 ID를 발급해드립니다.
발급받은 서비스 ID를 header의 Authorization에 추가하여 API를 요청하시면 간편결제 서비스를 정상적으로 사용하실 수 있습니다.
HTTP 헤더에 서비스 ID 추가하기 바로가기
운영 서비스 ID는 동일한 부서로 요청하시면 됩니다.
Q. 테스트 환경에서 결제수단으로 등록할 수 있는 신용카드나 은행계좌가 있나요?
A. 테스트 환경에서는 삼성카드만 결제수단으로 등록이 가능합니다.
카드 앞 6자리를 9410-09로 세팅하고 그 외의 값들은 임의 값으로 채워 등록해주시기 바랍니다.
은행계좌는 전 계좌가 등록이 가능합니다.
Q. 테스트 환경에서 계좌 인증이 안돼요.
A. 테스트 환경에서는 계좌 인증번호가 발송되지 않습니다.
인증번호로 1234를 입력하시면 정상적으로 진행됩니다.
VAN 결제
Q. 테스트 환경에서 이지톡페이 결제 테스트는 어떻게 진행할 수 있나요?
A. 영업담당자를 통해 VAN 터미널ID를 발급받아 테스트를 할 수 있습니다.
테스트 환경에서는 삼성카드만 가능 합니다.
Q. 이지톡페이는 PC환경에서 결제가 가능한가요?
A. 카드사 앱카드 결제는 모바일에서만 이용할 수 있습니다.
PC에서 결제를 진행해야 하는 경우 고객에게 문자나 알림톡으로 결제 URL을 보내거나 QR 코드를 제공하여 휴대폰으로 열 수 있도록 안내해 주시기 바랍니다.
Q. 이지톡페이 결제승인 시 '가맹점 등록 요망' 오류가 발생합니다.
A. 사용 중인 단말기에 이지톡페이가 등록되어 있지 않은 경우 발생하는 오류입니다.
영업 담당자를 통해 해당 TID의 이지톡페이 단말기 등록을 요청해 주시기 바랍니다.
해외 결제
Q. 위쳇페이에서 응답 메시지로 "NO_AUTH"를 받았어요.
A. 위쳇페이에 상점 등록이 안되어 있을 경우 발생하는 오류일 수 있으니, 반드시 KICC 영업 담당자를 통해 확인하여 주시기 바랍니다.
오류 해결
Q. R108 "중복된 요청입니다." 오류는 어떻게 해결하나요?
A. 오류원인
shopTransactionId(상점 거래고유번호) 값의 중복 사용으로 발생하는 오류입니다.
해결방법
shopTransactionId를 승인 및 취소(환불) 요청 시 당일(00시 ~ 24시)에 한하여 유니크하게 요청하시면 됩니다.
Q. R114 "메시지 인증값 검증에 실패했습니다." 오류가 발생해요.
A. 오류원인
결제취소(환불) 요청 시 msgAuthValue 값이 잘못 생성하여 발생하는 오류입니다.
해결방법
서명 데이터 구성 규칙에 맞도록 평문을 만들고, 발급받은 시크릿 키(Secret Key)로 암호화 하면 됩니다.
자세한 데이터 구성은 각 API 연동가이드 참조하세요. 또는 메시지 인증 바로가기를 참조해 주세요.
Q. R200 "등록되지 않은 가맹점입니다." 오류는 어떻게 해결하나요?
A. 오류원인
mallId(상점ID) 가 운영환경 또는 테스트 환경에 등록되지 않은 상점ID로 요청했을 경우 발생합니다.
해결방법
mallId를 운영환경으로 요청할 때는 운영 상점ID를 테스트환경으로 요청할 때는 테스트 상점ID로 요청하시기 바랍니다.