Toss PG POS Agent �운영 매뉴얼

< TOSS 전용 >

Guide 목차

1. POS 설치 프로그램� 1-1. 일반(오픈망)/폐쇄망 확인사항� 1-2. 설치 프로그램 리스트��2. POS 로그인 화면� 2-1. 기본 화면 설명 (로그인 전)

�3. POS 메인 화면� 3-1. 세부 화면 설명 (로그인 후)� 3-2. Setting 순서��4. Setting 및 기능 설명� 4-1. 환경 설정� 4-2. 상점 등록� 4-3. 무결성 점검� 4-4. 프로그램 종료

​

5. 참고 사항� 5-1. 참고 사항 안내

​

5. Setting 관련 기본 FAQ

1. POS 설치 프로그램

1. 설치 진행 전에 먼저 현재 망 환경을 확인해주세요.

​

• 기존 망 환경에 따라 일반(오픈망)과 폐쇄망 버전을 반드시 구분하여 프로그램을 설치해주시기 바랍니다.�- 일반은 일반 다운로드 링크로 진행�- 폐쇄망은 폐쇄망 다운로드 링크로 진행�→ 교차하여 설치할 경우 에러가 발생됩니다.

​

• 해당 링크로 접속이 안될 경우, 브라우저에 해당 링크 전체를 [복사-붙여넣기]로 진행해주세요.�(붙여넣기 시에 빈칸이 없도록 확인하여 진행해주세요.)�→ 링크 잘못 입력으로 인한 오류가 아닌 접속 오류는� 먼저 내부 다운로드 권한 설정을 확인해주세요.��* 내부 권한 설정 변경이 어려운 경우에는 � techsupport@tosspayments.com로 문의해주세요.

​

• 업데이트 버전 설치 진행 또는 교차하여 잘못 설치를 진행한 경우, 파일 삭제 후 다시 진행해주세요.

​

​

1-1. 일반(오픈망)/폐쇄망 확인사항

1. POS 설치 프로그램

1. 설치가 완료되면 왼쪽 화면과 같이 setting 됩니다.

​

• 설치 위치는 C:\TossPGPOS 입니다.�폴더 이름 및 설치 위치는 변경되지 않도록 주의해주세요.

​

• TossPGPOSAgent.exe(승인 중계 프로그램)는�POS 프로그램에서 요청한 거래를 승인 처리하는 프로그램입니다.

​

• TossPGPOSOlineUPdater.exe는�POS 프로그램(OS) 재실행 시에 버전을 체크하여 자동 업데이트 하는 모듈이며, 기존 파일을 백업하도록 되어 있습니다.

​

• TossPGPOSClient.dll(승인 중계 연동 DLL)과�TossPGPOSClientAX.ocx(승인 중계 연동 OCX)는 POS와 에이전트의 중계 모듈입니다.

​

• TossPGPOSReader.dll(보안 리더기 제어 모듈)은 TossPGPOSReader.dll을 통해 보안 리더기를 제어합니다.

​

• TossPGPOSComm.dll(키다운로드 통신 모듈)은 키다운로드 요청 시에 UVANPosApp.dll을 통해 통신합니다.

​

• XPayClientMT.dll(승인 통신 모듈)은�승인 요청 시에 XPayClientMT.dll을 통해 결제서버와 통신합니다.

​

• TossPGPOSWeb.exe(크롬 샘플 통신 모듈)는�TossPGPOSClient.dll과 TCP/IP의 통신을 위한 모듈입니다.

​

• BackUpConfig.ini와 VERSION.CFG, verget.txt psftp.exe, psftp.txt 파일은 자동 업데이트 관련하여 환경 설정 및 실행 파일입니다.

1-2. 설치 프로그램 리스트

2. POS 로그인 화면

1. TossPGPOS.exe를 실행해주세요.

​

• 로그인 화면에서 아이디와 비밀번호를 입력 후�[로그인] 버튼을 클릭하세요.�→ 로그인 초기 설정 값은 ID: 0000 / PW: 1234 입니다.

​

• 신용카드 승인, 취소 처리는 로그인을 하지 않아도 가능합니다. 참고해주세요.

​

• 빨간색 박스 내 무결성 검사 여부, 하드웨어버전, 소프트웨어버전은 현재 PG POS 버전을 표시합니다.�(하드웨어버전, 소프트웨어버전은 식별번호를 의미해요.)

