ROONIX POS 사용 가이드
roonix.io로 돌아가기

최종 수정일: 2026-08-26

포스 로그인하기

ROONIX 매장관리에 로그인한 뒤 자동으로 포스로 넘어가는 SSO 방식을 설명합니다. 포스 주소를 따로 몰라도 되고, 아이디·비밀번호를 두 번 입력하지 않습니다.

SSO란 한 번 로그인하면 연결된 다른 시스템에도 아이디·비밀번호를 다시 입력하지 않고 자동으로 로그인되는 방식입니다.

사전 조건

  • ROONIX 매장관리 계정이 있어야 합니다. 계정이 없으면 먼저 가입해야 합니다.
  • 접속하려는 매장이 ROONIX 매장관리에 등록되어 있어야 합니다. 직원으로 초대받은 경우, 초대를 수락해야 매장 목록에 나타납니다.
  • 체험(무료 사용) 기간 종료나 결제 실패로 인한 안내가 [POS관리] 화면에 떠 있으면, 접속 전에 그 안내부터 처리해야 하는 경우가 있습니다 — 아래 "자주 하는 실수"의 "결제 관련 안내창" 항목 참고.

단계별 절차

  1. 브라우저에서 roonix.io에 접속해 로그인합니다.
  2. 로그인하면 자동으로 상단 메뉴의 [POS관리] 화면으로 이동합니다. 이후에도 로그인 상태에서 이 화면 주소로 다시 오면 항상 [POS관리]로 먼저 도착합니다. 최상단 메뉴에서 언제든 [POS관리]를 눌러 다시 올 수 있습니다.
  3. [POS관리] 화면에는 내가 접속할 수 있는 매장이 브랜드별로 묶여 카드 형태로 나열됩니다. 접속하려는 매장 카드에서 [POS 접속] 버튼을 클릭합니다.
    • 클릭하면 버튼이 잠깐 "접속 중..."으로 바뀌며 잠깁니다. 다시 눌러도 반응이 없다면 이미 접속을 시도하고 있는 것이니 잠시 기다립니다.
    • 이 시점에 ROONIX 매장관리가 먼저 접속 가능 여부를 확인합니다. 구독(매월 이용료를 내고 쓰는 서비스 기간)이 끝난 매장이면 포스 화면으로 넘어가지 않고 [POS관리] 화면에 바로 오류 문구가 뜹니다 — 자세한 내용은 "자주 하는 실수"의 "구독이 끝난 매장에 접속하려는 경우" 참고.
  4. 새 창이 뜨지 않고, 지금 보고 있는 창이 그대로 포스 화면으로 바뀝니다. 팝업 차단 때문에 안 열린다고 오해하지 않아도 됩니다.
  5. "로그인 처리 중..." 화면이 잠깐 나타난 뒤 "로그인 성공"으로 바뀌고, 1초 뒤 자동으로 포스의 첫 화면으로 넘어갑니다. 아이디·비밀번호를 다시 입력할 필요가 없습니다.
    • PC처럼 화면이 넓으면 판매화면으로, 스마트폰처럼 화면이 좁은 기기에서는 대시보드로 들어갑니다.

