홈
Xtream UIPro

도움말 센터

질문과 답변

크레딧, 패키지, 라인, 재생 링크, 디바이스가 어떻게 작동하는지, 그리고 재생되지 않을 때 무엇을 확인해야 하는지 안내합니다.

전체 139개 중 139개 질문

재생되지 않나요? 대부분의 문제는 문제 해결의 체크리스트로 해결됩니다. 여기서 시작하세요. 문제 해결 열기

이 페이지 사용 방법

모든 질문에는 고정 코드가 있습니다(예:LINE-07). 지원팀에 문의할 때 이 코드를 알려 주시거나 질문 링크를 복사해 전달하세요.

메뉴, 버튼, 필드 이름은 패널에 표시되는 그대로 적었습니다.사용자(user)는 패널에 로그인하는 계정(관리자, 리셀러)이고,라인(line)은 시청자의 IPTV 구독입니다. 두 개념은 절대 섞이지 않습니다.

  • 시청자 리셀러가 이 답변을 그대로 시청자에게 전달할 수 있습니다
  • 관리자 패널 운영자용

서비스 개요와 역할 분담

GEN
GEN-01 이 서비스는 무엇을 제공합니까?

완전한 OTT / IPTV 시스템을 제공합니다. 관리 패널(대시보드), 시청자 앱용 API 서버, 라이브 채널·영화·시리즈·라디오 전송, 웹 플레이어가 포함됩니다. 시스템은 저희가 제공하고 유지 관리하며, 리셀러는 이를 사용해 고객에게 시청 권한(라인)을 제공합니다.

#GEN-01
GEN-02 이 서비스가 하지 않는 일은 무엇입니까?
  • 대금을 대신 수금하지 않으며 결제 게이트웨이도 없습니다. 고객에게 받을 가격, 수금 방식, 청구서 발행은 리셀러의 몫입니다(CON-01참조).
  • 리셀러의 시청자에게 연락하지 않습니다. 패널은 패널 계정에만 이메일을 보내며 라인에는 절대 보내지 않습니다.
  • 삭제된 고객의 개인정보를 보관하지 않으며 복원 기능도 없습니다(DATA-01참조).
#GEN-02
GEN-03 시스템에서 누가 누구입니까?
역할누구인가로그인 위치
관리자패널 운영자대시보드
리셀러라인을 판매하며 관리자에게서 크레딧을 받음대시보드, Reseller API
서브 리셀러다른 리셀러 아래에 만들어진 리셀러대시보드, Reseller API
라인구독자 — 최종 시청자IPTV 앱, 셋톱박스, 웹 플레이어. 대시보드는절대불가
#GEN-03
GEN-04 채널이 시청자에게 전달되기까지 어떤 단계를 거칩니까?
  1. 관리자가 카탈로그(채널, 영화, 시리즈, 라디오)를 구성하고부케로 묶습니다.
  2. 관리자가패키지를 만듭니다: 부케 + 기간 + 동시 접속 수 + 크레딧 가격.
  3. 리셀러가 크레딧을 사용해 패키지를 판매합니다 → 시스템이라인을 생성합니다.
  4. 고객이 앱에 라인 정보를 입력하면 시스템이 라인을 확인(만료 여부, 활성화 여부, 제한 범위)한 뒤 적절한 서버에서 재생합니다.
#GEN-04
GEN-05 리셀러는 콘텐츠로 무엇을 할 수 있고 무엇을 할 수 없습니까?

리셀러는 채널, 영화, 시리즈, 라디오, 부케, 패키지 목록을볼수 있지만(그룹에 권한이 있는 경우) 콘텐츠를 추가, 편집, 삭제할 수는 없습니다. 콘텐츠와 패키지는 관리자가 관리합니다. 리셀러는 패키지(그룹이 허용하면 부케도 —PKG-05)를 선택해 각 고객이 시청할 수 있는 범위를 정합니다.

#GEN-05
GEN-06 지원은 어디에서 받습니까?

사이드바의Support항목을 누르면 별도의 지원 사이트가 열립니다. 패널에는 자체 티켓 시스템이 없습니다. 문의할 때는 라인의 사용자 이름(비밀번호는 절대 보내지 마세요), 발생 시각, 앱 / 디바이스, 이미 시도해 본 경우 이 페이지의 질문 코드를 함께 보내 주세요.

#GEN-06
GEN-07 인터페이스는 어떤 언어를 지원합니까?

패널, 웹 플레이어, 이 도움말 페이지에는 27개 언어를 지원하는 언어 전환기가 있습니다. 영어와 베트남어가 기준 번역이며, 다른 언어에서는 새로 추가된 화면이 한동안 영어로 남을 수 있습니다. 패널이 보내는 이메일은 현재 영어로만 발송됩니다.

#GEN-07

패널 계정과 로그인

ACC
ACC-01 고객이 대시보드에 로그인할 수 없는 이유는 무엇입니까?

의도된 설계입니다. 라인은 패널 계정이 아닙니다. 고객은 라인 정보를 IPTV 앱, 셋톱박스, 웹 플레이어에서만 사용합니다. 반대로 리셀러 계정으로는 채널을 시청할 수 없습니다.

#ACC-01
ACC-02 이 페이지에서 설명하는 것보다 메뉴가 적게 보입니다. 왜 그런가요?

메뉴와 작업은 관리자가 계정에 지정한그룹에 따라 달라집니다. 그룹에 권한이 없는 페이지는 사이드바에 표시되지 않으며 열 수 없습니다. 더 많은 권한이 필요하면 관리자에게 요청하세요.

#ACC-02
ACC-03 패널 비밀번호는 어디에서 변경합니까?

계정 영역(프로필 → 비밀번호 변경)에서 변경합니다. 패널 비밀번호는 해시되어 저장되며 관리자를 포함해 누구도 다시 읽을 수 없습니다. 잊어버렸다면 상위 계정(상위 리셀러 또는 관리자)에 새 비밀번호 설정을 요청하세요.

#ACC-03
ACC-04 네트워크를 바꾸면 왜 로그아웃됩니까?

패널은 IP 주소가 바뀌면 세션을 종료하도록 설정할 수 있으며, 탈취된 세션을 재사용하지 못하게 하기 위한 것입니다. 다시 로그인하세요. 관리자 설정입니다.

#ACC-04
ACC-05 로그인에 여러 번 실패하면 어떻게 됩니까?

패널은 로그인 실패 횟수를 제한합니다(관리자가 설정). 한도를 넘으면 다시 시도하기 전에 기다려야 합니다.

#ACC-05
ACC-06 데모 계정은 실제 계정과 어떻게 다릅니까?

데모 계정은 인터페이스만 보여 줍니다. 비밀번호 변경, 프로필 편집, 활성화 코드 생성 등 되돌릴 수 없는 작업은 할 수 없습니다.

#ACC-06
ACC-07 내 계정이 "비활성화"되었습니다. 무슨 뜻입니까?

상위 계정이 계정을 껐다는 뜻입니다. 패널에 로그인할 수 없고 API 키도 거부됩니다. 이미 판매한 라인은 삭제되지 않습니다. 상위 계정에 문의하세요.