​

• [창 최소화] 버튼을 클릭하면 해당 창이 사라지며,�트레이에서 프로그램 확인이 가능합니다.

2-1. 기본 화면 설명 (로그인 전)

3. POS 메인 화면

▲ 메인 화면 실행

1. 로그인 후 보이는 메인 화면에서는�[상점등록], [무결성 점검], [환경설정]이 가능합니다.

​

• 설치 진행에서 Setting 순서는 반드시 [환경설정] → [상점등록] → [무결성 검사] 순으로 진행해주세요.�각 항목의 상세 설명은 다음 페이지 설명을 확인해주세요.

​

• [창 최소화] 버튼을 클릭하면 해당 창이 사라지며,�트레이에서 프로그램 확인이 가능합니다.

3-1. 세부 화면 설명 (로그인 후)

< 창 최소화 화면 >

4. Setting 및 기능 설명

▲ 환경설정 화면 실행

4-1. 환경 설정

1. 키오스크 여부 : 키오스크 설정 시에 에이전트 UI가 키오스크에 맞게 변경됩니다.

​

• IC 리더기 포트 : IC 리더기가 연결되어 있는 COM포트를 설정하는 것으로, 리더기 사용을 위해 반드시 설정해주세요. �→ IC 리더기 포트 설정 선택지가 다수인 경우, 각 선택지마다 시도하여 결제 가능한 COM포트 확인을 진행해주세요.

​

• 2nd Generation : 승인 이후 카드사에서 온 응답에 대한 데이터의 정상 여부를 검증하는 기능입니다.�보안상 해당 항목 설정을 “사용”으로 권장 드립니다.

​

• 아이디와 비밀번호 로그인 초기 설정 값은�ID: 0000 / PW: 1234 입니다.�→ Default 값에서 변경을 권장 드리지 않으며, 원하시는 경우 변경은 가능하나 아이디와 비밀번호를 잊어버리지 않도록 주의해주세요.

​

• 위 외의 설정 항목은 에이전트와 서버 통신 모듈의 설정 값으로, Default 값을 유지하시길 권장 드립니다.

​

• 전체 환경 설정이 완료된 후, [정보저장] 버튼을 클릭해주세요.

​

​

1. 가맹점 정보를 등록하기 위해 빨간 박스를 작성해주세요.�(가맹점명, 대표자명, 사업자번호, 시리얼번호)

​

• 사업자번호 입력 시 10자리가 맞는지 꼭 확인해주세요.�→ 자릿수를 오류 입력하면 등록 확인 메시지 창이 뜹니다.

​

• 시리얼번호는 POS에 연결하는 리더기 하단의 “일련번호”를 의미하며, 반드시 작성해주세요.�→ 일련번호가 10자리인 경우, 일련번호 앞에 00을 붙여 12자리를 꼭 맞춰주세요.

​

​

​

​

​

​

• 위 가맹점 정보를 다 작성한 후, 상점ID와 Mert Key를 입력하고 [정보저장] 버튼을 클릭해주세요.�(상점ID와 Mert Key는 최대 10개까지 등록 가능)�→ 단, [정보저장] 버튼을 누르면 KEY상태가 초기화 되므로 반드시 해당 step 이후에 [KEY 다운로드]를 진행해주세요.��* XC01오류 메시지 창은 상점ID 또는 Mert Key가 잘못 설정되어 발생하는 오류입니다. 상점ID와 Mert Key를 붙여넣기 하실 때 앞/뒤 공백 없이 해당 값만 입력하였는지 확인해주세요.

​

• 4번까지 진행 후 [KEY 다운로드] 버튼을 클릭하여 키를 다운로드 해주세요.

​

• 다운로드 후 최종적인 KEY상태 메시지를 확인해주세요.� → 성공 or 실패�* 성공일 경우, 확인 후 창 닫기 진행�* 실패일 경우, 에러 메시지 확인 후 위 절차 다시 진행

​

• [정보저장] 이후 수정 사항이 발생하는 경우에는 Mert Key를 다시 입력하여 진행해주시기 바랍니다.

4. Setting 및 기능 설명

▲ 상점 등록 및 KEY 다운로드 화면 실행

4-2. 상점 등록

* 리더기 하단의 정보에서� 10~12자리의 일련번호를 확인해주세요.

4. Setting 및 기능 설명

▲ 무결성 검사 화면 실행

