> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AgencyHandy의 구독 청구 및 반복 인보이스

> AgencyHandy의 반복 구독 청구 처리 방식 — 자동 인보이스, 청구 주기, 결제 방법, 해지, Wise 결제 링크.

AgencyHandy의 구독 청구 시스템을 통해 전체 반복 수익 워크플로우를 자동화할 수 있습니다. 클라이언트가 서비스를 구독하면 플랫폼이 구독 ID를 생성하고, 주문을 만들고, 매 청구 주기(일별, 주별, 월별, 연별)마다 자동으로 인보이스를 발행합니다. 모든 것을 제어할 수 있습니다: AgencyHandy 내에서 구독 세부 정보를 보고, 결제 내역을 모니터링하고, 미결제를 처리하고, 필요시 구독을 해지할 수 있습니다.

## 구독 청구 작동 방식

AgencyHandy의 구독 수명 주기는 6가지 주요 단계를 따릅니다.

<Steps>
  <Step title="구독 기반 서비스 생성">
    **Services**로 이동하여 **Create New Service**를 클릭합니다. 서비스 유형으로 **Subscription**을 선택합니다.

    다음을 정의합니다:

    * **Billing Cycle** — 일별, 주별, 월별, 또는 연별
    * **Renewal Behavior** — 새 주문 생성, 기존 주문 업데이트, 또는 변경 없음
    * **Pricing & Payment Method** — PayPal, Stripe, 또는 수동

    **Publish**를 클릭하여 서비스를 사용 가능하게 합니다.
  </Step>

  <Step title="클라이언트의 구독 구매">
    클라이언트가 구독 서비스를 선택하고 결제 단계로 진행한 후 결제 방법을 선택합니다.

    AgencyHandy는 자동으로:

    * **구독 ID** 생성
    * **주문** 생성
    * **인보이스** 발행

    **PayPal 또는 Stripe** 결제 시 인보이스가 즉시 **Paid**로 표시됩니다. **수동 결제**의 경우 에이전시가 수령을 확인할 때까지 인보이스가 **Open** 상태로 유지됩니다.
  </Step>

  <Step title="자동 반복 청구">
    각 갱신일에 AgencyHandy는 자동으로 결제를 처리하고(PayPal/Stripe의 경우) 다음 인보이스를 생성합니다.

    결제가 성공하면 인보이스가 **Paid**로 표시됩니다. 실패하면:

    * 인보이스가 **Open** 상태로 유지됩니다
    * 클라이언트가 **결제 실패 알림**을 받습니다
    * 에이전시는 재시도하거나 업데이트된 결제 정보를 요청하라는 알림을 받습니다
  </Step>

  <Step title="활성 구독 관리">
    왼쪽 사이드바에서 **Subscription Management**로 이동하여 모든 활성 및 비활성 구독을 볼 수 있습니다. 구독을 선택하면 전체 세부 정보를 확인할 수 있습니다.
  </Step>

  <Step title="해지 처리">
    구독을 해지할 때 다음 중 하나를 선택할 수 있습니다:

    * **완전 해지** — 향후 모든 청구 및 주문 중단
    * **마지막 활성 주문 유지** — 현재 기간 마감일까지 클라이언트가 계속 서비스를 이용할 수 있도록 허용

    서비스를 완전히 삭제하려면 해당 서비스의 모든 활성 구독을 먼저 해지해야 합니다.
  </Step>

  <Step title="알림">
    시스템이 자동으로 전송하는 항목:

    * 다음 청구 날짜 전 **갱신 알림**
    * 성공적인 결제 후 **결제 확인**
    * 클라이언트와 에이전시 어드민 모두에게 **결제 실패 알림**
  </Step>
</Steps>

## 구독 상세 페이지

구독 상세 페이지에서는 서비스와 패키지부터 모든 인보이스 및 이벤트 로그 항목에 이르기까지 개별 구독에 대한 전체 정보를 볼 수 있습니다.

### 접근 방법

1. 왼쪽 사이드바에서 **Subscriptions**로 이동합니다
2. 목록에서 구독을 클릭하여 상세 페이지를 엽니다

### 확인 가능한 내용