#ACC-07
ACC-08 나와 서브 리셀러가 한 작업은 어디에서 확인합니까?

Logs → Reseller Logs(그룹에 로그 조회 권한이 있는 경우): 생성, 편집, 갱신, 활성화 / 비활성화, 삭제된 모든 라인 또는 디바이스, 생성된 모든 서브 리셀러, 모든 크레딧 이체가 차감된 크레딧과 함께 표시됩니다. 본인과 하위 계정의 기록만 볼 수 있으며, 로그는 삭제할 수 없습니다(관리자 전용). 잔액을 대조하는 기준은 여전히 크레딧 원장(CRD)입니다.

#ACC-08

크레딧

CRD
CRD-01 크레딧이란 무엇입니까?

패널의 선불 단위입니다. 모든 판매(라인 생성, 갱신, 활성화 코드 생성, 서브 리셀러 생성)는 패키지 가격 또는 그룹 요금에 따라 크레딧을 차감합니다. 크레딧은 돈이 아니며 패널이 환산해 주지도 않습니다. 크레딧 1개의 가치는 본인과 상위 계정 간에 합의합니다.

#CRD-01
CRD-02 크레딧은 어떻게 충전합니까?

크레딧은 위에서 아래로 흐릅니다. 관리자가 리셀러에게 크레딧을 주고, 리셀러가 서브 리셀러에게 이체합니다. 상위 계정에 대한 결제는 패널 밖에서 이루어집니다.

#CRD-02
CRD-03 누구의 크레딧이 차감됩니까?

라인이 하위 서브 리셀러에게 배정되더라도 항상작업을 수행하는 계정의 크레딧이 차감됩니다.

#CRD-03
CRD-04 크레딧 내역은 어디에서 봅니까?

Credits페이지에서 봅니다. 변동마다 한 행씩 날짜, 금액, 이후 잔액, 사유, 수행자가 표시됩니다. 이것이 원장이며 잔액의 공식 기준입니다.

#CRD-04
CRD-05 크레딧이 부족하면 어떻게 됩니까?

작업 전체가 거부됩니다. 라인이 생성되지 않고 아무것도 차감되지 않습니다. 잔액은 절대 마이너스가 되지 않습니다.

#CRD-05
CRD-06 저장을 두 번 누르거나 네트워크가 끊기면 두 번 차감됩니까?

아니요. 모든 판매 요청에는 요청 ID(request_id)가 포함되며, 같은 ID를 다시 보내면 이전 결과가 반환됩니다. 라인 생성과 크레딧 차감은 항상 함께 성공하거나 함께 취소됩니다.

#CRD-06
CRD-07 라인을 삭제하면 크레딧이 환불됩니까?

아니요. 남은 기간이 있어도 라인 삭제 시 환불되지 않습니다. 유일한 예외는 리셀러가 만든사용하지 않은 활성화 코드를 삭제하는 경우로, 이때는 환불됩니다(CODE-08).

#CRD-07
CRD-08 서브 리셀러에게 이체한 크레딧을 회수할 수 있습니까?

예. 서브 리셀러의 편집 양식에서 크레딧 이체 필드에 음수를 입력하세요. 어떤 잔액도 0 아래로 내려갈 수 없습니다.

#CRD-08
CRD-09 라인을 몇 개나 구매할 수 있는지 미리 알려면 어떻게 합니까?

라인 양식의 패키지 선택기에 본인 가격이 표시됩니다. API에서는pricing액션이 잔액, 각 패키지 가격, 구매 가능한 수량을 반환합니다.

#CRD-09

패키지, 부케, 가격

PKG
PKG-01 부케와 패키지의 차이는 무엇입니까?

부케는 콘텐츠(채널, 영화, 시리즈) 목록입니다.패키지는 판매하는 상품으로, 하나 이상의 부케, 기간, 동시 접속 수, 출력 형식, 잠금, 크레딧 가격(정식 가격과 체험 가격)으로 구성됩니다.

#PKG-01
PKG-02 특정 패키지가 보이지 않는 이유는 무엇입니까?

패키지는 관리자가 지정한 그룹만 판매할 수 있습니다. 내 그룹용이 아닌 패키지는 선택기에 나타나지 않으며 API로 보내면 거부됩니다.

#PKG-02
PKG-03 내 가격이 패키지 가격과 다른 이유는 무엇입니까?

관리자는 각 패키지에 대해 리셀러별개별 가격(0 = 무료)을 지정할 수 있습니다. 개별 가격은 정식 라인 생성, 갱신, 정식 활성화 코드에 적용되며 체험에는 적용되지않습니다.

#PKG-03
PKG-04 관리자가 패키지의 부케를 변경하면 이미 판매된 라인도 바뀝니까?

아니요. 부케는 판매 시점에라인으로 복사되므로 이후 패키지를 편집해도 이미 판매된 라인에는 영향이 없습니다. 라인은 다음 갱신 / 패키지 변경 때 패키지의 새 부케를 받습니다. (부케안의콘텐츠가 바뀌면 그 부케를 가진 모든 라인에 즉시 반영됩니다. 부케를 삭제하면 모든 라인과 패키지에서 해당 ID가 제거됩니다. 전체 부케 순서를 바꿔도 "판매된 라인과 패키지에 적용" 상자를 체크한 경우에만 판매된 라인에 저장된 순서가 바뀌며, 라인의 부케 구성 자체는 바뀌지 않습니다.)

#PKG-04
PKG-05 패키지의 일부만 판매할 수 있습니까?

그룹에Allow Bouquet Selection이 켜져 있을 때만 가능합니다. 패키지 부케 중 일부를 체크하며, 아무것도 체크하지 않으면 패키지 전체이고, 패키지에 없는 부케는 제외됩니다. 가격은 변하지 않습니다.

#PKG-05
PKG-06 라인의 어떤 속성이 패키지에 의해 결정됩니까?

만료일(오늘 + 패키지 기간), 동시 접속 수, 출력 형식, restreamer, 디바이스 잠금, 강제 국가, 강제 서버, ISP 잠금, 부케입니다. 리셀러가 이 필드에 입력한 값은 무시되며, 부케(PKG-05)와 그룹에Allow Line Restrictions가 켜져 있을 때의 ISP 잠금만 예외입니다.

#PKG-06
PKG-07 "MAG 전용" / "Enigma 전용" 패키지란 무엇입니까?

해당 종류의 셋톱박스에만 판매할 수 있는 패키지로, 일반 라인이나 다른 디바이스 유형에는 판매할 수 없습니다. 반대로 Add MAG / Add Enigma 양식에서 사용하려면 패키지가 해당 디바이스 유형을 허용해야 합니다.

#PKG-07

라인: 생성, 편집, 갱신, 삭제

LINE
LINE-01 라인을 만들려면 무엇이 필요합니까?

그룹이 판매할 수 있는 패키지를 선택해야 하고 크레딧이 충분해야 합니다. 사용자 이름 / 비밀번호는 직접 입력하거나(그룹이 허용하는 경우) 비워 두어 자동 생성하게 할 수 있습니다. 관리자는 라인을 만들 때 둘 중 하나(또는 둘 다)를 비워 둘 수도 있으며, 시스템이 10자를 생성해 저장 직후 표시합니다.편집양식에는 여전히 사용자 이름이 필요합니다.