1. 무결성 검사는 상점ID-Mert Key와 리더기의 인증을 체크하는 최종 단계입니다.

​

• 앞 페이지와 같이 KEY 다운로드가 완료되면,�[무결성 검사] 버튼을 반드시 클릭해주세요.�→ 검사모드에 “수동”으로 표시됩니다.

​

• 내역을 확인하고 싶은 경우, 시작일과 종료일을 선택 후�[결과조회] 버튼을 클릭하여 무결성 점검 내역을 조회할�수 있습니다.

​

• 환경 설정 단계에서 <무결성주기 체크> 항목을�설정하실 경우, 일정 주기마다 자동으로 점검되며 검사모드가 “자동”으로 표시됩니다.

​

• 점검 실패 시에는 검사결과에 “실패”로 나타납니다.�* 이 경우 신용카드 승인, 취소가 불가능합니다.�* 단, 현금영수증 서비스는 진행 가능합니다.

4-3. 무결성 검사

4. Setting 및 기능 설명

▲ 트레이 프로그램 종료 화면

1. 트레이 화면에서 왼쪽 아이콘에 대하여�마우스 오른쪽 클릭 후에 나오는 빨간 박스 메뉴에서�[종료] 버튼을 클릭하여 프로그램을 종료합니다.

4-4. 프로그램 종료

cf. USB to RS232 케이블 규격

USB to RS232 Cable Female (미지원)

USB to RS232 Cable Male (지원)

듀얼아이 카드리더기는 1USB + 1Serial (Female) 포트로 제공됩니다. 따라서 별도 구매하시는 USB to RS232 케이블은 반드시 Male 규격으로 구매 후 연결해주시기 바랍니다.

5. 참고 사항

1. 추가적인 문의사항이 있으시면 아래로 이메일 또는 고객센터로 문의해주세요.�- 고객센터 : 1544-7772�- 이메일 : support@tosspayments.com

​

​

​

• 가이드에 따라 설치 진행에서 기술적 오류가 발생할 경우 아래 이메일로 문의해주시기 바랍니다.�- 이메일 : techsupport@tosspayments.com

5-1. 참고 사항 안내

6. Setting 관련 기본 FAQ

1. Windows 키를 누른 상태에서 R 키를 눌러 devmgmt. msc을 입력하고 확인을 클릭해서 장치관리자를 실행합니다.
2. 포트(COM & LPT) 항목을 클릭하여 USB Serial Port (COM X) 로 표기되는 항목의 숫자를 확인합니다.
3. 확인된 포트번호를 TOSS PG POS 환경설정의 IC리더기 포트번호로 지정합니다.

​

(만일 장치관리자에서 USB Serial Port 가 확인되지 않을경우 Page 14 의 FAQ 3) 를 참고하여 조치한 후 다시 포트번호를 확인하시기 바랍니다.

1) IC 리더기의 포트는 몇번을 설정해야 하나요?

6. Setting 관련 기본 FAQ

단말기에서 점유한 COM포트가 다른 장치와 충돌되었을 가능성이 매우 높습니다. 아래의 순서로 조치해보시기 바랍니다.

​

2) 장치관리자에서 “연결실패”로 확인되고, 다른 USB장치도 작동이 되지 않습니다.

​

정상적으로 작동되다가 PC만 재부팅하면 연결이 되지 않습니다.

• Win 키+ R 을 눌러 devmgmt. msc을 입력하고 확인을 클릭해서 장치관리자를 실행합니다.
• 장치관리자 상단 보기 > 숨김장치표시를 체크합니다.
• 범용직렬버스 컨트롤러를 클릭하여, 흐리게 표시된 장치 중 알수없는 USB장치를 선택 > 우클릭 후 삭제합니다.

(드라이버도 함께 삭제 항목에 체크)

4. COM & LPT 포트를 클릭한 후, 흐리게 표시된 장치를 모두 우클릭하여 삭제합니다 (흐리게 된 것은 모두 삭제해야 합니다)

​

주의 : 진하게 표시된 장치를 삭제하게 되면, 다른 정상적인 장치가 작동되지 않습니다. 반드시 흐리게 표시된 장치만 삭제해주시기 바랍니다.

5. 장치관리자 상단의 돋보기아이콘(새로고침)을 클릭하면, 장치가 새로 인식됩니다. COM & LPT 포트 항목의�Prolific USB-to-Serial Comm Port 가 정상적으로 인식되는지 확인하고, 함께 기재된 COM포트번호를 확인합니다.

