도움말 센터
질문과 답변
크레딧, 패키지, 라인, 재생 링크, 디바이스가 어떻게 작동하는지, 그리고 재생되지 않을 때 무엇을 확인해야 하는지 안내합니다.
전체 139개 중 139개 질문
이 페이지 사용 방법
모든 질문에는 고정 코드가 있습니다(예:LINE-07). 지원팀에 문의할 때 이 코드를 알려 주시거나 질문 링크를 복사해 전달하세요.
메뉴, 버튼, 필드 이름은 패널에 표시되는 그대로 적었습니다.사용자(user)는 패널에 로그인하는 계정(관리자, 리셀러)이고,라인(line)은 시청자의 IPTV 구독입니다. 두 개념은 절대 섞이지 않습니다.
- 시청자 리셀러가 이 답변을 그대로 시청자에게 전달할 수 있습니다
- 관리자 패널 운영자용
서비스 개요와 역할 분담
GENGEN-01 이 서비스는 무엇을 제공합니까?
완전한 OTT / IPTV 시스템을 제공합니다. 관리 패널(대시보드), 시청자 앱용 API 서버, 라이브 채널·영화·시리즈·라디오 전송, 웹 플레이어가 포함됩니다. 시스템은 저희가 제공하고 유지 관리하며, 리셀러는 이를 사용해 고객에게 시청 권한(라인)을 제공합니다.
GEN-02 이 서비스가 하지 않는 일은 무엇입니까?
GEN-03 시스템에서 누가 누구입니까?
| 역할 | 누구인가 | 로그인 위치 |
|---|---|---|
| 관리자 | 패널 운영자 | 대시보드 |
| 리셀러 | 라인을 판매하며 관리자에게서 크레딧을 받음 | 대시보드, Reseller API |
| 서브 리셀러 | 다른 리셀러 아래에 만들어진 리셀러 | 대시보드, Reseller API |
| 라인 | 구독자 — 최종 시청자 | IPTV 앱, 셋톱박스, 웹 플레이어. 대시보드는절대불가 |
GEN-04 채널이 시청자에게 전달되기까지 어떤 단계를 거칩니까?
- 관리자가 카탈로그(채널, 영화, 시리즈, 라디오)를 구성하고부케로 묶습니다.
- 관리자가패키지를 만듭니다: 부케 + 기간 + 동시 접속 수 + 크레딧 가격.
- 리셀러가 크레딧을 사용해 패키지를 판매합니다 → 시스템이라인을 생성합니다.
- 고객이 앱에 라인 정보를 입력하면 시스템이 라인을 확인(만료 여부, 활성화 여부, 제한 범위)한 뒤 적절한 서버에서 재생합니다.
GEN-05 리셀러는 콘텐츠로 무엇을 할 수 있고 무엇을 할 수 없습니까?
GEN-06 지원은 어디에서 받습니까?
사이드바의Support항목을 누르면 별도의 지원 사이트가 열립니다. 패널에는 자체 티켓 시스템이 없습니다. 문의할 때는 라인의 사용자 이름(비밀번호는 절대 보내지 마세요), 발생 시각, 앱 / 디바이스, 이미 시도해 본 경우 이 페이지의 질문 코드를 함께 보내 주세요.
GEN-07 인터페이스는 어떤 언어를 지원합니까?
패널, 웹 플레이어, 이 도움말 페이지에는 27개 언어를 지원하는 언어 전환기가 있습니다. 영어와 베트남어가 기준 번역이며, 다른 언어에서는 새로 추가된 화면이 한동안 영어로 남을 수 있습니다. 패널이 보내는 이메일은 현재 영어로만 발송됩니다.
패널 계정과 로그인
ACCACC-01 고객이 대시보드에 로그인할 수 없는 이유는 무엇입니까?
의도된 설계입니다. 라인은 패널 계정이 아닙니다. 고객은 라인 정보를 IPTV 앱, 셋톱박스, 웹 플레이어에서만 사용합니다. 반대로 리셀러 계정으로는 채널을 시청할 수 없습니다.
ACC-02 이 페이지에서 설명하는 것보다 메뉴가 적게 보입니다. 왜 그런가요?
메뉴와 작업은 관리자가 계정에 지정한그룹에 따라 달라집니다. 그룹에 권한이 없는 페이지는 사이드바에 표시되지 않으며 열 수 없습니다. 더 많은 권한이 필요하면 관리자에게 요청하세요.
ACC-03 패널 비밀번호는 어디에서 변경합니까?
계정 영역(프로필 → 비밀번호 변경)에서 변경합니다. 패널 비밀번호는 해시되어 저장되며 관리자를 포함해 누구도 다시 읽을 수 없습니다. 잊어버렸다면 상위 계정(상위 리셀러 또는 관리자)에 새 비밀번호 설정을 요청하세요.
ACC-04 네트워크를 바꾸면 왜 로그아웃됩니까?
패널은 IP 주소가 바뀌면 세션을 종료하도록 설정할 수 있으며, 탈취된 세션을 재사용하지 못하게 하기 위한 것입니다. 다시 로그인하세요. 관리자 설정입니다.
ACC-05 로그인에 여러 번 실패하면 어떻게 됩니까?
패널은 로그인 실패 횟수를 제한합니다(관리자가 설정). 한도를 넘으면 다시 시도하기 전에 기다려야 합니다.
ACC-06 데모 계정은 실제 계정과 어떻게 다릅니까?
데모 계정은 인터페이스만 보여 줍니다. 비밀번호 변경, 프로필 편집, 활성화 코드 생성 등 되돌릴 수 없는 작업은 할 수 없습니다.
ACC-07 내 계정이 "비활성화"되었습니다. 무슨 뜻입니까?
상위 계정이 계정을 껐다는 뜻입니다. 패널에 로그인할 수 없고 API 키도 거부됩니다. 이미 판매한 라인은 삭제되지 않습니다. 상위 계정에 문의하세요.
크레딧
CRDCRD-01 크레딧이란 무엇입니까?
패널의 선불 단위입니다. 모든 판매(라인 생성, 갱신, 활성화 코드 생성, 서브 리셀러 생성)는 패키지 가격 또는 그룹 요금에 따라 크레딧을 차감합니다. 크레딧은 돈이 아니며 패널이 환산해 주지도 않습니다. 크레딧 1개의 가치는 본인과 상위 계정 간에 합의합니다.
CRD-02 크레딧은 어떻게 충전합니까?
크레딧은 위에서 아래로 흐릅니다. 관리자가 리셀러에게 크레딧을 주고, 리셀러가 서브 리셀러에게 이체합니다. 상위 계정에 대한 결제는 패널 밖에서 이루어집니다.
CRD-03 누구의 크레딧이 차감됩니까?
라인이 하위 서브 리셀러에게 배정되더라도 항상작업을 수행하는 계정의 크레딧이 차감됩니다.
CRD-04 크레딧 내역은 어디에서 봅니까?
Credits페이지에서 봅니다. 변동마다 한 행씩 날짜, 금액, 이후 잔액, 사유, 수행자가 표시됩니다. 이것이 원장이며 잔액의 공식 기준입니다.
CRD-05 크레딧이 부족하면 어떻게 됩니까?
작업 전체가 거부됩니다. 라인이 생성되지 않고 아무것도 차감되지 않습니다. 잔액은 절대 마이너스가 되지 않습니다.
CRD-06 저장을 두 번 누르거나 네트워크가 끊기면 두 번 차감됩니까?
아니요. 모든 판매 요청에는 요청 ID(request_id)가 포함되며, 같은 ID를 다시 보내면 이전 결과가 반환됩니다. 라인 생성과 크레딧 차감은 항상 함께 성공하거나 함께 취소됩니다.
CRD-07 라인을 삭제하면 크레딧이 환불됩니까?
CRD-08 서브 리셀러에게 이체한 크레딧을 회수할 수 있습니까?
예. 서브 리셀러의 편집 양식에서 크레딧 이체 필드에 음수를 입력하세요. 어떤 잔액도 0 아래로 내려갈 수 없습니다.
CRD-09 라인을 몇 개나 구매할 수 있는지 미리 알려면 어떻게 합니까?
라인 양식의 패키지 선택기에 본인 가격이 표시됩니다. API에서는pricing액션이 잔액, 각 패키지 가격, 구매 가능한 수량을 반환합니다.
패키지, 부케, 가격
PKGPKG-01 부케와 패키지의 차이는 무엇입니까?
부케는 콘텐츠(채널, 영화, 시리즈) 목록입니다.패키지는 판매하는 상품으로, 하나 이상의 부케, 기간, 동시 접속 수, 출력 형식, 잠금, 크레딧 가격(정식 가격과 체험 가격)으로 구성됩니다.
PKG-02 특정 패키지가 보이지 않는 이유는 무엇입니까?
패키지는 관리자가 지정한 그룹만 판매할 수 있습니다. 내 그룹용이 아닌 패키지는 선택기에 나타나지 않으며 API로 보내면 거부됩니다.
PKG-03 내 가격이 패키지 가격과 다른 이유는 무엇입니까?
관리자는 각 패키지에 대해 리셀러별개별 가격(0 = 무료)을 지정할 수 있습니다. 개별 가격은 정식 라인 생성, 갱신, 정식 활성화 코드에 적용되며 체험에는 적용되지않습니다.
PKG-04 관리자가 패키지의 부케를 변경하면 이미 판매된 라인도 바뀝니까?
아니요. 부케는 판매 시점에라인으로 복사되므로 이후 패키지를 편집해도 이미 판매된 라인에는 영향이 없습니다. 라인은 다음 갱신 / 패키지 변경 때 패키지의 새 부케를 받습니다. (부케안의콘텐츠가 바뀌면 그 부케를 가진 모든 라인에 즉시 반영됩니다. 부케를 삭제하면 모든 라인과 패키지에서 해당 ID가 제거됩니다. 전체 부케 순서를 바꿔도 "판매된 라인과 패키지에 적용" 상자를 체크한 경우에만 판매된 라인에 저장된 순서가 바뀌며, 라인의 부케 구성 자체는 바뀌지 않습니다.)
PKG-05 패키지의 일부만 판매할 수 있습니까?
그룹에Allow Bouquet Selection이 켜져 있을 때만 가능합니다. 패키지 부케 중 일부를 체크하며, 아무것도 체크하지 않으면 패키지 전체이고, 패키지에 없는 부케는 제외됩니다. 가격은 변하지 않습니다.
PKG-06 라인의 어떤 속성이 패키지에 의해 결정됩니까?
PKG-07 "MAG 전용" / "Enigma 전용" 패키지란 무엇입니까?
해당 종류의 셋톱박스에만 판매할 수 있는 패키지로, 일반 라인이나 다른 디바이스 유형에는 판매할 수 없습니다. 반대로 Add MAG / Add Enigma 양식에서 사용하려면 패키지가 해당 디바이스 유형을 허용해야 합니다.
라인: 생성, 편집, 갱신, 삭제
LINELINE-01 라인을 만들려면 무엇이 필요합니까?
그룹이 판매할 수 있는 패키지를 선택해야 하고 크레딧이 충분해야 합니다. 사용자 이름 / 비밀번호는 직접 입력하거나(그룹이 허용하는 경우) 비워 두어 자동 생성하게 할 수 있습니다. 관리자는 라인을 만들 때 둘 중 하나(또는 둘 다)를 비워 둘 수도 있으며, 시스템이 10자를 생성해 저장 직후 표시합니다.편집양식에는 여전히 사용자 이름이 필요합니다.
LINE-02 사용자 이름 / 비밀번호를 직접 고를 수 없는 이유는 무엇입니까?
그룹에서Allow Username Change/Allow Password Change가 꺼져 있어 새 라인에 생성된 값이 사용됩니다. 직접 입력할 수 있는 경우 최소 길이는 그룹에서 정합니다(기본 8자).
LINE-03 라인 비밀번호는 어디에서 다시 볼 수 있습니까?
라인의 편집 양식과 Lines 목록의Generate play link대화상자에서 볼 수 있습니다. IPTV 앱과 플레이리스트 링크에 필요하므로 라인 비밀번호는 읽을 수 있는 형태로 보관됩니다. 생성된 비밀번호는 저장 직후 표시됩니다.
LINE-04 오래된 라인에 비밀번호가 표시되지 않고 고객이 로그인할 수 없습니다?
이전 버전의 패널에서 만든 일부 라인은 해시된 비밀번호만 가지고 있습니다. 이런 라인은로그인할 수 없으며패널에도 비밀번호가 표시되지 않습니다. 라인의 편집 양식에서 새 비밀번호를 설정하고 고객에게 전달하세요.
LINE-05 판매 후 리셀러는 라인에서 무엇을 편집할 수 있습니까?
활성화 / 비활성화, 리셀러 메모, 연락처, 카테고리 템플릿, 소유자(본인의 하위 계정 범위 내), 그룹이 허용하는 경우 사용자 이름과 비밀번호, 그룹에Allow Line Restrictions가 켜져 있으면 제한(IP, 사용자 에이전트, ISP 잠금), 그룹이 허용하는 경우 패키지 범위 내의 새 부케 선택입니다. 패키지, 만료일, 동시 접속 수, 체험 플래그, 출력 형식, 디바이스 잠금, 국가는 직접 편집할 수없으며갱신 / 패키지 변경을 통해서만 바뀝니다.
LINE-06 라인은 어떻게 갱신합니까?
방법은 두 가지이며 규칙은 하나입니다.
- 목록의Renew (charged)버튼: 라인의 현재 패키지를 사용합니다.
- 편집 양식의Extend with package필드: 판매할 수 있는 아무 패키지나 선택합니다(패키지 변경도 이 방법입니다).
라인을 편집하면서 같은 저장에서 갱신도 선택하면 둘은하나의 트랜잭션입니다. 갱신이 거부되면(크레딧 부족, 판매할 수 없는 패키지) 편집도 저장되지않고크레딧도 차감되지 않습니다. 수정한 뒤 다시 저장하세요.
LINE-07 갱신할 때 남은 시간이 유지됩니까?
- 라인이만료되지 않았고새 패키지가 이전 패키지와호환되는 경우 → 현재 만료일에 기간이 더해집니다.
- 라인이만료되었거나두 패키지가 호환되지 않는 경우 → 오늘부터 계산되며 남은 시간은 유지되지 않습니다.
"호환" 여부는 새 패키지에 호환성 검사 옵션이 켜져 있을 때만 확인합니다. 두 패키지의 부케, 출력 형식, 동시 접속 수, restreamer 플래그, 디바이스 잠금이 같아야 합니다. 옵션이 꺼져 있으면 항상 호환되는 것으로 봅니다. 새 패키지는 기본적으로 옵션이 켜져 있으며(관리자가 끌 수 있음), 기존 패키지는 설정을 유지합니다. MAG / Enigma 라인은 해당 종류의 박스를 허용하는 패키지로만 갱신하거나 변경할 수 있습니다.
LINE-08 패키지 변경(업그레이드 / 다운그레이드)은 어떻게 과금됩니까?
패키지 변경 = 새 패키지의 정식 기간 한 번을 구매하는 것입니다. 새 패키지의 전체 가격(개별 가격이 있으면 그 가격)이 차감되며 사용하지 않은 부분에 대한 크레딧은 없습니다. 라인은 새 패키지의 모든 속성을 가져옵니다.
LINE-09 라인을 비활성화하는 것과 삭제하는 것의 차이는 무엇입니까?
LINE-10 라인 상태는 각각 무엇을 의미합니까?
| 상태 | 의미 | 해제할 수 있는 사람 |
|---|---|---|
| Active | 사용 가능 | — |
| Disabled | 리셀러 / 소유자가 끔 | 리셀러 |
| Banned | 관리자가 잠금 | 관리자만 |
| Expired | 만료일 경과 | 갱신 |
| Trial | 체험 라인, 체험 기간이 끝날 때까지 사용 가능 | 갱신하면 정식으로 전환 |
LINE-11 라인이 만료되면 어떻게 됩니까?
라인을 갱신할 때까지 고객은 거부됩니다(만료와 차단이 동시에 된 라인은 만료를 먼저 확인하므로 "만료" 클립이 표시됩니다). 진행 중인 세션은 약 1분 안에 종료됩니다. 라인은 자동으로 삭제되지않습니다. 갱신하면 같은 사용자 이름 / 비밀번호로 다시 작동합니다.
LINE-12 라인을 서브 리셀러에게 넘길 수 있습니까?
예. 소유자로 하위 계정을 선택하세요. 소유자는 자신의 목록에서 해당 라인을 봅니다. 크레딧은 여전히 저장을 누른 계정에서 차감됩니다.
LINE-13 누구의 라인이 보입니까?
본인의 라인과 모든 하위 계정의 라인이 보입니다. 본인 트리 밖의 라인은 본인에게 존재하지 않습니다("찾을 수 없음"으로 응답).
LINE-14 "Contact"와 "Reseller notes" 필드는 무엇에 쓰입니까?
고객이 누구인지(이메일, 전화번호, 주문 번호) 기억해 두기 위한 것입니다. 구독자에게는 절대 보이지 않습니다. 라인을 삭제하면 영구적으로 지워집니다.
LINE-15 라인이 무엇을 어디에서 시청하는지 볼 수 있습니까?
그룹에 권한이 있으면Logs → Line Activity에서 각 라인의 시청 기록을,Logs → Live Connections에서 본인 트리에 있는 라인의 모든 열린 연결(어느 라인, 어느 채널, 어느 주소에서)을 종료 버튼과 함께 볼 수 있습니다. Live Connections는 관리자가 그룹에 고객 연결 기록 조회 옵션(그룹 양식의client connection logs상자)을 켠 경우에만 열리며, 본인 트리 밖 라인의 연결은 볼 수 없습니다.
LINE-16 Lines 목록에 활성화 코드의 라인이 보이지 않는 이유는 무엇입니까?
LINE-17 라인 양식의 만료일에 시간이 포함됩니까? 관리자
예. 라인 양식의Expires on필드는 패널 시간대의 날짜및 시간이므로 라인이 특정 시각에 만료될 수 있습니다. 이 필드를 건드리지 않고 양식을 열었다가 저장하면 만료 시각이 초 단위까지 유지됩니다. 메모나 부케를 편집해도 시간 단위 체험 라인에 추가 시간이 주어지지 않습니다. 읽을 수 없는 값은 해당 필드에서 오류로 알려지며 "만료 없음"으로 바뀌지 않습니다. 일괄 편집 페이지는 여전히 날짜를 받으며 해당 날짜의 끝으로 처리합니다.
체험
TRITRI-01 체험 라인은 언제 만들 수 있습니까?
다음 조건을모두만족할 때입니다. 관리자가 리셀러의 체험을 끄지 않았고, 패키지에 체험 기간이 있고, 그룹의Allowed Trials가 0보다 크고, 크레딧이 그룹의Minimum Trial Credits이상이며, 집계 기간 내에 만든 체험 라인 수가 할당량에 도달하지 않았을 때입니다.
TRI-02 체험 할당량은 어떤 기간으로 집계됩니까?
그룹에 설정된 대로입니다.day= 최근 24시간,month= 최근 30일입니다. 예를 들어 하루 5개 할당량이면 임의의 24시간 동안 체험 라인은 최대 5개입니다. 오래된 체험이 기간을 벗어나면 그 자리가 비워집니다.
TRI-03 체험에도 크레딧이 듭니까?
패키지의 체험 가격만큼 정확히 듭니다(보통 0). 리셀러의 개별 가격은 체험에 적용되지 않습니다.
TRI-05 체험을 정식 라인으로 바꾸려면 어떻게 합니까?
패키지로 라인을 갱신하세요. 라인이 정식 기간을 갖게 되며 더 이상 체험이 아닙니다. 사용자 이름과 비밀번호는 그대로이며 고객이 다시 설정할 필요가 없습니다.
재생 링크, 앱, 형식
PLAYPLAY-01 고객에게 줄 링크는 어디에서 얻습니까?
Lines → Generate play link: 형식을 선택하면 라인의 사용자 이름과 비밀번호로 링크가 만들어집니다. API에서는get_line이 완성된 링크를 반환합니다:m3u,m3u_hls,xmltv,player_api,web_player.
PLAY-02 고객은 어떤 앱을 사용할 수 있습니까? 시청자
Xtream Codes API를 지원하는 모든 앱(IPTV Smarters, TiviMate, XCIPTV, GSE…)에서 서버 주소 + 사용자 이름 + 비밀번호를 입력하면 됩니다. 플레이리스트만 받는 앱에는M3U링크를 사용하세요.MAG박스는 포털을,Enigma2박스는 플레이리스트 / 플러그인을 사용합니다. 디바이스가 없으면 브라우저에서웹 플레이어를 사용하세요.
PLAY-03 MPEG-TS와 HLS 중 무엇을 써야 합니까?
MPEG-TS: 채널 전환이 빠르며 IPTV 앱과 셋톱박스에 적합합니다.HLS: 브라우저, Apple 기기, 불안정한 네트워크에서 잘 작동합니다. 라인은 패키지가 허용하는 형식만 사용할 수 있으며 허용되지 않은 형식의 링크는 거부됩니다.
PLAY-04 플레이리스트 유형에는 어떤 것이 있습니까?
m3u_plus(로고, 그룹, EPG ID 포함 — 권장 기본값), 일반m3u, Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive용 유형, 단순 목록 유형이 있습니다. Generate play link 대화상자에서 하나를 선택하세요.
PLAY-05 프로그램 가이드(EPG)는 어디에서 옵니까? 시청자
Xtream 앱은 스스로 가져옵니다. M3U 앱에서는 라인의XMLTV링크를 사용하세요(m3u_plus플레이리스트에는 이미 EPG 주소가 들어 있습니다).
PLAY-06 캐치업이 있습니까? 시청자
예. 관리자가 아카이브를 활성화한 채널에서 사용할 수 있으며, 앱에서 해당 채널에 캐치업 아이콘이 표시됩니다.
PLAY-07 웹 플레이어는 어디에 있고 어떻게 로그인합니까? 시청자
API 서버의/player/에 있습니다(web_player링크). 라인의 사용자 이름 / 비밀번호 또는 활성화 코드로 로그인하세요.
PLAY-08 라인 비밀번호를 바꾸면 이전 링크도 계속 작동합니까?
아니요. 비밀번호는 링크의 일부이며 앱에 저장되어 있으므로, 비밀번호를 변경하면 고객이 다시 입력하거나 새 링크를 받아야 합니다. 허락 없이 라인을 쓰는 사람을 차단하는 방법도 이것입니다.
PLAY-09 재생 링크에 내 도메인을 사용할 수 있습니까?
예. API 키 페이지의Your own play address를 설정하세요(또는set_play_baseAPI 액션 사용). 도메인의 DNS를 패널의 API 서버로 지정해야 하며또한운영자 쪽에서도 설정해야 하므로, 사용하기 전에 관리자에게 알려 주세요. 이 주소는 API가 본인 시스템에 반환하는 링크에 적용됩니다.
MAG / Enigma2 셋톱박스
DEVDEV-01 MAG / Enigma 박스는 어떻게 추가합니까?
Devices → Add MAG / Add Enigma: MAC을 입력하고 패키지를 선택합니다. 시스템이 새 라인을 판매하고 디바이스를 한 번에 연결하며, 디바이스는 MAC으로 로그인하므로 사용자 이름 / 비밀번호를 입력할 필요가 없습니다. 크레딧은 일반 라인과 똑같이 차감됩니다.
DEV-02 고객이 이미 라인이 있는데 박스를 추가하고 싶어 합니다?
디바이스 양식에서 패키지 대신 고객의기존 라인을 선택하세요. 디바이스가 해당 라인과페어링되며 무료입니다. 고객은 앱에서 라인을 계속 사용하고, 박스는 라인의 패키지, 만료일, 부케, 상태를 따릅니다.
DEV-03 페어링된 앱과 박스의 연결은 어떻게 집계됩니까?
연결 제한을공유합니다. 앱과 박스는 한 명의 구독자입니다.
DEV-04 박스는 어떻게 갱신합니까?
해당 라인을 갱신하세요(링크는 디바이스 양식에 있습니다). 페어링된 디바이스는 고객의 라인을 갱신하면 박스가 자동으로 따라갑니다.
DEV-05 고객이 박스를 새것으로 교체합니다?
디바이스의 MAC을 편집하세요. 라인에 디바이스 잠금이 켜져 있다면, 새 박스가 등록될 수 있도록 기록된 일련번호 / 디바이스 ID를 지우세요.
DEV-06 디바이스를 삭제하면 라인도 삭제됩니까?
예. 이전 패널과 마찬가지로 디바이스를 삭제하면 해당 라인도(연결 기록과 대기 중인 이벤트와 함께) 삭제됩니다. 결제한 라인을 유지하려면Convert to line버튼을 사용하세요. 디바이스는 제거되고 라인은 일반 라인이 됩니다. 고객의 라인을 삭제하면 페어링된 디바이스는 자체 라인으로 독립적으로 남습니다.
DEV-07 리셀러가 박스를 원격으로 제어할 수 있습니까?
본인의MAG박스는 가능합니다. TV에 메시지 보내기, 채널 재생, 포털 새로고침, 재부팅, 라인의 연결 종료(그룹에 고객 연결 로그 조회 권한 필요), 기록된 ISP 초기화, STB 잠금 초기화가 해당됩니다.Enigma박스의 X-Plugin 명령과 스크린샷, 디바이스 차단, 디바이스를 다른 라인으로 이동하는 것은 관리자 전용입니다. 리셀러의 디바이스를 활성화 / 비활성화하면 해당 라인이 활성화 / 비활성화되며, 리셀러는 디바이스의Banned를 해제할 수 없습니다.
활성화 코드
CODECODE-01 활성화 코드는 무엇에 쓰입니까?
접근 권한을 코드(스크래치 카드, 메시지로 보낸 코드)로 판매하는 방식입니다. 고객이 앱이나 웹 플레이어에 코드를 입력하면 사용자 이름 / 비밀번호 없이 시청할 수 있습니다. 기간은고객이 코드를 처음 활성화할 때 비로소 시작됩니다.
CODE-02 코드는 어떻게 만들고 비용은 얼마입니까?
Active Codes → New: 패키지, 수량(배치당 1–500), 코드 길이(6–24), 숫자만 사용 옵션(TV 리모컨으로 입력하기 쉬움), 체험 옵션을 선택합니다. 크레딧은생성 시점에차감되며 = 패키지 가격 × 코드 수입니다. 모든 코드에는 활성화 전까지 잠겨 있는 자체 라인이 함께 만들어집니다.
CODE-03 코드에는 어떤 문자가 들어갑니까?
혼동하기 쉬운 문자(0, O, 1, I)를 뺀 대문자와 숫자, 또는 숫자만 사용합니다. 고객이 소문자로 입력해도 허용됩니다.
CODE-04 코드 하나를 몇 대의 디바이스에서 사용할 수 있습니까? 시청자
한 대입니다. 코드는 처음 활성화한 디바이스에 묶이며, 다른 디바이스가 같은 코드를 입력하면 거부됩니다. 해당 디바이스는 코드를 몇 번이든 입력할 수 있고 라인의 로그인 정보는 바뀌지 않습니다.
CODE-05 고객이 디바이스를 바꾸면 어떻게 합니까?
해당 코드의Reset device를 실행하면 새 디바이스가 활성화할 수 있습니다. 기간은 추가되지 않습니다.
CODE-06 고객이 코드를 입력할 때 오류가 납니다. 무슨 뜻입니까? 시청자
CODE-07 활성화된 코드는 어떻게 연장합니까?
Active Codes페이지에서 코드를 체크하고Extend (days)작업을 선택한 뒤 일수를 입력합니다.활성화된코드에만 일수가 추가됩니다(사용하지 않은 코드는 아직 기간이 시작되지 않았습니다). 아직 유효한 코드는 현재 만료일부터, 만료된 코드는 지금부터 연장됩니다. 이 작업은 크레딧을 차감하지 않습니다. API에서는extend_active_code입니다.
CODE-08 코드를 삭제하면 크레딧이 환불됩니까?
리셀러가 만든사용하지 않은코드는 전액 환불되며 크레딧 원장에 행이 남습니다.활성화된코드는 환불되지 않습니다.
CODE-09 많은 코드를 한꺼번에 관리하려면 어떻게 합니까?
Batches페이지에 각 배치의 전체 / 준비됨 / 활성화됨 / 비활성화됨 수가 표시되며 TXT 파일(한 줄에 코드 하나)로 내보낼 수 있습니다. 일괄 작업: 활성화, 비활성화, 디바이스 초기화, 삭제.
연결 제한과 라인을 보호하는 잠금
SECSEC-01 "Max connections"는 어떻게 집계됩니까?
한 라인으로동시에시청하는 디바이스 수입니다. 0 = 무제한. 이미 보고 있는 채널을 같은 디바이스에서 다시 열어도 추가 연결로 계산되지 않습니다.
SEC-02 한도를 초과하면 누가 연결이 끊깁니까? 시청자
기본적으로새연결이 들어오고가장 오래된연결이 닫힙니다(같은 디바이스의 연결을 우선하고, 그다음 같은 IP). 닫힌 플레이어는 약 30초 안에 멈춥니다. 관리자는 기존 연결을 닫는 대신새 연결을 거부하도록 바꿀 수 있습니다.
SEC-03 "두 번째 IP" 규칙이란 무엇입니까?
관리자가 켜 두면, 라인이 한 IP에서 시청되는 동안 다른 IP의 라이브 연결은 거부됩니다. 이 규칙은 연결 수가 적은 라인으로 한정할 수 있습니다(예: 연결 1개인 라인. 무제한 연결 라인은 임계값이 0일 때만 묶임).Match The Address By Network를 켜면 같은 /24 네트워크(IPv6는 /64)의 주소를 한 시청자로 봅니다. 계정 공유를 막는 수단입니다.
SEC-04 라인을 특정 IP나 앱으로 제한할 수 있습니까?
그룹에Allow Line Restrictions가 켜져 있으면Allowed IPs필드(IP, CIDR 범위, 도메인 이름을 한 줄에 하나씩. 도메인은 연결 시점에 조회하므로 유동 IP도 작동)와Allowed User-Agents를 쓸 수 있습니다. 비어 있으면 모두 허용입니다. 참고: 이 제한은재생시점에 차단하며, 앱은 여전히 로그인되고 채널 목록을 표시합니다.
SEC-05 ISP 잠금이란 무엇입니까?
라인이 첫 연결의 인터넷 제공업체를 기억하고 다른 제공업체에서의 사용을 거부합니다. 고객이 제공업체를 바꾸면 ISP 잠금을 껐다가 다시 켜서 새 제공업체를 기록하세요. MAG 박스에는 적용되지 않습니다.
SEC-06 디바이스 잠금이란 무엇입니까?
라인을 처음 로그인한 셋톱박스(일련번호, 디바이스 ID)에 묶으며 다른 박스는 거부됩니다. 패키지에서 결정합니다.
SEC-07 국가 제한은 어떻게 작동합니까?
라인은 강제 국가(ALL= 어디서나)에서만 연결할 수 있습니다. 비어 있으면 패널의 일반 허용 국가 목록이 적용됩니다. 해외여행 중이거나 VPN을 사용하는 고객은 이 사유로 거부될 수 있습니다.
SEC-08 IP 주소가 차단되는 이유는 무엇입니까? 시청자
- 자동: 한 IP에서 짧은 시간에 여러 서로 다른 사용자 이름 / 활성화 코드로 로그인에 실패하거나 요청이 폭주한 경우. 자동 차단은 관리자가 설정한 시간(기본 60분)이 지나면 스스로 풀립니다.
- 수동: 관리자가 IP / IP 범위를 차단한 경우로, 만료되지 않습니다.
IP가 차단된 동안에는 그 IP에서어떤라인도 연결할 수 없습니다. 같은 사용자 이름을 반복해서 잘못 입력하는 것만으로는 차단되지 않습니다.
SEC-09 연결이 차단되는 다른 이유에는 무엇이 있습니까?
관리자는User-Agent(앱),인터넷 제공업체(ISP),ASN(예: 호스팅 / VPN 대역)으로 차단할 수 있습니다. 관리자가 "bypass UA"를 켠 라인은 앱 차단 목록을 건너뜁니다.
SEC-10 restreamer란 무엇입니까?
스트림을 가져가 재배포하는 파트너를 위한 라인입니다. 동시 접속 제한, 두 번째 IP 규칙, 긴 세션 자동 종료, ASN 차단에서 제외됩니다. 패키지 / 관리자가 결정하며 일반 시청자용이 아닙니다.
SEC-11 아주 긴 연속 세션은 끊깁니까? 시청자
관리자가 연속 세션의 최대 시간을 설정할 수 있으며, 그 시간이 지나면 세션이 닫히고 고객이 재생을 눌러 이어서 시청합니다. 약 90초 동안 신호가 끊긴 세션도 닫힌 것으로 처리됩니다.
서브 리셀러
SUBSUB-01 서브 리셀러를 만들 수 있습니까?
그룹에Can Create Sub-Resellers가 켜져 있고Groups for sub-resellers에 그룹이 하나 이상 있을 때 가능합니다. 생성할 때마다 그룹에 설정된 생성 요금(크레딧)이 차감됩니다. 리셀러 트리는 최대 5단계 깊이입니다.
SUB-02 서브 리셀러는 어떤 그룹에 속하며 무엇을 할 수 있습니까?
관리자가 허용한 목록에서 그룹을 선택합니다. 그 그룹이 서브 리셀러의 권한, 판매 가능한 패키지, 체험 할당량을 결정합니다.
SUB-03 서브 리셀러에 대해 무엇을 관리할 수 있습니까?
이메일, 이름, 비밀번호, 상태, 그룹(목록에서 선택), 메모, 크레딧 이체 / 회수, 그리고 그 아래의 모든 라인입니다. 역할이나 소유자는 변경할 수 없습니다.
SUB-04 서브 리셀러는 내 정보 중 무엇을 볼 수 있습니까?
아무것도 볼 수 없습니다. 모든 계정은 자신의 아래만 볼 수 있으며 상위 단계나 다른 가지는 볼 수 없습니다.
SUB-05 서브 리셀러를 삭제하면 그 라인과 크레딧은 어디로 갑니까?
그룹에Can Delete Users가 켜져 있어야 합니다. 남은 크레딧, 라인, 하위 계정은삭제하는 계정으로 이동합니다. 고객의 라인은 계속 작동합니다. 삭제된 계정의 개인정보(사용자 이름, 이메일, 이름, 비밀번호, API 키, 메모)는 지워지며 해당 사용자 이름과 이메일은 다시 사용할 수 있습니다.
SUB-06 새 서브 리셀러는 이메일을 받습니까?
관리자가 환영 이메일을 켜 두었다면 새 계정이 로그인 이름과 로그인 링크를 받습니다. 이메일에는 비밀번호가절대포함되지 않으므로 비밀번호는 직접 전달하세요.
카테고리 템플릿
CATCAT-01 카테고리 템플릿은 무엇에 쓰입니까?
고객이 앱에서 보는 카테고리(라이브, 영화, 시리즈, 라디오)를 라인별로 재정렬하거나 이름을 바꾸거나 숨기기 위한 것이며, 패널 자체의 카테고리는 건드리지 않습니다.
CAT-02 카테고리를 숨기면 어떻게 됩니까?
해당 카테고리의 모든 콘텐츠도 템플릿을 사용하는 라인의 앱과 플레이리스트에서 함께 숨겨집니다.
CAT-03 템플릿을 편집하면 그것을 사용하는 라인도 바뀝니까?
예. 템플릿이 지정된 모든 라인에 즉시 반영됩니다. 템플릿을 삭제하면 해당 라인은 기본 구성으로 돌아갑니다.
CAT-04 어떤 템플릿을 보고 편집할 수 있습니까?
보기: 본인 템플릿, 하위 계정의 템플릿, 시스템 템플릿, 상위 단계가 공유한 템플릿. 편집: 본인과 하위 계정의 템플릿만. 시스템 템플릿을 조정하려면복제한 뒤 복사본을 편집하세요.
CAT-05 알아 둘 만한 제한이 있습니까?
사용자 지정 카테고리 순서는 M3U 플레이리스트의 영화 / 시리즈 부분에는 적용되지 않습니다(이름과 숨김은 적용됨). Xtream API를 사용하는 앱은 모든 것을 받습니다.
Reseller API, API 키, 웹훅
APIAPI-01 Reseller API는 무엇에 쓰입니까?
대시보드를 열지 않고 본인의 시스템(웹 쇼핑몰, 청구, 봇)에서 라인 / 서브 리셀러를 판매하고 관리하기 위한 것입니다. 주소:{API}/reseller/v1,X-API-Key헤더로 인증합니다. 전체 문서는 API 서버의/docs/에 있습니다.
API-02 API 키는 어디에서 얻습니까?
API Key페이지입니다. 키는 생성할 때한 번만표시되므로 즉시 복사하세요. 잃어버리면 새 키를 만드세요(이전 키는 작동하지 않게 됩니다).
API-03 모든 시스템에 키 하나를 써도 됩니까?
권장하지 않습니다. 시스템마다추가 키를 만드세요. 이름을 붙이고, 사용할 수 있는 IP / CIDR을 제한하고, 필요하면읽기 전용(목록과 조회만)으로 만들 수 있으며, 다른 키에 영향을 주지 않고 해당 키만 폐기할 수 있습니다.
API-04 API로 무엇을 할 수 있습니까?
| 필요 | 액션 |
|---|---|
| 잔액, 가격, 구매 가능 수량, 사용자 이름 / 체험 규칙 | user_info,pricing,packages |
| 라인 | get_lines,get_line,create_line,renew_line,change_package,edit_line,enable_line,disable_line,delete_line |
| 서브 리셀러 | get_users,get_user,create_user,edit_user,adjust_credits,enable_user,disable_user,delete_user |
| 활성화 코드 | 생성, 목록, 활성화 / 비활성화, 디바이스 초기화, 삭제 |
| 웹훅, 자체 재생 주소, API 호출 로그 | create_webhook…,set_play_base,api_logs |
대시보드의 모든 규칙(그룹, 개별 가격, 체험 할당량, 트리 범위)은 API에서도 똑같이 적용됩니다.
API-05 네트워크 오류 후 재시도하면 두 번 차감됩니까?
아니요. 같은 거래에 같은request_id를 보내는 한 시스템이 이전 결과를 반환합니다. 갱신의request_id는해당 라인에 묶여있습니다. 다른 라인에 재사용하면 충돌 오류(HTTP 409)가 반환되고 다른 라인은 바뀌지 않으므로, 거래마다 새request_id를 생성하세요.
API-06 연동이 작동하지 않습니다. 직접 어떻게 확인합니까?
API Key 페이지에최근 API 호출(30일) 표가 있습니다. 액션, 결과, 오류 코드, 호출 주소, 커넥터 이름이 표시됩니다. 파라미터는 절대 기록되지 않습니다.
API-07 웹훅이란 무엇이며 어떤 이벤트가 있습니까?
무언가 일어났을 때 패널이 시스템에 알려 주므로 계속 물어볼 필요가 없습니다. 이벤트:line.created,line.renewed,line.enabled,line.disabled,line.deleted,line.expiring(3일 전),line.expired,credits.low(설정한 임계값 미만). 수신 주소는 https여야 하며 인터넷에서 접근할 수 있어야 합니다.
API-08 웹훅이 진짜인지 어떻게 압니까?
모든 알림에는 서명X-Xtream-Signature: sha256=HMAC(secret, timestamp.body)가 포함되며, 시크릿은 엔드포인트를 만들 때 한 번만 표시됩니다. 웹훅에는 비밀번호가 절대 포함되지 않습니다.
API-09 웹훅 전송이 멈췄습니다?
모든 알림은 3번 시도되며, 연속 20번 전송에 실패한 엔드포인트는 꺼집니다. 본인 쪽 문제를 고치고Send test를 사용한 뒤, 꺼졌다면 엔드포인트를 다시 만드세요.
API-10 API가 라인 비밀번호를 반환합니까?
예, 하지만 라인의 소유자(본인과 트리의 상위 단계)에게만 반환합니다. 라인 비밀번호를 로그에 저장하거나 안전하지 않은 채널로 보내지 마세요.
API-11 `edit_line`으로 라인을 갱신할 수 있습니까?
예,package_id를 함께 보내면 가능합니다(이전 이름package도 허용). 편집과 함께change_package와 똑같이 해당 패키지의 정식 기간 한 번을 판매하며, 가격과request_id도 같고 응답에credits_charged가 포함됩니다. 편집과 갱신은 하나의 트랜잭션이며, 거부되면(크레딧 부족, 잘못된 패키지,trial을 함께 보낸 경우) 아무것도 바뀌지 않습니다. 패키지없는 edit_line은 사용자 이름, 비밀번호, 연락처, 메모만 편집하며 패키지나 만료일은 건드리지 않습니다.
쇼핑몰 / 결제 시스템용 커넥터
CONCON-01 고객에게 대금은 어떻게 받습니까?
본인의시스템과 결제 게이트웨이로 받습니다. 패널은 결제를 처리하지 않습니다. 커넥터가 쇼핑몰 시스템을 패널에 연결합니다. 고객이 본인 쪽에서 결제 → 커넥터가 Reseller API를 호출해 라인을 생성 / 갱신합니다.
CON-02 어떤 플랫폼용 커넥터가 있습니까?
WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress(WooCommerce / Easy Digital Downloads), Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, 그리고 Shopify, Upmind, Invoice Ninja용 "webhook bridge"가 있습니다.
CON-03 어디에서 다운로드하고 설치합니까?
사이드바Resources → All Connectors: 모든 커넥터에는 설명, 연결 정보, 설치 단계,Download버튼, 파일 검증용 SHA-256이 있습니다.
CON-04 커넥터는 얼마나 테스트되었습니까?
커넥터마다 다르며 각 커넥터 페이지에 적혀 있습니다. 일부는 실제 플랫폼 안에서 실행했고(예: WordPress + WooCommerce, Odoo, FOSSBilling, Paymenter), 일부는 핵심 부분만 실행했습니다. "테스트 방법" 줄을 읽고 실제로 판매하기 전에 테스트 환경에서 먼저 시도해 보세요.
CON-05 커넥터는 안전하며 패널에 무엇을 합니까?
CON-06 커넥터는 무엇을 판매할 수 있습니까?
라인(생성, 갱신, 패키지 변경, 일시 중지, 삭제)과 크레딧이 있는 서브 리셀러 계정입니다.
데이터, 삭제, 개인정보
DATADATA-01 삭제된 라인을 복원할 수 있습니까?
아니요. 삭제하면 사라집니다. 라인의 정보(사용자 이름, 비밀번호, 연락처, 메모), 연결 기록(IP, 디바이스, 시청 내역), 라인에 연결된 셋톱박스, 활성화 코드가 모두 삭제됩니다. 휴지통도, 복원 기능이나 API도 없습니다. 고객이 돌아오면 새 라인을 만드세요.
DATA-02 삭제 후 시스템에 무엇이 남습니까?
운영자를 위한익명통계 기록(신규 또는 재방문 고객, 인기 패키지)만 남습니다. 고객에 대해 읽을 수 있는 정보는 전혀 없으며 어떤 리셀러, 커넥터, API도 접근할 수 없습니다.
DATA-03 백업으로 삭제된 라인을 되살릴 수 있습니까?
아니요. 데이터베이스 백업은 장애 후 시스템을 복구하기 위한 것이며 운영자가 보관합니다. 삭제를 되돌리는 데 사용되지 않습니다. 오래된 백업은 순환 삭제되므로 삭제된 데이터는 백업에서도 사라집니다.
DATA-04 라인 비밀번호는 읽을 수 있는데 패널 비밀번호는 왜 읽을 수 없습니까?
라인 비밀번호는 앱에 입력해야 하고 플레이리스트 링크의 일부이므로 패널이 라인 소유자가 읽을 수 있도록 보관합니다. 패널 계정 비밀번호는 해시되어서만 저장됩니다.
DATA-05 누가 내 라인과 고객을 볼 수 있습니까?
본인, 트리에서 본인의 상위 계정, 관리자입니다. 다른 리셀러와 본인의 하위 단계는 볼 수 없습니다.
DATA-06 패널이 고객에게 이메일 / 메시지를 보냅니까?
절대 보내지 않습니다. 라인의 고객은 리셀러의 고객이며, 본인의 시스템을 통해 직접 연락하세요.
DATA-07 라인이 만료되기 전에 알려 줍니까?
두 가지 방식으로 알려 줍니다. 만료가 임박한 라인의 일일 요약 이메일(관리자가 켠 경우, 기본 3일 전), 그리고 본인 시스템용line.expiring/line.expired웹훅입니다.
문제 해결
FIX위에서 아래로 확인하세요. "시청할 수 없음" 문제의 대부분은 처음 5개 항목에 있습니다.
FIX-01 고객이 로그인할 수 없음 / 시청할 수 없음 시청자
| # | 확인 | 증상 | 해결 방법 |
|---|---|---|---|
| 1 | 사용자 이름 / 비밀번호 | 앱이 잘못된 정보라고 알림 | 라인 양식과 비교(대소문자 구분, 공백 없음).Generate play link의 링크를 다시 보내기 |
| 2 | 만료일 | 앱이Expired라고 알림 | 갱신(LINE-06) |
| 3 | 상태 | Disabled/Banned | 다시 활성화.Banned는 관리자에게 문의 |
| 4 | 서버 주소 | 연결할 수 없음 | 재생 링크의 정확한 주소와 포트, 올바른http/https사용 |
| 5 | 동시 접속 수 | 다른 사람이 시청을 시작하면 쫓겨남 | SEC-01,SEC-02 |
| 6 | 차단된 IP | 해당 네트워크에서는 어떤 라인도 접속 불가 | SEC-08: 차단이 풀릴 때까지 기다리거나 관리자에게 해제 요청 |
| 7 | ISP 잠금 / 국가 / Allowed IPs | 네트워크 변경, 모바일 데이터, VPN 사용, 여행 중에만 실패 | SEC-04,SEC-05,SEC-07 |
| 8 | 형식 | HLS / TS 링크가 거부됨 | 패키지가 허용하는 형식 사용(PLAY-03) |
| 9 | 차단된 앱 | 한 앱에서만 실패 | 다른 앱 시도.SEC-09 |
FIX-02 로그인은 되고 목록도 보이는데 채널이 재생되지 않음 시청자
FIX-03 채널이나 채널 그룹이 보이지 않음 시청자
FIX-04 끊김, 멈춤 시청자
순서대로 시도하세요. 다른 채널(한 채널만인지 전체인지) → 다른 네트워크 → 다른 형식(MPEG-TS 대신 HLS) → 다른 앱. 모든 채널이 모든 네트워크에서 실패하면 → 지원팀에 사용자 이름, 시각, 채널을 알려 주세요.
FIX-05 프로그램 가이드(EPG)가 없음 시청자
FIX-06 라인을 만들 수 없음
FIX-07 플레이리스트를 다운로드하면 오류 429 또는 404 페이지가 나옴
FIX-08 대시보드의 페이지를 열 수 없음
FIX-09 패널에서 이메일이 오지 않음
이메일은 관리자가 메일 서버를 설정하고 해당 종류의 메시지를 켠 경우에만 발송되며, 계정에 실제 이메일 주소가 있어야 합니다. 스팸 폴더를 확인하세요.
용어집
- 라인(Line)
- 시청자 한 명의 IPTV 구독: 사용자 이름, 비밀번호, 만료일, 부케, 제한
- 사용자(User)
- 패널에 로그인하는 계정: 관리자, 리셀러, 서브 리셀러
- 그룹(Group)
- 패널 계정의 권한 그룹. 메뉴, 판매 가능한 패키지, 라인 규칙, 체험을 결정함
- 부케(Bouquet)
- 콘텐츠(채널, 영화, 시리즈) 목록
- 패키지(Package)
- 판매 상품: 부케 + 기간 + 제한 + 크레딧 가격
- 크레딧(Credit)
- 패키지를 구매하는 데 쓰는 선불 단위
- 체험(Trial)
- 패키지의 체험 기간
- 활성화 코드(Activation code)
- 고객이 유료 라인을 직접 활성화하는 코드
- MAG / Enigma2
- 두 계열의 셋톱박스. MAC 주소로 로그인함
- Xtream Codes API
- 대부분의 IPTV 앱이 사용하는 프로토콜(서버 + 사용자 이름 + 비밀번호)
- M3U / XMLTV
- 플레이리스트 / 프로그램 가이드의 파일 형식
- MPEG-TS / HLS
- 두 가지 스트림 형식
- EPG
- 프로그램 가이드
- 캐치업(Catch-up)
- 방송이 끝난 뒤 프로그램을 시청하는 기능
- Restreamer
- 스트림을 가져가 재배포하는 파트너를 위한 라인
- 커넥터(Connector)
- 리셀러의 쇼핑몰 시스템을 패널에 연결하는 소프트웨어
- 웹훅(Webhook)
- 무언가 일어났을 때 패널이 리셀러의 시스템으로 보내는 알림
일치하는 질문이 없습니다
다른 키워드나 질문 코드를 입력하거나 필터를 해제해 보세요.
아직 해결되지 않았나요?
라인의 사용자 이름(비밀번호는 절대 보내지 마세요), 발생 시각, 사용한 앱 또는 디바이스, 이미 시도한 질문의 코드를 보내 주세요.