#LINE-01
LINE-02 사용자 이름 / 비밀번호를 직접 고를 수 없는 이유는 무엇입니까?

그룹에서Allow Username Change/Allow Password Change가 꺼져 있어 새 라인에 생성된 값이 사용됩니다. 직접 입력할 수 있는 경우 최소 길이는 그룹에서 정합니다(기본 8자).

#LINE-02
LINE-03 라인 비밀번호는 어디에서 다시 볼 수 있습니까?

라인의 편집 양식과 Lines 목록의Generate play link대화상자에서 볼 수 있습니다. IPTV 앱과 플레이리스트 링크에 필요하므로 라인 비밀번호는 읽을 수 있는 형태로 보관됩니다. 생성된 비밀번호는 저장 직후 표시됩니다.

#LINE-03
LINE-04 오래된 라인에 비밀번호가 표시되지 않고 고객이 로그인할 수 없습니다?

이전 버전의 패널에서 만든 일부 라인은 해시된 비밀번호만 가지고 있습니다. 이런 라인은로그인할 수 없으며패널에도 비밀번호가 표시되지 않습니다. 라인의 편집 양식에서 새 비밀번호를 설정하고 고객에게 전달하세요.

#LINE-04
LINE-05 판매 후 리셀러는 라인에서 무엇을 편집할 수 있습니까?

활성화 / 비활성화, 리셀러 메모, 연락처, 카테고리 템플릿, 소유자(본인의 하위 계정 범위 내), 그룹이 허용하는 경우 사용자 이름과 비밀번호, 그룹에Allow Line Restrictions가 켜져 있으면 제한(IP, 사용자 에이전트, ISP 잠금), 그룹이 허용하는 경우 패키지 범위 내의 새 부케 선택입니다. 패키지, 만료일, 동시 접속 수, 체험 플래그, 출력 형식, 디바이스 잠금, 국가는 직접 편집할 수없으며갱신 / 패키지 변경을 통해서만 바뀝니다.

#LINE-05
LINE-06 라인은 어떻게 갱신합니까?

방법은 두 가지이며 규칙은 하나입니다.

  • 목록의Renew (charged)버튼: 라인의 현재 패키지를 사용합니다.
  • 편집 양식의Extend with package필드: 판매할 수 있는 아무 패키지나 선택합니다(패키지 변경도 이 방법입니다).

라인을 편집하면서 같은 저장에서 갱신도 선택하면 둘은하나의 트랜잭션입니다. 갱신이 거부되면(크레딧 부족, 판매할 수 없는 패키지) 편집도 저장되지않고크레딧도 차감되지 않습니다. 수정한 뒤 다시 저장하세요.

#LINE-06
LINE-07 갱신할 때 남은 시간이 유지됩니까?
  • 라인이만료되지 않았고새 패키지가 이전 패키지와호환되는 경우 → 현재 만료일에 기간이 더해집니다.
  • 라인이만료되었거나두 패키지가 호환되지 않는 경우 → 오늘부터 계산되며 남은 시간은 유지되지 않습니다.

"호환" 여부는 새 패키지에 호환성 검사 옵션이 켜져 있을 때만 확인합니다. 두 패키지의 부케, 출력 형식, 동시 접속 수, restreamer 플래그, 디바이스 잠금이 같아야 합니다. 옵션이 꺼져 있으면 항상 호환되는 것으로 봅니다. 새 패키지는 기본적으로 옵션이 켜져 있으며(관리자가 끌 수 있음), 기존 패키지는 설정을 유지합니다. MAG / Enigma 라인은 해당 종류의 박스를 허용하는 패키지로만 갱신하거나 변경할 수 있습니다.

#LINE-07
LINE-08 패키지 변경(업그레이드 / 다운그레이드)은 어떻게 과금됩니까?

패키지 변경 = 새 패키지의 정식 기간 한 번을 구매하는 것입니다. 새 패키지의 전체 가격(개별 가격이 있으면 그 가격)이 차감되며 사용하지 않은 부분에 대한 크레딧은 없습니다. 라인은 새 패키지의 모든 속성을 가져옵니다.

#LINE-08
LINE-09 라인을 비활성화하는 것과 삭제하는 것의 차이는 무엇입니까?

비활성화: 고객은 로그인하거나 시청할 수 없고 진행 중인 세션은 약 1분 안에 종료되며, 구독 기간은 계속 흘러가고, 언제든 다시 활성화할 수 있습니다.삭제: 영구적이며 복원도 환불도 없습니다(DATA-01). 고객이 잠시 중단하는 경우에는 삭제하지 말고 비활성화하세요.

#LINE-09
LINE-10 라인 상태는 각각 무엇을 의미합니까?
상태의미해제할 수 있는 사람
Active사용 가능—
Disabled리셀러 / 소유자가 끔리셀러
Banned관리자가 잠금관리자만
Expired만료일 경과갱신
Trial체험 라인, 체험 기간이 끝날 때까지 사용 가능갱신하면 정식으로 전환
#LINE-10
LINE-11 라인이 만료되면 어떻게 됩니까?

라인을 갱신할 때까지 고객은 거부됩니다(만료와 차단이 동시에 된 라인은 만료를 먼저 확인하므로 "만료" 클립이 표시됩니다). 진행 중인 세션은 약 1분 안에 종료됩니다. 라인은 자동으로 삭제되지않습니다. 갱신하면 같은 사용자 이름 / 비밀번호로 다시 작동합니다.

#LINE-11
LINE-12 라인을 서브 리셀러에게 넘길 수 있습니까?

예. 소유자로 하위 계정을 선택하세요. 소유자는 자신의 목록에서 해당 라인을 봅니다. 크레딧은 여전히 저장을 누른 계정에서 차감됩니다.

#LINE-12
LINE-13 누구의 라인이 보입니까?

본인의 라인과 모든 하위 계정의 라인이 보입니다. 본인 트리 밖의 라인은 본인에게 존재하지 않습니다("찾을 수 없음"으로 응답).

#LINE-13
LINE-14 "Contact"와 "Reseller notes" 필드는 무엇에 쓰입니까?

고객이 누구인지(이메일, 전화번호, 주문 번호) 기억해 두기 위한 것입니다. 구독자에게는 절대 보이지 않습니다. 라인을 삭제하면 영구적으로 지워집니다.

#LINE-14
LINE-15 라인이 무엇을 어디에서 시청하는지 볼 수 있습니까?

그룹에 권한이 있으면Logs → Line Activity에서 각 라인의 시청 기록을,Logs → Live Connections에서 본인 트리에 있는 라인의 모든 열린 연결(어느 라인, 어느 채널, 어느 주소에서)을 종료 버튼과 함께 볼 수 있습니다. Live Connections는 관리자가 그룹에 고객 연결 기록 조회 옵션(그룹 양식의client connection logs상자)을 켠 경우에만 열리며, 본인 트리 밖 라인의 연결은 볼 수 없습니다.

#LINE-15
LINE-16 Lines 목록에 활성화 코드의 라인이 보이지 않는 이유는 무엇입니까?