​

6. Page13의 FAQ1 내용을 참고하여 agent프로그램의 포트를 재설정하면 됩니다.

6. Setting 관련 기본 FAQ

1. 연결 중인 리더기의 종류를 확인합니다.

​

2) [ a일 경우 ]

=> 다른 USB포트에 연결을 해 봅니다. 다른 USB기기는 정상작동중인지 확인합니다.

둘 다 이상이 없을경우, 토스페이먼츠 고객센터 (support@tosspayments.com) 으로 단말기 교체요청을 해주시기 바랍니다.

​

[ b일 경우 ]

=> 이 모델은 USB : 전원부, serial : 데이터통신 을 처리하기 때문에, 반드시 두 곳이 모두 PC에 연결되어야 합니다.

serial 포트가 있는 PC일 경우, serial 케이블을 직접 연결합니다. 만일 PC에 serial 포트가 없을 경우, USB to RS232 Serial 케이블을 별도 구매하여 연결합니다. (그림 c)

=> 케이블 연결이 정상일경우, 다른 USB포트에 연결을 해 봅니다. 다른 USB기기는 정상작동중인지 확인합니다.

둘 다 이상이 없을경우, 토스페이먼츠 고객센터 (support@tosspayments.com) 으로 단말기 교체요청을 해주시기 바랍니다.

​

만일 USB포트를 변경했는데도 장치관리자에서 나타나지 않으면, RS232 케이블의 불량일 가능성이 매우 높습니다. 여분의 케이블로 교체후 재확인해주시기 바랍니다.

​

3) 장치관리자에서 USB Serial Port 가 표시되지 않을 때는 어떻게 해야 하나요?

1. USB only cable / 모델명 D633RK로 시작

b. USB + serial cable / 모델명 D633RL로 시작

c. USB to RS232 Serial 케이블

6. Setting 관련 기본 FAQ

Page 8 및 9의 설정과 , 케이블연결을 모두 확인했음에도 위 에러가 발생하는 경우가 있습니다.

windows->시작->실행->cmd 입력후 확인을 하면 명령프롬프트가 실행됩니다. 이곳에 telnet 127.0.0.1 10002 를 입력후 엔터를 누릅니다.

​

1. 텔넷연결 실패시 : Page13의 내용을 확인하여 조치합니다.

​

b. 텔넷연결이 성공인데 “리더기상태가 올바르지 않습니다” 에러 발생시

=>내컴퓨터 > C:\TossPGPos\TossPGPOSOnlineUpdater.exe 를 실행합니다. 이 과정을 진행시 포트가 초기화됩니다. 이후에도 동일시

=> POS Agent 프로그램을 제거 후 재설치합니다.

재설치 후에도 동일할 경우, 토스페이먼츠 고객센터 (support@tosspayments.com) 으로 단말기 교체요청을 해주시기 바랍니다.

4) “리더기 상태가 올바르지 않습니다. 리더기 상태를 확인해 주십시오.” 발생 시 어떻게 해야 하나요?

에러화면

텔넷연결 실패

텔넷연결 성공

6. Setting 관련 기본 FAQ

1. 별도로 방화벽정책을 운영하지 않을경우 : PC 에 설치된 윈도우 방화벽 및 백신프로그램의 방화벽설정을 잠시 해제후 테스트를 해보시기 바랍니다.

​

b. PC 방화벽 해제시 정상적으로 작동될 경우

=> https://docs.google.com/document/d/1kyhcyXmaRuxZAlNJ_Oiuo2EoFVMlQbHZewZW40E6u2w/edit?usp=sharing

(XPAY_결제모듈_공통사항_v.1.0.3.doc) 의 “6.1 결제,취소,부분취소, 현금영수증발급 등 XPay API” 에 명시된 목적지 IP와 포트에 대해 방화벽오픈 예외처리 설정을 해주시기 바랍니다.

​

c. 사내보안정책등으로 외부와 통신이 어려울 경우에는, 사내보안담당자에게 요청하여 방화벽 오픈요청을 해주시기 바랍니다.

(방화벽 오픈 대상 IP와 포트는 b의 내용을 참고)

​

4) Pos Agent 프로그램이 설치된 PC가 방화벽문제로 접속이 불가할 경우에는 어떻게 해야 하나요?