<Tabs>
  <Tab title="구독 정보">
    * **서비스 이름** 및 **패키지 이름**
    * **클라이언트 이름**
    * **청구 주기** (예: 월별, 연별)
    * **시작일** 및 **종료일**
    * 구독 **상태** (활성 또는 비활성)
  </Tab>

  <Tab title="결제 세부 정보">
    * **구독료**
    * 현재까지 **총 결제 횟수**
    * **결제 방법** (Stripe, PayPal, Wise, 수동 은행 이체 등)
    * **다음 결제 날짜**
  </Tab>

  <Tab title="주문 이력">
    * **주문 ID**
    * **상태** (예: 진행 중, 완료)
    * 각 주문의 **시작일** 및 **마감일**
  </Tab>

  <Tab title="인보이스 이력">
    * **인보이스 ID**
    * **금액**
    * **상태** (Open, Paid 등)
    * **결제 날짜** 및 **마감 날짜**
  </Tab>

  <Tab title="이벤트 로그">
    구독과 관련된 모든 활동(상태 변경, 결제 이벤트, 해지 등)의 시간순 감사 추적.
  </Tab>
</Tabs>

<Note>
  단일 구독에 여러 개의 연결된 주문과 인보이스가 있을 수 있습니다. 구독에 연결된 인보이스는 결제가 수령될 때 동적으로 업데이트됩니다.
</Note>

## 수동 구독 인보이스를 위한 Wise 지원

국제 결제를 수령하는 경우, 구독 인보이스에 **Wise 결제 링크**를 직접 포함할 수 있습니다. 이를 통해 클라이언트가 수동으로 은행 이체를 설정할 필요 없이 편리하게 결제할 수 있습니다.

### 요구 사항

* 활성 AgencyHandy 계정
* 유효한 결제 링크가 생성된 활성 **Wise 계정**

### 인보이스에 Wise 링크 추가 단계

<Steps>
  <Step title="인보이스 섹션 열기">
    왼쪽 사이드바에서 **Invoices**를 클릭한 후 **+ Create Invoice**를 클릭합니다.
  </Step>

  <Step title="클라이언트 및 주문 선택">
    드롭다운에서 클라이언트를 선택합니다. 관련된 모든 주문 ID가 표시됩니다. 해당 주문 ID를 선택하고 청구 금액 및 항목을 입력합니다.
  </Step>

  <Step title="할인 및 세금 적용">
    해당하는 할인 비율, 할인 금액, 결제된 금액, 미결제 금액, 부가세/세금 세부 정보를 추가합니다. 필요에 따라 청구 주소와 메모를 포함합니다.
  </Step>

  <Step title="Wise 결제 링크 추가">
    **Payment Method** 섹션에서 결제 옵션으로 **Wise**를 선택합니다. 제공된 필드에 Wise 결제 링크를 붙여넣습니다.
  </Step>

  <Step title="인보이스 저장">
    **Save**를 클릭하여 인보이스를 완료합니다. Wise 결제 링크가 인보이스에 표시되어 클라이언트가 직접 결제할 수 있습니다.
  </Step>
</Steps>

<Tip>
  저장하기 전에 Wise 결제 링크와 인보이스 합계를 항상 다시 확인하세요. 청구 오류를 방지하기 위해 주문 세부 정보, 할인, 세금 정보가 정확한지 확인하세요.
</Tip>

## 구독 청구에 관한 중요 참고 사항

<Accordion title="구독을 해지할 수 있는 사람은 누구인가요?">
  **슈퍼 어드민**과 **어드민**만 구독을 해지할 수 있습니다. 클라이언트는 직접 구독을 해지할 수 없으며 에이전시를 통해 해지를 요청해야 합니다.
</Accordion>

<Accordion title="구독 ID는 영구적입니다">
  구독이 생성되면 구독 ID를 수정할 수 없습니다. 이는 구독 수명 전체에 걸쳐 일관된 추적을 보장합니다.
</Accordion>

<Accordion title="결제 실패 및 주문 생성">
  결제가 실패하면 인보이스가 Open 상태로 유지되고 실패한 기간에 대해 새 주문이 생성됩니다. 어드민이 수동으로 결제를 재시도하거나 구독을 해지할 때까지 구독 상태는 **활성**으로 유지됩니다.
</Accordion>

<Accordion title="수동 결제 주문">
  클라이언트가 Stripe 또는 PayPal 외부에서 결제하는 경우(예: 은행 이체), 어드민이 AgencyHandy에서 인보이스를 수동으로 **Paid**로 표시해야 합니다. 시스템은 수동 결제를 자동으로 처리하지 않습니다.
</Accordion>

<Accordion title="미결제 셀프 결제 시도">
  클라이언트가 구독 결제 단계를 시작했지만 결제를 완료하지 않으면, 성공적으로 구독할 때까지 시스템에서 **리드**로 남아 있습니다.
</Accordion>

<Accordion title="인보이스 마감 날짜">
  구독 인보이스의 마감 날짜는 설정한 청구 주기를 기반으로 자동으로 설정됩니다(예: 월별 인보이스는 시작일로부터 한 달 후가 마감일).
</Accordion>