활성화 코드에 속한 라인은 필터로 지정하기 전까지 기본적으로 목록에서 숨겨집니다(CODE-02).

#LINE-16
LINE-17 라인 양식의 만료일에 시간이 포함됩니까? 관리자

예. 라인 양식의Expires on필드는 패널 시간대의 날짜및 시간이므로 라인이 특정 시각에 만료될 수 있습니다. 이 필드를 건드리지 않고 양식을 열었다가 저장하면 만료 시각이 초 단위까지 유지됩니다. 메모나 부케를 편집해도 시간 단위 체험 라인에 추가 시간이 주어지지 않습니다. 읽을 수 없는 값은 해당 필드에서 오류로 알려지며 "만료 없음"으로 바뀌지 않습니다. 일괄 편집 페이지는 여전히 날짜를 받으며 해당 날짜의 끝으로 처리합니다.

#LINE-17

체험

TRI
TRI-01 체험 라인은 언제 만들 수 있습니까?

다음 조건을모두만족할 때입니다. 관리자가 리셀러의 체험을 끄지 않았고, 패키지에 체험 기간이 있고, 그룹의Allowed Trials가 0보다 크고, 크레딧이 그룹의Minimum Trial Credits이상이며, 집계 기간 내에 만든 체험 라인 수가 할당량에 도달하지 않았을 때입니다.

#TRI-01
TRI-02 체험 할당량은 어떤 기간으로 집계됩니까?

그룹에 설정된 대로입니다.day= 최근 24시간,month= 최근 30일입니다. 예를 들어 하루 5개 할당량이면 임의의 24시간 동안 체험 라인은 최대 5개입니다. 오래된 체험이 기간을 벗어나면 그 자리가 비워집니다.

#TRI-02
TRI-03 체험에도 크레딧이 듭니까?

패키지의 체험 가격만큼 정확히 듭니다(보통 0). 리셀러의 개별 가격은 체험에 적용되지 않습니다.

#TRI-03
TRI-04 체험 상자가 잠겨 있는 이유는 무엇입니까?

TRI-01의 조건 중 하나가 충족되지 않았기 때문이며, 양식이 상자 옆에 사유를 표시합니다.

#TRI-04
TRI-05 체험을 정식 라인으로 바꾸려면 어떻게 합니까?

패키지로 라인을 갱신하세요. 라인이 정식 기간을 갖게 되며 더 이상 체험이 아닙니다. 사용자 이름과 비밀번호는 그대로이며 고객이 다시 설정할 필요가 없습니다.

#TRI-05
TRI-06 기존 라인에 체험 기간을 한 번 더 줄 수 있습니까?

아니요. 체험은라인을 만들 때 한 번만부여됩니다. 기존 라인은 정식 기간으로만 갱신할 수 있습니다(TRI-05). 고객이 다시 체험해 보게 하려면 새 체험 라인을 만드세요(체험 할당량에 포함됩니다).

#TRI-06

재생 링크, 앱, 형식

PLAY
PLAY-01 고객에게 줄 링크는 어디에서 얻습니까?

Lines → Generate play link: 형식을 선택하면 라인의 사용자 이름과 비밀번호로 링크가 만들어집니다. API에서는get_line이 완성된 링크를 반환합니다:m3u,m3u_hls,xmltv,player_api,web_player.

#PLAY-01
PLAY-02 고객은 어떤 앱을 사용할 수 있습니까? 시청자

Xtream Codes API를 지원하는 모든 앱(IPTV Smarters, TiviMate, XCIPTV, GSE…)에서 서버 주소 + 사용자 이름 + 비밀번호를 입력하면 됩니다. 플레이리스트만 받는 앱에는M3U링크를 사용하세요.MAG박스는 포털을,Enigma2박스는 플레이리스트 / 플러그인을 사용합니다. 디바이스가 없으면 브라우저에서웹 플레이어를 사용하세요.

#PLAY-02
PLAY-03 MPEG-TS와 HLS 중 무엇을 써야 합니까?

MPEG-TS: 채널 전환이 빠르며 IPTV 앱과 셋톱박스에 적합합니다.HLS: 브라우저, Apple 기기, 불안정한 네트워크에서 잘 작동합니다. 라인은 패키지가 허용하는 형식만 사용할 수 있으며 허용되지 않은 형식의 링크는 거부됩니다.

#PLAY-03
PLAY-04 플레이리스트 유형에는 어떤 것이 있습니까?

m3u_plus(로고, 그룹, EPG ID 포함 — 권장 기본값), 일반m3u, Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive용 유형, 단순 목록 유형이 있습니다. Generate play link 대화상자에서 하나를 선택하세요.

#PLAY-04
PLAY-05 프로그램 가이드(EPG)는 어디에서 옵니까? 시청자

Xtream 앱은 스스로 가져옵니다. M3U 앱에서는 라인의XMLTV링크를 사용하세요(m3u_plus플레이리스트에는 이미 EPG 주소가 들어 있습니다).

#PLAY-05
PLAY-06 캐치업이 있습니까? 시청자

예. 관리자가 아카이브를 활성화한 채널에서 사용할 수 있으며, 앱에서 해당 채널에 캐치업 아이콘이 표시됩니다.

#PLAY-06
PLAY-07 웹 플레이어는 어디에 있고 어떻게 로그인합니까? 시청자

API 서버의/player/에 있습니다(web_player링크). 라인의 사용자 이름 / 비밀번호 또는 활성화 코드로 로그인하세요.

#PLAY-07
PLAY-08 라인 비밀번호를 바꾸면 이전 링크도 계속 작동합니까?

아니요. 비밀번호는 링크의 일부이며 앱에 저장되어 있으므로, 비밀번호를 변경하면 고객이 다시 입력하거나 새 링크를 받아야 합니다. 허락 없이 라인을 쓰는 사람을 차단하는 방법도 이것입니다.

#PLAY-08
PLAY-09 재생 링크에 내 도메인을 사용할 수 있습니까?

예. API 키 페이지의Your own play address를 설정하세요(또는set_play_baseAPI 액션 사용). 도메인의 DNS를 패널의 API 서버로 지정해야 하며또한운영자 쪽에서도 설정해야 하므로, 사용하기 전에 관리자에게 알려 주세요. 이 주소는 API가 본인 시스템에 반환하는 링크에 적용됩니다.

#PLAY-09
PLAY-10 한 링크를 여러 사람에게 줄 수 있습니까?

기술적으로는 한 라인을 공유하게 되므로동시 접속 수(SEC-01)를 함께 쓰고 두 번째 IP 규칙(SEC-03)에 걸릴 수 있습니다. 고객마다 별도의 라인을 가져야 합니다.

#PLAY-10

MAG / Enigma2 셋톱박스

DEV
DEV-01 MAG / Enigma 박스는 어떻게 추가합니까?

Devices → Add MAG / Add Enigma: MAC을 입력하고 패키지를 선택합니다. 시스템이 새 라인을 판매하고 디바이스를 한 번에 연결하며, 디바이스는 MAC으로 로그인하므로 사용자 이름 / 비밀번호를 입력할 필요가 없습니다. 크레딧은 일반 라인과 똑같이 차감됩니다.

