토스 단말기 설치 후 연동이 제대로 됐는지 확인하는 방법

토스 단말기 연동이 끝났는지는 테스트 결제 한 번으로 확인합니다. 1,000원 미만의 임의 결제를 넣고 클래스업 결제 내역에 즉시 반영되는지, 환불 처리까지 정상 작동하는지 두 가지만 보면 됩니다. 단말기 화면에 "연결됨"이 떠 있어도 클래스업 쪽 수납 내역과 매칭이 안 되는 경우가 실제로 자주 생깁니다.

🔌 설치 직후 단말기 화면에서 보이는 것과 실제 연동은 다릅니다

단말기를 켜면 와이파이나 유심이 잡히는 순간 "연결됨" 혹은 초록 불이 뜹니다. 이건 통신 연결이 됐다는 표시일 뿐, 클래스업 학원 코드와 매칭됐다는 뜻은 아닙니다.

그래서 단말기만 켜놓고 끝냈다가 수납 내역이 클래스업에 안 쌓이는 경우가 실제로 많습니다. 아래 두 가지를 분리해서 체크하세요.

✅ 테스트 결제로 10분 안에 끝내는 확인 절차

가장 확실한 방법은 소액 결제를 직접 넣어보는 것입니다. 아래 순서대로 하면 10분 이내에 연동 상태를 끝까지 확인할 수 있습니다.

1. 단말기에서 500원~900원 사이 임의 금액으로 테스트 결제를 진행합니다
2. 클래스업 관리자 화면의 결제·수납 내역 메뉴를 열어 방금 결제가 뜨는지 확인합니다 (보통 1분 이내 반영)
3. 내역에 뜬 결제 건의 학원명·결제 금액이 실제로 결제한 내용과 일치하는지 대조합니다
4. 해당 결제를 바로 환불(취소) 처리해서 취소도 정상 반영되는지 확인합니다
5. 문제가 없으면 테스트 완료, 이상이 있으면 아래 표의 증상을 참고해 원인을 좁힙니다

⚠️ 증상별로 원인이 갈립니다

연동이 안 됐을 때 증상은 세 갈래로 나뉘고, 각각 확인해야 할 곳이 다릅니다. 증상만 보고 바로 재설치하지 말고 아래 표로 원인을 먼저 좁히세요.

증상	가능성이 높은 원인	확인할 곳
테스트 결제는 됐는데 클래스업에 안 뜸	단말기와 클래스업 학원 코드 매칭 누락	클래스업 관리자 > 결제 설정 > 단말기 연결 상태
결제 자체가 안 됨 (단말기 오류)	통신 불량 또는 유심·와이파이 미설정	단말기 화면의 네트워크 표시
결제는 되는데 금액이 다르게 찍힘	단말기에 등록된 가맹점 정보 중복 설정	토스페이먼츠 가맹점 관리 화면
환불이 클래스업에 반영 안 됨	환불을 단말기에서만 처리, 클래스업 미동기화	클래스업 결제 내역에서 직접 취소 처리했는지

📞 혼자 못 찾겠으면 이 순서로 연락하세요

테스트 결제까지 했는데도 클래스업에 반영이 안 된다면, 원인을 더 파기보다 24시간 안에 바로 연락하는 것이 빠릅니다. 담당이 다르니 순서를 지키면 헛걸음이 줄어듭니다.

단말기 자체 오류(화면 멈춤, 통신 불가)는 토스페이먼츠 고객센터, 클래스업 내역 미반영은 클래스업 고객센터로 나눠서 문의하세요.

🗂 최종 점검 체크리스트

아래 네 가지를 모두 통과하면 연동 설치가 끝난 것입니다. 하나라도 걸리면 위 표로 돌아가 원인을 먼저 좁히세요.