자주 하는 실수

  • 포스 주소를 즐겨찾기에 등록해둔 경우: 포스 화면 주소(예: https://내브랜드.roonix.io)를 즐겨찾기에 등록해두고 그 주소로 바로 들어가면, 로그인 세션이 살아있을 때는 문제없지만 세션이 끊긴 상태라면 포스 로그인 안내 화면이 뜨고 아이디·비밀번호 입력란은 없습니다. 포스에는 자체 로그인 화면이 없으므로, 화면의 [wbpage로 이동] 버튼을 눌러 ROONIX 매장관리에서 다시 로그인해야 합니다.

  • 브랜드 코드(매장을 구분하는 고유 코드로, 포스 접속 주소에 쓰입니다)가 설정되지 않은 경우: 직원 초대를 받은 계정의 매장 카드 아래 "브랜드 코드를 설정해야 POS에 접속할 수 있습니다"라는 문구가 보이면, [POS 접속] 버튼 자체가 눌리지 않습니다. 매장 소유주(브랜드 관리자)에게 브랜드 설정을 확인해달라고 요청해야 합니다.

  • 구독이 끝난 매장에 접속하려는 경우: [POS 접속]을 누르는 순간 ROONIX 매장관리가 그 매장의 구독 상태를 확인합니다. 구독이 끝난 매장이면 포스로 넘어가지 않고 [POS관리] 화면 위쪽에 오류 문구가 바로 뜹니다 — 본인이 그 매장의 소유주라면 "서비스 이용 기간이 만료되었습니다. 결제를 진행해주세요.", 소유주가 아닌 직원이라면 "브랜드 소유주의 서비스 이용 기간이 만료되었습니다. 소유주에게 문의해주세요."가 뜹니다. 드물게 "해당 매장에 대한 접근 권한이 없습니다."가 뜨기도 하는데, 이때는 매장 소속이 정리되지 않은 경우이니 매장 소유주에게 확인을 요청해야 합니다.

  • 결제 관련 안내창(체험 종료·결제 실패): 위와는 별개로, [POS관리] 화면에 들어가기만 해도(아직 [POS 접속]을 누르기 전에) ROONIX 매장관리가 매장의 결제 상태를 확인해 상황에 따라 안내창을 띄웁니다.

    • 체험 기간이 곧 끝나거나(7일 이내), 결제 실패 후 유예기간(7일) 중이면 안내창이 뜨지만 닫고 계속 쓸 수 있습니다. 다만 페이지에 다시 들어올 때마다 반복해서 뜹니다.
    • 체험이 끝났는데 결제수단이 없거나, 유예기간까지 지나 매장이 이미 중지된 경우에는 닫을 수 없는 안내창이 뜨고, [결제수단 등록하기]/[결제수단 변경하기] 버튼으로 결제 화면으로 이동하는 것 외에는 벗어날 방법이 없습니다(상단 메뉴로 다른 화면에 가는 것은 가능합니다). 이 상태에서는 [POS 접속] 버튼을 눌러도 접속되지 않습니다.

  • [POS 접속]을 눌렀는데 오류가 뜨는 경우: 이 오류는 포스 화면으로 넘어간 뒤 그 화면에 표시되며, 문구로 원인을 구분할 수 있습니다.

    • "유효하지 않거나 만료된 토큰입니다" — 접속 링크(SSO 토큰)에 문제가 있는 경우입니다. 시간이 오래 지나 만료됐거나, 같은 링크로 이미 한 번 접속한 뒤 새로고침·뒤로가기로 그 주소에 다시 들어간 경우에도 같은 문구가 뜹니다(접속 링크는 1회용입니다). [POS관리] 화면으로 돌아가 [POS 접속]을 다시 누르면 새 링크가 발급됩니다.
    • "비활성화된 계정입니다. 관리자에게 문의하세요." — 계정 자체가 비활성화된 경우, 또는 그 매장에 대한 접근 권한이 없는 경우(다른 매장 담당 직원 계정으로 접속을 시도한 경우 등)에도 이 문구가 뜹니다. 원인이 다를 수 있으니 관리자에게 문의할 때 어느 매장에서 발생했는지 함께 알려주는 것이 좋습니다.
    • "ROONIX에 등록되지 않은 사용자입니다." — 계정, 브랜드, 매장 정보 중 하나를 찾지 못한 경우입니다. ROONIX 매장관리 계정과 매장 소속 정보를 다시 확인해야 합니다.
    • "요청이 너무 많습니다. 잠시 후 다시 시도해 주세요." — 짧은 시간에 접속 시도가 몰린 경우입니다. 잠시 후 다시 시도합니다.
    • 그 외 "서버 오류가 발생했습니다" 또는 "네트워크 오류가 발생했습니다"가 뜨면 인터넷 연결을 확인하고 다시 시도합니다. 오류 문구 아래에 "오류 코드"가 함께 표시되니, 문의할 때 이 코드를 같이 전달하면 원인을 더 빨리 찾을 수 있습니다. [로그인 페이지로 이동] 버튼으로 처음부터 다시 시작할 수 있습니다.

관련 문서