#DEV-01
DEV-02 고객이 이미 라인이 있는데 박스를 추가하고 싶어 합니다?

디바이스 양식에서 패키지 대신 고객의기존 라인을 선택하세요. 디바이스가 해당 라인과페어링되며 무료입니다. 고객은 앱에서 라인을 계속 사용하고, 박스는 라인의 패키지, 만료일, 부케, 상태를 따릅니다.

#DEV-02
DEV-03 페어링된 앱과 박스의 연결은 어떻게 집계됩니까?

연결 제한을공유합니다. 앱과 박스는 한 명의 구독자입니다.

#DEV-03
DEV-04 박스는 어떻게 갱신합니까?

해당 라인을 갱신하세요(링크는 디바이스 양식에 있습니다). 페어링된 디바이스는 고객의 라인을 갱신하면 박스가 자동으로 따라갑니다.

#DEV-04
DEV-05 고객이 박스를 새것으로 교체합니다?

디바이스의 MAC을 편집하세요. 라인에 디바이스 잠금이 켜져 있다면, 새 박스가 등록될 수 있도록 기록된 일련번호 / 디바이스 ID를 지우세요.

#DEV-05
DEV-06 디바이스를 삭제하면 라인도 삭제됩니까?

예. 이전 패널과 마찬가지로 디바이스를 삭제하면 해당 라인도(연결 기록과 대기 중인 이벤트와 함께) 삭제됩니다. 결제한 라인을 유지하려면Convert to line버튼을 사용하세요. 디바이스는 제거되고 라인은 일반 라인이 됩니다. 고객의 라인을 삭제하면 페어링된 디바이스는 자체 라인으로 독립적으로 남습니다.

#DEV-06
DEV-07 리셀러가 박스를 원격으로 제어할 수 있습니까?

본인의MAG박스는 가능합니다. TV에 메시지 보내기, 채널 재생, 포털 새로고침, 재부팅, 라인의 연결 종료(그룹에 고객 연결 로그 조회 권한 필요), 기록된 ISP 초기화, STB 잠금 초기화가 해당됩니다.Enigma박스의 X-Plugin 명령과 스크린샷, 디바이스 차단, 디바이스를 다른 라인으로 이동하는 것은 관리자 전용입니다. 리셀러의 디바이스를 활성화 / 비활성화하면 해당 라인이 활성화 / 비활성화되며, 리셀러는 디바이스의Banned를 해제할 수 없습니다.

#DEV-07

활성화 코드

CODE
CODE-01 활성화 코드는 무엇에 쓰입니까?

접근 권한을 코드(스크래치 카드, 메시지로 보낸 코드)로 판매하는 방식입니다. 고객이 앱이나 웹 플레이어에 코드를 입력하면 사용자 이름 / 비밀번호 없이 시청할 수 있습니다. 기간은고객이 코드를 처음 활성화할 때 비로소 시작됩니다.

#CODE-01
CODE-02 코드는 어떻게 만들고 비용은 얼마입니까?

Active Codes → New: 패키지, 수량(배치당 1–500), 코드 길이(6–24), 숫자만 사용 옵션(TV 리모컨으로 입력하기 쉬움), 체험 옵션을 선택합니다. 크레딧은생성 시점에차감되며 = 패키지 가격 × 코드 수입니다. 모든 코드에는 활성화 전까지 잠겨 있는 자체 라인이 함께 만들어집니다.

#CODE-02
CODE-03 코드에는 어떤 문자가 들어갑니까?

혼동하기 쉬운 문자(0, O, 1, I)를 뺀 대문자와 숫자, 또는 숫자만 사용합니다. 고객이 소문자로 입력해도 허용됩니다.

#CODE-03
CODE-04 코드 하나를 몇 대의 디바이스에서 사용할 수 있습니까? 시청자

한 대입니다. 코드는 처음 활성화한 디바이스에 묶이며, 다른 디바이스가 같은 코드를 입력하면 거부됩니다. 해당 디바이스는 코드를 몇 번이든 입력할 수 있고 라인의 로그인 정보는 바뀌지 않습니다.

#CODE-04
CODE-05 고객이 디바이스를 바꾸면 어떻게 합니까?

해당 코드의Reset device를 실행하면 새 디바이스가 활성화할 수 있습니다. 기간은 추가되지 않습니다.

#CODE-05
CODE-06 고객이 코드를 입력할 때 오류가 납니다. 무슨 뜻입니까? 시청자
메시지의미해결 방법
INVALID_CODE잘못된 코드 / 존재하지 않는 코드모든 문자를 확인하고 대시(-)는 입력하지 않음
DEVICE_MISMATCH코드가 다른 디바이스에 묶여 있음리셀러가 디바이스를 초기화함(CODE-05)
DISABLED코드가 꺼져 있음리셀러가 다시 활성화함
EXPIRED기간이 끝남코드를 구매 / 연장

서로 다른 잘못된 코드를 연달아 여러 번 입력하면 IP 주소가 한동안 차단됩니다(SEC-08).

#CODE-06
CODE-07 활성화된 코드는 어떻게 연장합니까?

Active Codes페이지에서 코드를 체크하고Extend (days)작업을 선택한 뒤 일수를 입력합니다.활성화된코드에만 일수가 추가됩니다(사용하지 않은 코드는 아직 기간이 시작되지 않았습니다). 아직 유효한 코드는 현재 만료일부터, 만료된 코드는 지금부터 연장됩니다. 이 작업은 크레딧을 차감하지 않습니다. API에서는extend_active_code입니다.

#CODE-07
CODE-08 코드를 삭제하면 크레딧이 환불됩니까?

리셀러가 만든사용하지 않은코드는 전액 환불되며 크레딧 원장에 행이 남습니다.활성화된코드는 환불되지 않습니다.

#CODE-08
CODE-09 많은 코드를 한꺼번에 관리하려면 어떻게 합니까?

Batches페이지에 각 배치의 전체 / 준비됨 / 활성화됨 / 비활성화됨 수가 표시되며 TXT 파일(한 줄에 코드 하나)로 내보낼 수 있습니다. 일괄 작업: 활성화, 비활성화, 디바이스 초기화, 삭제.

#CODE-09
CODE-10 활성화 코드의 라인도 패키지의 제한을 따릅니까?

예. 해당 패키지로 판매된 모든 라인과 같습니다. 동시 접속 수, 출력 형식, 부케, 디바이스 잠금, restreamer, 그리고 패키지의강제 국가(SEC-07)도 적용됩니다. 허용 목록 밖의 국가에서 코드를 활성화한 고객은 활성화는 할 수 있지만 재생할 때 거부됩니다.

#CODE-10

연결 제한과 라인을 보호하는 잠금

SEC
SEC-01 "Max connections"는 어떻게 집계됩니까?

한 라인으로동시에시청하는 디바이스 수입니다. 0 = 무제한. 이미 보고 있는 채널을 같은 디바이스에서 다시 열어도 추가 연결로 계산되지 않습니다.

#SEC-01
SEC-02 한도를 초과하면 누가 연결이 끊깁니까? 시청자

