FAQ
자주 찾는 질문
1. 설치 후 정상적으로 실행되지 않는 경우
: 현재 Android 7.0 이상의 OS 환경에서만 실행 가능. Android 13에 최적화되어 작동하도록 환경 설정. 최적화가 13으로 되어있을 뿐, 더 높은 Android 버전에서도
실행 가능하지만 일부 기능이 제한될 수 있어 Android 버전은 최대 13까지 권장.
POS 장비 제조 국가 별로 실행 간에 다른 점으로 인해 문제 발생 가능성이 있어 장비에 대한 정보 필요,
국산 장비는 실행 가능.
2. 미등록 메시지 수신
1) “미등록 가맹점”
테스트 가맹점 계정이 아닌 계정으로 개발계에서 결제 서비스를 진행했을 때 서버로부터 수신되는 응답 메시지. 개발계에서 결제 테스트를 진행하고 싶은 경우, 아래 테스트 계정 사용 권장.
사업자 번호: 116-81-43939
단말기 일련 번호: 13
다운로드 비밀 번호: 0054
위 계정으로 개발계에서 테스트 결제를 진행해야 실 결제가 발생하지 않고 테스트 가능.
개발계, 운영계 설정은 App2App Sample의 상단 부분에 체크 박스로 테스트 서버, 운영 서버 선택 가능.
해당 내용은 개발 가이드 엑셀 자료 확인.
2) “미등록 단말기”
해당 응답 메시지도 위와 같은 오류일 수 있거나, KIS-ANDAGT로 필수 값을 보내지 않아
발생하는 경우도 존재.
3. 이외의 에러 상황
: KIS-ANDAGT가 갑자기 죽는 현상 or ANR(Application Not Responding) 현상
위 상황이 발생한다면 아래 양식에 맞게 영업 담당자 분께 전달 요망.
1. KIS-ANDAGT 버전 정보(KIS-ANDAGT 홈 -> 우측 하단 설정 -> 버전 확인)
2. POS 장비 정보(모델명, 유형 – 전용 장비/테블릿)
3. Android 버전 정보(설정 -> 기기 정보 -> Android 버전)
4. 연결된 리더기 정보
5. 구체적인 이슈 발생 경로
6. 로그 전송(KIS-ANDAGT 홈 -> 우측 하단 설정 -> 통신 로그 전송)
- TID와 사업자 번호 내용 必
*** 통신 로그 전송 기능이 V1060 이후로 정상화되었기 때문에 V1060 아래 버전일 경우, 담당자 분께 최신 버전 요청 후 기존 앱 삭제 후 재 설치해서 동일 증상 반복되는지 확인.
4. 모듈 업데이트
현재 KIS-ANDAGT 자동 업데이트 내용은 지원하지 않고 있습니다.
업데이트된 내용은 업체 별로 APK 설치 경로 전달 드리는 방식으로 진행하고 있으니
참고 바랍니다.
5. 서명 설정
서명 기능은 결제 금액이 50000원을 초과한 경우 발생.
서명에는 POS에서 서명을 받을 것인지, 패드가 달린 멀티 패드 OR 서명 패드에서
서명을 받을 것인지 구분.
1) POS에서 서명을 받고 싶은 경우
- KIS-ANDAGT 홈 -> 우측 하단 설정 -> 앱 기능 설정 -> POS에서 서명 허용을 사용으로 체크.
2) 패드가 있는 멀티패드에서 서명을 받고 싶은 경우
- KIS-ANDAGT 홈 -> 패드 검색 -> 연결된 방식에 따라 USB, SERIAL 선택 후
서명패드Type을 멀티 패드로 설정한 후, 리더기 검색 진행.
3) 서명 패드만을 사용해서 서명을 받고 싶은 경우
- 위와 같이 진행 후 서명패드Type을 일반으로 설정하고 패드 검색 진행.
6. 결제 테스트(샘플) 시 유의사항
1) 장비를 전달받아 샘플에서 테스트를 진행할 경우, 반드시 리더기에 최초 키 다운로드 기능을
통해 키를 주입한 뒤에, 테스트 시도.
-> 그렇지 않으면, ‘단말기 ID가 일치하지 않음’ 이라는 응답 메시지 수신.
2) 항상 운영 서버인지, 개발 서버인지 체크.
- 개발 서버에 등록된 TID의 경우 정상 동작.
-> 테스트 계정의 TID가 아니면 등록이 되어 있지 않기 때문에 반드시 체크 必.
3) 샘플의 상단바와 하단바를 사라지게 하고 싶은 경우 스크린 모드를 체크.
4) 카카오 페이의 경우 개발계에서 테스트 가능한 바코드가 따로 존재.
-> 개인이 생성한 바코드 or QR 코드로 테스트 불가.
-> 개인이 생성한 코드로 테스트할 경우, 운영 서버에서 테스트 권장.
7. 기기 검색 구분
1) 리더기 검색 – IC 카드를 읽을 수 있는 리더기를 연결할 수 있는 기능.
- 검색 내에 연결 방식에 따라 구분.
* 지원하는 연결 방식: USB, SERIAL, 블루투스(CBP-2200), *KIS-POS(센텀 POS 장비 내장 리더기)
2) 서브 리더기 검색 – 주 연결 리더기로는 NR-100을 사용하며, RF 기능을 가진 리더기를 연결하고자 할 때 사용.
* 지원하는 연결 방식: USB, SERIAL
3) 패드 검색 – 패드가 달린 리더기를 연결할 때 사용하는 기능으로, 검색 탭 내에 TYPE 변경으로 사인만 받을 것인지, IC 리딩과 사인을 동시에 처리할 것인지 설정 가능.
* 지원하는 연결 방식: USB, SERIAL
4) 단말기 검색 – CAT 단말기를 연결하고자 할 때 사용하는 기능으로 주로 KIS-1421, KIS-1420 단말기를 연결.
* 지원하는 연결 방식: USB, SERIAL, LAN(TCP/IP 통신)
Last updated