기본적으로새연결이 들어오고가장 오래된연결이 닫힙니다(같은 디바이스의 연결을 우선하고, 그다음 같은 IP). 닫힌 플레이어는 약 30초 안에 멈춥니다. 관리자는 기존 연결을 닫는 대신새 연결을 거부하도록 바꿀 수 있습니다.

#SEC-02
SEC-03 "두 번째 IP" 규칙이란 무엇입니까?

관리자가 켜 두면, 라인이 한 IP에서 시청되는 동안 다른 IP의 라이브 연결은 거부됩니다. 이 규칙은 연결 수가 적은 라인으로 한정할 수 있습니다(예: 연결 1개인 라인. 무제한 연결 라인은 임계값이 0일 때만 묶임).Match The Address By Network를 켜면 같은 /24 네트워크(IPv6는 /64)의 주소를 한 시청자로 봅니다. 계정 공유를 막는 수단입니다.

#SEC-03
SEC-04 라인을 특정 IP나 앱으로 제한할 수 있습니까?

그룹에Allow Line Restrictions가 켜져 있으면Allowed IPs필드(IP, CIDR 범위, 도메인 이름을 한 줄에 하나씩. 도메인은 연결 시점에 조회하므로 유동 IP도 작동)와Allowed User-Agents를 쓸 수 있습니다. 비어 있으면 모두 허용입니다. 참고: 이 제한은재생시점에 차단하며, 앱은 여전히 로그인되고 채널 목록을 표시합니다.

#SEC-04
SEC-05 ISP 잠금이란 무엇입니까?

라인이 첫 연결의 인터넷 제공업체를 기억하고 다른 제공업체에서의 사용을 거부합니다. 고객이 제공업체를 바꾸면 ISP 잠금을 껐다가 다시 켜서 새 제공업체를 기록하세요. MAG 박스에는 적용되지 않습니다.

#SEC-05
SEC-06 디바이스 잠금이란 무엇입니까?

라인을 처음 로그인한 셋톱박스(일련번호, 디바이스 ID)에 묶으며 다른 박스는 거부됩니다. 패키지에서 결정합니다.

#SEC-06
SEC-07 국가 제한은 어떻게 작동합니까?

라인은 강제 국가(ALL= 어디서나)에서만 연결할 수 있습니다. 비어 있으면 패널의 일반 허용 국가 목록이 적용됩니다. 해외여행 중이거나 VPN을 사용하는 고객은 이 사유로 거부될 수 있습니다.

#SEC-07
SEC-08 IP 주소가 차단되는 이유는 무엇입니까? 시청자
  • 자동: 한 IP에서 짧은 시간에 여러 서로 다른 사용자 이름 / 활성화 코드로 로그인에 실패하거나 요청이 폭주한 경우. 자동 차단은 관리자가 설정한 시간(기본 60분)이 지나면 스스로 풀립니다.
  • 수동: 관리자가 IP / IP 범위를 차단한 경우로, 만료되지 않습니다.

IP가 차단된 동안에는 그 IP에서어떤라인도 연결할 수 없습니다. 같은 사용자 이름을 반복해서 잘못 입력하는 것만으로는 차단되지 않습니다.

#SEC-08
SEC-09 연결이 차단되는 다른 이유에는 무엇이 있습니까?

관리자는User-Agent(앱),인터넷 제공업체(ISP),ASN(예: 호스팅 / VPN 대역)으로 차단할 수 있습니다. 관리자가 "bypass UA"를 켠 라인은 앱 차단 목록을 건너뜁니다.

#SEC-09
SEC-10 restreamer란 무엇입니까?

스트림을 가져가 재배포하는 파트너를 위한 라인입니다. 동시 접속 제한, 두 번째 IP 규칙, 긴 세션 자동 종료, ASN 차단에서 제외됩니다. 패키지 / 관리자가 결정하며 일반 시청자용이 아닙니다.

#SEC-10
SEC-11 아주 긴 연속 세션은 끊깁니까? 시청자

관리자가 연속 세션의 최대 시간을 설정할 수 있으며, 그 시간이 지나면 세션이 닫히고 고객이 재생을 눌러 이어서 시청합니다. 약 90초 동안 신호가 끊긴 세션도 닫힌 것으로 처리됩니다.

#SEC-11
SEC-12 공유되거나 도용된 라인은 어떻게 찾습니까?
  • Theft Detection페이지(그룹에 권한이 있는 경우): 1시간 / 24시간 / 7일 동안 시청한서로 다른영화 / 에피소드 수를 서로 다른 IP 수와 함께 순위로 보여 줍니다. 유난히 높은 라인은 의심스럽습니다.
  • 라인의 활동 페이지: 사용 중인 IP와 디바이스를 보여 줍니다.
  • 대처 방법: 라인의 비밀번호를 변경하거나(PLAY-08), IP 제한 / ISP 잠금을 켜거나, 라인을 비활성화하세요.
#SEC-12

서브 리셀러

SUB
SUB-01 서브 리셀러를 만들 수 있습니까?

그룹에Can Create Sub-Resellers가 켜져 있고Groups for sub-resellers에 그룹이 하나 이상 있을 때 가능합니다. 생성할 때마다 그룹에 설정된 생성 요금(크레딧)이 차감됩니다. 리셀러 트리는 최대 5단계 깊이입니다.

#SUB-01
SUB-02 서브 리셀러는 어떤 그룹에 속하며 무엇을 할 수 있습니까?

관리자가 허용한 목록에서 그룹을 선택합니다. 그 그룹이 서브 리셀러의 권한, 판매 가능한 패키지, 체험 할당량을 결정합니다.

#SUB-02
SUB-03 서브 리셀러에 대해 무엇을 관리할 수 있습니까?

이메일, 이름, 비밀번호, 상태, 그룹(목록에서 선택), 메모, 크레딧 이체 / 회수, 그리고 그 아래의 모든 라인입니다. 역할이나 소유자는 변경할 수 없습니다.

#SUB-03
SUB-04 서브 리셀러는 내 정보 중 무엇을 볼 수 있습니까?

아무것도 볼 수 없습니다. 모든 계정은 자신의 아래만 볼 수 있으며 상위 단계나 다른 가지는 볼 수 없습니다.

#SUB-04
SUB-05 서브 리셀러를 삭제하면 그 라인과 크레딧은 어디로 갑니까?

그룹에Can Delete Users가 켜져 있어야 합니다. 남은 크레딧, 라인, 하위 계정은삭제하는 계정으로 이동합니다. 고객의 라인은 계속 작동합니다. 삭제된 계정의 개인정보(사용자 이름, 이메일, 이름, 비밀번호, API 키, 메모)는 지워지며 해당 사용자 이름과 이메일은 다시 사용할 수 있습니다.

#SUB-05
SUB-06 새 서브 리셀러는 이메일을 받습니까?

관리자가 환영 이메일을 켜 두었다면 새 계정이 로그인 이름과 로그인 링크를 받습니다. 이메일에는 비밀번호가절대포함되지 않으므로 비밀번호는 직접 전달하세요.

#SUB-06

카테고리 템플릿

CAT
CAT-01 카테고리 템플릿은 무엇에 쓰입니까?

고객이 앱에서 보는 카테고리(라이브, 영화, 시리즈, 라디오)를 라인별로 재정렬하거나 이름을 바꾸거나 숨기기 위한 것이며, 패널 자체의 카테고리는 건드리지 않습니다.

#CAT-01
CAT-02 카테고리를 숨기면 어떻게 됩니까?

해당 카테고리의 모든 콘텐츠도 템플릿을 사용하는 라인의 앱과 플레이리스트에서 함께 숨겨집니다.

#CAT-02
CAT-03 템플릿을 편집하면 그것을 사용하는 라인도 바뀝니까?

예. 템플릿이 지정된 모든 라인에 즉시 반영됩니다. 템플릿을 삭제하면 해당 라인은 기본 구성으로 돌아갑니다.

#CAT-03
CAT-04 어떤 템플릿을 보고 편집할 수 있습니까?

보기: 본인 템플릿, 하위 계정의 템플릿, 시스템 템플릿, 상위 단계가 공유한 템플릿. 편집: 본인과 하위 계정의 템플릿만. 시스템 템플릿을 조정하려면복제한 뒤 복사본을 편집하세요.

#CAT-04
CAT-05 알아 둘 만한 제한이 있습니까?

사용자 지정 카테고리 순서는 M3U 플레이리스트의 영화 / 시리즈 부분에는 적용되지 않습니다(이름과 숨김은 적용됨). Xtream API를 사용하는 앱은 모든 것을 받습니다.

#CAT-05

Reseller API, API 키, 웹훅

API
API-01 Reseller API는 무엇에 쓰입니까?

대시보드를 열지 않고 본인의 시스템(웹 쇼핑몰, 청구, 봇)에서 라인 / 서브 리셀러를 판매하고 관리하기 위한 것입니다. 주소:{API}/reseller/v1,X-API-Key헤더로 인증합니다. 전체 문서는 API 서버의/docs/에 있습니다.

#API-01
API-02 API 키는 어디에서 얻습니까?

API Key페이지입니다. 키는 생성할 때한 번만표시되므로 즉시 복사하세요. 잃어버리면 새 키를 만드세요(이전 키는 작동하지 않게 됩니다).

#API-02
API-03 모든 시스템에 키 하나를 써도 됩니까?

권장하지 않습니다. 시스템마다추가 키를 만드세요. 이름을 붙이고, 사용할 수 있는 IP / CIDR을 제한하고, 필요하면읽기 전용(목록과 조회만)으로 만들 수 있으며, 다른 키에 영향을 주지 않고 해당 키만 폐기할 수 있습니다.

#API-03
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-04
API-05 네트워크 오류 후 재시도하면 두 번 차감됩니까?

아니요. 같은 거래에 같은request_id를 보내는 한 시스템이 이전 결과를 반환합니다. 갱신의request_id는해당 라인에 묶여있습니다. 다른 라인에 재사용하면 충돌 오류(HTTP 409)가 반환되고 다른 라인은 바뀌지 않으므로, 거래마다 새request_id를 생성하세요.

#API-05
API-06 연동이 작동하지 않습니다. 직접 어떻게 확인합니까?

API Key 페이지에최근 API 호출(30일) 표가 있습니다. 액션, 결과, 오류 코드, 호출 주소, 커넥터 이름이 표시됩니다. 파라미터는 절대 기록되지 않습니다.

#API-06
API-07 웹훅이란 무엇이며 어떤 이벤트가 있습니까?

무언가 일어났을 때 패널이 시스템에 알려 주므로 계속 물어볼 필요가 없습니다. 이벤트:line.created,line.renewed,line.enabled,line.disabled,line.deleted,line.expiring(3일 전),line.expired,credits.low(설정한 임계값 미만). 수신 주소는 https여야 하며 인터넷에서 접근할 수 있어야 합니다.

#API-07
API-08 웹훅이 진짜인지 어떻게 압니까?

모든 알림에는 서명X-Xtream-Signature: sha256=HMAC(secret, timestamp.body)가 포함되며, 시크릿은 엔드포인트를 만들 때 한 번만 표시됩니다. 웹훅에는 비밀번호가 절대 포함되지 않습니다.

#API-08
API-09 웹훅 전송이 멈췄습니다?

모든 알림은 3번 시도되며, 연속 20번 전송에 실패한 엔드포인트는 꺼집니다. 본인 쪽 문제를 고치고Send test를 사용한 뒤, 꺼졌다면 엔드포인트를 다시 만드세요.

#API-09
API-10 API가 라인 비밀번호를 반환합니까?

예, 하지만 라인의 소유자(본인과 트리의 상위 단계)에게만 반환합니다. 라인 비밀번호를 로그에 저장하거나 안전하지 않은 채널로 보내지 마세요.

#API-10
API-11 `edit_line`으로 라인을 갱신할 수 있습니까?

예,package_id를 함께 보내면 가능합니다(이전 이름package도 허용). 편집과 함께change_package와 똑같이 해당 패키지의 정식 기간 한 번을 판매하며, 가격과request_id도 같고 응답에credits_charged가 포함됩니다. 편집과 갱신은 하나의 트랜잭션이며, 거부되면(크레딧 부족, 잘못된 패키지,trial을 함께 보낸 경우) 아무것도 바뀌지 않습니다. 패키지없는 edit_line은 사용자 이름, 비밀번호, 연락처, 메모만 편집하며 패키지나 만료일은 건드리지 않습니다.

#API-11
API-12 이전(PHP) 패널용으로 작성한 스크립트가 이 API에서 작동합니까?

그대로는 작동하지 않습니다. API는 익숙한 액션 이름을 유지하지만 새로운 인터페이스입니다. 주소는/reseller/v1, 이 패널에서 만든 API 키를 사용하고, 쓰기 액션은 POST로 보내며, 오류는error필드가 있는 HTTP 상태로 반환되고, 라인 생성 결과는data.line에 있습니다./docs/의 문서나 기성 커넥터(CON-02)를 사용하세요.

#API-12

쇼핑몰 / 결제 시스템용 커넥터

CON
CON-01 고객에게 대금은 어떻게 받습니까?

본인의시스템과 결제 게이트웨이로 받습니다. 패널은 결제를 처리하지 않습니다. 커넥터가 쇼핑몰 시스템을 패널에 연결합니다. 고객이 본인 쪽에서 결제 → 커넥터가 Reseller API를 호출해 라인을 생성 / 갱신합니다.

#CON-01
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-02
CON-03 어디에서 다운로드하고 설치합니까?

사이드바Resources → All Connectors: 모든 커넥터에는 설명, 연결 정보, 설치 단계,Download버튼, 파일 검증용 SHA-256이 있습니다.

#CON-03
CON-04 커넥터는 얼마나 테스트되었습니까?

커넥터마다 다르며 각 커넥터 페이지에 적혀 있습니다. 일부는 실제 플랫폼 안에서 실행했고(예: WordPress + WooCommerce, Odoo, FOSSBilling, Paymenter), 일부는 핵심 부분만 실행했습니다. "테스트 방법" 줄을 읽고 실제로 판매하기 전에 테스트 환경에서 먼저 시도해 보세요.

#CON-04
CON-05 커넥터는 안전하며 패널에 무엇을 합니까?

커넥터는본인의API 키로 Reseller API를 호출할 뿐이며, 본인이 할 수 있는 일만 정확히 할 수 있고 그 이상은 할 수 없습니다. 소스 코드는 공개되어 있어 직접 읽고 확인할 수 있습니다. 커넥터마다 IP 제한이 있는 별도 키를 주세요(API-03).

#CON-05
CON-06 커넥터는 무엇을 판매할 수 있습니까?

라인(생성, 갱신, 패키지 변경, 일시 중지, 삭제)과 크레딧이 있는 서브 리셀러 계정입니다.

#CON-06
CON-07 내 플랫폼용 커넥터가 아직 없습니다?

Reseller API(API-01)와 웹훅으로 직접 연동하거나, 지원 채널로 요청을 보내 주세요.

#CON-07

데이터, 삭제, 개인정보

DATA
DATA-01 삭제된 라인을 복원할 수 있습니까?

아니요. 삭제하면 사라집니다. 라인의 정보(사용자 이름, 비밀번호, 연락처, 메모), 연결 기록(IP, 디바이스, 시청 내역), 라인에 연결된 셋톱박스, 활성화 코드가 모두 삭제됩니다. 휴지통도, 복원 기능이나 API도 없습니다. 고객이 돌아오면 새 라인을 만드세요.

#DATA-01
DATA-02 삭제 후 시스템에 무엇이 남습니까?

운영자를 위한익명통계 기록(신규 또는 재방문 고객, 인기 패키지)만 남습니다. 고객에 대해 읽을 수 있는 정보는 전혀 없으며 어떤 리셀러, 커넥터, API도 접근할 수 없습니다.

#DATA-02
DATA-03 백업으로 삭제된 라인을 되살릴 수 있습니까?

아니요. 데이터베이스 백업은 장애 후 시스템을 복구하기 위한 것이며 운영자가 보관합니다. 삭제를 되돌리는 데 사용되지 않습니다. 오래된 백업은 순환 삭제되므로 삭제된 데이터는 백업에서도 사라집니다.

#DATA-03
DATA-04 라인 비밀번호는 읽을 수 있는데 패널 비밀번호는 왜 읽을 수 없습니까?

라인 비밀번호는 앱에 입력해야 하고 플레이리스트 링크의 일부이므로 패널이 라인 소유자가 읽을 수 있도록 보관합니다. 패널 계정 비밀번호는 해시되어서만 저장됩니다.

#DATA-04
DATA-05 누가 내 라인과 고객을 볼 수 있습니까?

본인, 트리에서 본인의 상위 계정, 관리자입니다. 다른 리셀러와 본인의 하위 단계는 볼 수 없습니다.

#DATA-05
DATA-06 패널이 고객에게 이메일 / 메시지를 보냅니까?

절대 보내지 않습니다. 라인의 고객은 리셀러의 고객이며, 본인의 시스템을 통해 직접 연락하세요.

#DATA-06
DATA-07 라인이 만료되기 전에 알려 줍니까?

두 가지 방식으로 알려 줍니다. 만료가 임박한 라인의 일일 요약 이메일(관리자가 켠 경우, 기본 3일 전), 그리고 본인 시스템용line.expiring/line.expired웹훅입니다.

#DATA-07

문제 해결

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: 차단이 풀릴 때까지 기다리거나 관리자에게 해제 요청
7ISP 잠금 / 국가 / Allowed IPs네트워크 변경, 모바일 데이터, VPN 사용, 여행 중에만 실패SEC-04,SEC-05,SEC-07
8형식HLS / TS 링크가 거부됨패키지가 허용하는 형식 사용(PLAY-03)
9차단된 앱한 앱에서만 실패다른 앱 시도.SEC-09
#FIX-01
FIX-02 로그인은 되고 목록도 보이는데 채널이 재생되지 않음 시청자

대개 재생 잠금 중 하나입니다(FIX-01의 5–9행). 로그인과 채널 목록은 IP / 앱을 확인하지 않고 재생만 확인합니다.한채널만 모든 라인에서 실패한다면 → 원본 채널에 문제가 있으므로 관리자에게 채널 이름과 시각을 알려 주세요.

#FIX-02
FIX-03 채널이나 채널 그룹이 보이지 않음 시청자

라인의 부케(PKG-04,PKG-05)와 지정된 카테고리 템플릿(CAT-02)을 확인하세요. 변경 후에는 고객에게 앱에서 목록을 새로고침하도록 요청하세요. 관리자가 방금 추가한 채널은 약 30초 뒤에 나타납니다. 채널이 부케에 있는데 어떤 라인에도 보이지 않는다면 관리자가 그 채널의 송출을 내렸을 수 있습니다.

#FIX-03
FIX-04 끊김, 멈춤 시청자

순서대로 시도하세요. 다른 채널(한 채널만인지 전체인지) → 다른 네트워크 → 다른 형식(MPEG-TS 대신 HLS) → 다른 앱. 모든 채널이 모든 네트워크에서 실패하면 → 지원팀에 사용자 이름, 시각, 채널을 알려 주세요.

#FIX-04
FIX-05 프로그램 가이드(EPG)가 없음 시청자

M3U 앱에는 XMLTV 링크를 추가해야 합니다(PLAY-05). 원본에 EPG가 없는 채널은 편성표가 표시되지 않습니다.

#FIX-05
FIX-06 라인을 만들 수 없음

순서대로 확인하세요. 패키지를 선택하지 않음 · 패키지가 내 그룹용이 아님(PKG-02) · 크레딧 부족(CRD-05) · 사용자 이름이 이미 사용 중이거나 최소 길이보다 짧음(LINE-02) · 체험 할당량을 모두 사용함(TRI-01).

#FIX-06
FIX-07 플레이리스트를 다운로드하면 오류 429 또는 404 페이지가 나옴

429: 라인이 한꺼번에 너무 많은 플레이리스트 / EPG 파일을 다운로드하고 있으니 기다렸다가 다시 시도하세요. 404 페이지: 시스템은 낯선 사람에게 사유가 드러나지 않도록모든거부(잘못된 정보, 만료, 잠금, 한도 초과)에 404로 응답합니다.FIX-01로 확인하세요.

#FIX-07
FIX-08 대시보드의 페이지를 열 수 없음

내 그룹에 해당 페이지의 권한이 없습니다(ACC-02).Live Connections는 추가로 관리자가 그룹에 고객 연결 조회 옵션을 켜 두어야 합니다(LINE-15).

#FIX-08
FIX-09 패널에서 이메일이 오지 않음

이메일은 관리자가 메일 서버를 설정하고 해당 종류의 메시지를 켠 경우에만 발송되며, 계정에 실제 이메일 주소가 있어야 합니다. 스팸 폴더를 확인하세요.

#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)
무언가 일어났을 때 패널이 리셀러의 시스템으로 보내는 알림

아직 해결되지 않았나요?

라인의 사용자 이름(비밀번호는 절대 보내지 마세요), 발생 시각, 사용한 앱 또는 디바이스, 이미 시도한 질문의 코드를 보내 주세요.