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

# 구독 업셀 참조

이 페이지는 구독 업셀(Subscription Upsell)의 작동 방식과 플랫폼 규칙을 담고 있어요: 구독이 추가되는 방식, 플랜과 할인이 결정되는 방식, 고객에게 보이는 내용, 풀필먼트, Shopify 플랫폼 제한 사항, 전체 문제 해결 목록. 만드는 방법은 [구매 후 오퍼의 구독](/ko/aftersell/subscriptions_in_post_purchase_offers)을 참고하세요.

<div id="how-the-subscription-is-added">
  ## 구독이 추가되는 방식
</div>

구독 업셀은 Shopify의 기본 `add_subscription` 구매 후 변경 세트를 사용해요. 이 흐름에서 Aftersell은 구독 앱의 API를 직접 호출하지 않아요. 구독은 Shopify가 생성하고, 구독 앱이 자체 Shopify 통합을 통해 이를 가져가요. 그래서 구독 업셀은 Shopify의 기본 Subscription API를 사용하는 모든 구독 앱과 함께 작동해요.

구독의 첫 주기는 **원래 Shopify 주문**에서 일반 라인 항목으로 처리돼요. 이후 갱신은 일반 체크아웃 중에 생성된 구독과 마찬가지로 구독 제공업체가 관리해요.

<div id="compatible-subscription-platforms">
  ## 호환되는 구독 플랫폼
</div>

구독 업셀은 Aftersell 측에서 제공업체에 완전히 독립적이에요. Aftersell은 Shopify의 기본 `add_subscription` 변경 세트로 구독을 추가하고, Shopify는 Shopify Subscription API에 설치된 구독 앱으로 등록을 전달해요. Shopify의 기본 Subscription API를 사용하는 모든 구독 앱은 추가 설정 없이 작동하며, 여기에는 Recharge, Skio, Loop, Stay.ai, Appstle, Smartrr, Bold Subscriptions(Shopify 기본 구독 API에서 실행되는 경우), Shopify 기본 판매 플랜이 포함돼요.

구독 앱에서 만든 판매 플랜은 자동으로 Aftersell에 불러와져요. (구독 업그레이드 호환성은 이와 다르며 제공업체별로 달라요. [구독 업그레이드](/ko/aftersell/subscription-upgrades)를 참고하세요.)

<div id="how-selling-plans-resolve">
  ## 판매 플랜이 결정되는 방식
</div>

<div id="allowed-subscription-plans">
  ### 허용된 구독 플랜
</div>

**Allowed subscription plans** 설정은 **변형별로** 적용되는 허용 목록이에요. 고객이 선택한 변형에 대해서는 해당 변형에서 사용할 수 있는 허용된 플랜만 표시돼요:

* 허용된 플랜이 정확히 하나만 적용되면 그 이름이 고정 텍스트로 표시되며 선택할 필요가 없어요.
* 여러 개가 적용되면 고객이 **Purchase options** 드롭다운에서 선택해요.
* 하나도 적용되지 않으면 해당 변형은 자체 플랜을 모두 표시하는 방식으로 대체돼요.

이러한 변형별 범위 덕분에 하나의 허용 목록으로 변형마다 다른 판매 플랜이 있는 제품도 올바르게 처리할 수 있어요. 변형에 허용된 플랜이 하나도 없다면(Shopify에서 플랜이 제거되거나 비활성화된 경우), 고객이 여전히 구매를 완료할 수 있도록 오퍼는 해당 변형의 사용 가능한 모든 플랜을 표시해요. 제품의 구매 옵션을 일회성 구매 전용으로 변경하면 허용된 플랜 설정도 자동으로 지워지므로, 구독 옵션이 제거될 때의 구성 오류를 방지해요.

<div id="which-selling-plan-is-shown-by-default">
  ### 기본으로 표시되는 판매 플랜
</div>

**Allowed subscription plans**에서 선택한 플랜이 없으면, 오퍼는 Shopify에서 제품에 구성된 **첫 번째 판매 플랜**을 미리 선택해요. 해당 변형에서 사용할 수 있는 플랜이 둘 이상이면 고객이 **Purchase options** 드롭다운에서 변경할 수 있어요. 고객에게 보이는 플랜을 제어하려면:

* **플랜 제한하기**(권장). **Allowed subscription plans** 다중 선택을 사용하세요. 정확히 하나만 허용하면 고객은 드롭다운 없이 해당 플랜만 보게 돼요.
* **Shopify에서 판매 플랜 순서 바꾸기.** 제품의 판매 플랜 순서에 따라 먼저 표시되는 플랜이 결정돼요.
* **사용하지 않는 판매 플랜을 제품에서 제거하기.** 여러 주기가 있는데 하나만 노출하고 싶다면 관련 판매 플랜만 제품에 연결해 두세요.

유지율에 가장 중요한 요소는 주기를 실제 제품 사용 기간에 맞추는 것이에요. 한 병이 60일 가는 샴푸를 30일 구독으로 판매하면 취소되고, 30일 가는 제품을 60일 구독으로 판매하면 건너뛰게 돼요. 일회성 재주문 데이터를 보고 제품별 자연스러운 주기를 찾으세요.

<div id="how-subscription-discounts-are-shown">
  ## 구독 할인이 표시되는 방식
</div>

구독 업셀 오퍼의 할인은 **첫 청구 주기에만** 적용되며, 이후 반복 주문은 일반 구독 가격으로 청구돼요. 구매 후 오퍼에는 두 가지 가격이 구분되어 표시돼요:

* **Accept Offer 버튼**과 라인 항목 소계에는 첫 주기 할인을 포함한 **첫 주기 가격**이 반영돼요.
* **Recurring subtotal** 필드에는 **이후 갱신** 시 일반 구독 가격으로 청구될 금액이 표시돼요.

일반적인 첫 주기 할인(첫 배송 10\~25% 할인)에서는 명확하게 읽혀요. 그러나 100% 할인 같은 극단적인 첫 주기 할인에서는 \$0인 첫 주기 가격이 아니라 반복 가격이 더 눈에 띄는 숫자이기 때문에 혼란스러울 수 있어요. 첫 배송을 무료로 제공하려는 경우 오퍼 문구에 명확히 표시하세요("첫 박스 무료, 이후 30일마다 \$59.99").

할인은 **퍼센트**(예: 15% 할인) 또는 **정액**(예: \$5 할인)으로 설정할 수 있어요. 할인은 구독 앱을 통해 적용되는 것이 아니라 Shopify의 `add_subscription` 변경 세트에 포함되며, 이 오퍼로 생성된 구독에만 영향을 줘요.

<Warning>
  **Apply discount to subscriptions**를 체크해야만 할인이 구독에 적용돼요. 체크하지 않으면 `add_subscription` 변경 세트에 할인이 포함되지 않아 구독이 정가로 청구되며, 오퍼의 할인은 일회성 라인에만 적용돼요.
</Warning>

<div id="what-the-customer-sees">
  ## 고객에게 보이는 내용
</div>

고객이 구독 업셀을 수락하면 두 시스템에 걸쳐 세 가지 일이 발생해요.

**Shopify 주문에서.** 주문 확인에는 **원래의 일회성 라인 항목**과 (할인된 첫 주기 가격으로 청구된) **새 구독 라인 항목**이 모두 포함돼요. 고객은 원래 주문에서 두 라인 모두에 대해 결제하며, 첫 구독 배송은 이 주문에서 일반 라인 항목으로 발송돼요.

**이메일 확인에서.** Shopify는 두 라인 항목이 모두 포함된 표준 주문 확인 메일을 보내요. 구독 제공업체는 일반적으로 반복 일정을 설명하는 자체 구독 환영 이메일을 보내요. 환영 이메일이 수락 후 몇 분 내에 고객 이름과 제품, 주기, 다음 청구일, 고객 포털 바로가기 링크와 함께 발송되도록 구성하세요.

**구독 제공업체 포털에서.** 고객은 제공업체의 포털에서 새 구독을 관리하며, 일반적으로 배송 일시 중지 또는 건너뛰기, 주기 변경, 제품 교체, 취소를 할 수 있어요. 포털은 Aftersell이 아니라 제공업체가 운영해요. 스토어의 계정 영역이나 환영 이메일에서 포털에 접근할 수 있도록 하세요. 그렇지 않으면 고객이 취소하려고 지원팀에 문의하게 돼요.

<div id="subscription-fulfillment">
  ## 구독 풀필먼트
</div>

* **첫 주기.** 첫 구독 주문은 원래 Shopify 주문의 일부이므로, 일회성 주문에 사용하는 풀필먼트 프로세스(3PL, 자체 처리, 드롭쉬핑)를 그대로 거쳐요. 구독 라인은 원래 일회성 구매와 함께 발송돼요.
* **이후 갱신.** 이후 주기는 구독 제공업체가 갱신 주기에 따라 생성해요. 각 갱신은 새 Shopify 주문이 되며, 다른 주문과 같은 방식으로 처리돼요.

3PL이 구독 제공업체와 직접 연동되어 있다면 갱신은 일반적으로 자동으로 처리돼요. 3PL이 Shopify 주문에서만 동기화한다면 각 갱신이 Shopify 주문을 생성하므로 추가 설정이 필요 없어요.

<div id="shopify-platform-limitations">
  ## Shopify 플랫폼 제한 사항
</div>

어떤 Aftersell 기능을 사용하든 구독 관련 구매 후 오퍼에는 몇 가지 Shopify 플랫폼 규칙이 적용돼요.

<div id="one-subscription-per-order">
  ### 주문당 구독 1개
</div>

Shopify는 이미 구독이 포함된 주문에 구매 후 업셀로 구독을 추가하는 것을 허용하지 않아요. 이 제한은 Shopify가 설정한 것이며 모든 구매 후 앱에 적용돼요.

**구독 제공업체를 연결하면 구독 업셀에서 이 제약이 사라져요.** Recharge, Skio 또는 Loop가 연결되어 있으면 Aftersell이 Shopify에 추가를 요청하는 대신 제공업체에서 새 구독을 생성하므로, 주문에 이미 구독이 포함된 고객에게도 구독 오퍼가 도달해요. [기존 구독자에게 업셀하기](/ko/aftersell/subscription-upsell-existing-subscribers)를 참고하세요.

**연결된 제공업체가 없는 경우** Aftersell은 "카트에 이미 구독이 있는" 경우를 자동으로 처리해요:

* 오퍼의 **구독 전용 제품**은 해당 고객의 퍼널에서 제외돼요.
* **이중 모드 제품**(일회성 및 구독)은 자동으로 일회성 전용으로 전환되므로, 오퍼는 구독 옵션 없이 계속 표시돼요.

어느 경우든 이미 구독이 있는 주문에서 잘못 실행될 걱정 없이 퍼널에 구독 업셀 오퍼를 그대로 둘 수 있어요. 두 번째 구독을 추가하는 대신 고객이 이미 가진 구독을 수정하려면 [구독 업그레이드](/ko/aftersell/subscription-upgrades)를 사용하세요.

<div id="subscription-only-products">
  ### 구독 전용 제품
</div>

오퍼의 제품이 구독으로만 판매되도록 구성되어 있고 연결된 제공업체가 없다면, 고객의 주문에 이미 구독 제품이 포함되어 있을 때마다 오퍼를 건너뛰어요. 퍼널 에디터에 표시되는 내용은 설정에 따라 달라요:

* **제공업체가 연결된 경우.** 배너가 없어요. 이 제한이 적용되지 않아요.
* **연결된 제공업체가 없는 경우.** **Connect a provider** 작업이 있는 **Unlock more reach** 배너가 표시되며, 주문에 이미 구독이 포함된 고객에게는 이 오퍼의 구독 옵션이 표시되지 않는다고 설명해요.
* **퍼널이 이미 구독 주문을 제외하는 경우.** 오퍼가 해당 고객에게 도달하지 않으므로 배너가 없어요.

이전 버전의 **Subscription limitations** 경고 배너가 표시되는 경우, 영향을 받는 제품이 나열되고 **Subscription trigger**를 **do not include a subscription**으로 설정하도록 제안해요.

<div id="multiple-subscription-offers-in-the-same-funnel">
  ### 같은 퍼널의 여러 구독 오퍼
</div>

퍼널에서 둘 이상의 오퍼에 구독 제품이 포함되어 있으면 처음 수락된 구독만 주문에 추가되고 이후 구독 오퍼는 건너뛰어요. 퍼널 에디터는 이러한 충돌이 감지되면 구독 제품이 포함된 다른 오퍼를 나열하며 경고해요. 오퍼가 건너뛰어지지 않도록 하려면 퍼널을 구독 오퍼 하나로 제한하거나, **Subscription trigger**를 사용해 이미 구독이 포함된 주문을 제외하세요.

<div id="troubleshooting">
  ## 문제 해결
</div>

<AccordionGroup>
  <Accordion title="오퍼 에디터에 구독 옵션이 표시되지 않아요">
    구독 컨트롤이 표시되려면 선택한 제품에 Shopify에서 활성 판매 플랜이 하나 이상 있어야 해요. 구독 앱이 이 제품에 대한 판매 플랜을 생성했는지, 그리고 해당 플랜이 활성 상태이며 제품에 할당되어 있는지 확인하세요.
  </Accordion>

  <Accordion title="Aftersell은 어떤 판매 플랜을 표시할지 어떻게 선택하나요?">
    오퍼는 Shopify에서 제품에 구성된 첫 번째 판매 플랜을 미리 선택하며, 고객의 변형에 둘 이상의 플랜이 적용되면 고객이 **Purchase options** 드롭다운에서 변경할 수 있어요. 고객에게 보이는 플랜을 제어하려면 **Allowed subscription plans** 다중 선택으로 오퍼를 제한하거나, Shopify에서 원하는 플랜이 먼저 오도록 제품의 판매 플랜 순서를 바꾸거나, 사용하지 않는 판매 플랜을 제품에서 완전히 제거하세요. 정확히 하나의 플랜만 허용하면 드롭다운이 사라져요.
  </Accordion>

  <Accordion title="고객이 구매 후 오퍼에서 배송 주기를 선택할 수 있나요?">
    네. 고객이 선택한 변형에 둘 이상의 플랜이 적용되면 오퍼에 **Purchase options** 드롭다운이 표시돼요. 이를 방지하려면 **Allowed subscription plans**로 하나의 플랜만 허용하세요. 그러면 주기가 고정 텍스트로 표시돼요. 고객은 이후에도 구독 제공업체의 포털에서 주기를 변경할 수 있어요.
  </Accordion>

  <Accordion title="구독이 가능한 제품을 일회성 전용으로 표시하고 싶어요">
    오퍼의 구매 옵션 설정에서 **One-time purchase only** 모드를 사용하세요. Aftersell에는 구독 가능 제품에 대해 세 가지 모드가 있어요: **One-time purchase only**, **Subscription only**, **One-time purchase and subscription**. **One-time purchase only**를 선택하면 제품에 활성 판매 플랜이 있어도 구독 옵션이 완전히 숨겨져요.
  </Accordion>

  <Accordion title="고객이 구독 업셀을 수락했지만 구독 앱에 구독이 없어요">
    고객은 결제했지만 제공업체에서 구독이 생성되지 않았기 때문에 가장 큰 문제를 일으키는 실패 유형 중 하나예요. 압도적으로 가장 흔한 근본 원인은 **오퍼가 렌더링된 후 고객이 수락하기 전에 판매 플랜이 비활성화된 경우**예요. 렌더링 시점에는 유효한 판매 플랜 ID가 있으므로 Shopify는 변경 세트를 수락하지만, 고객이 수락하기 전에 플랜이 비활성화되면 하위 단계에서 구독이 등록되지 않고 오류도 표시되지 않아요.

    기타 흔한 원인:

    * **구독 앱 웹훅 실패.** Shopify에서 새 구독을 가져오는 모든 구독 앱은 Shopify 웹훅에 의존해요. 구독 앱의 로그에서 웹훅 전송 상태를 확인하세요.
    * **판매 플랜이 제품에서 연결 해제되었지만** 여전히 활성 ID가 있는 경우. Shopify는 변경 세트를 수락하고 라인 항목도 추가되지만, 구독 제공업체에는 처리할 기록이 없어요.

    **중요:** 기본 `add_subscription` 경로에는 자동 재시도가 없어요. 이 경로에서는 Shopify가 등록을 담당하므로 Aftersell이 다시 실행할 것이 없어요. (주문에 이미 구독이 포함된 경우 사용되는 별도의 제공업체 경로는 [구독 업그레이드 재시도 워크플로](/ko/aftersell/subscription-upgrades-troubleshooting)로 *처리돼요*.) 이 문제가 발생하면:

    1. 판매 플랜이 Shopify에서 여전히 활성 상태이고 제품에 할당되어 있는지 확인하세요.
    2. 해당 주문에 대한 구독 앱의 주문 가져오기 / 웹훅 로그를 확인하세요.
    3. 구독이 실제로 누락된 경우, 일반적으로 구독 앱의 지원팀이 주문 ID로 고객을 수동 등록해 줄 수 있어요.

    여러 고객이 영향을 받는다면 주문 ID와 구독 제공업체 정보를 포함해 Aftersell 지원팀에 문의하세요. 다만 해결은 Aftersell이 아니라 구독 제공업체 측에서 이루어질 것으로 예상하세요.
  </Accordion>

  <Accordion title="CTA 버튼에 첫 주기 할인 대신 반복 가격이 표시돼요">
    일반적으로 첫 주기 할인이 극단적일 때(예: 첫 주기 100% 할인) 나타나요. Accept 버튼에는 첫 주기 가격이 반영되지만, 그 가격이 반복 가격과 똑같이 읽히면 할인이 적용되지 않은 것처럼 보일 수 있어요. 오퍼 미리보기에서 할인이 올바르게 구성되었는지 확인하고, 오퍼 문구("첫 박스 무료, 이후 Y일마다 \$X")로 조건을 명확히 하세요.
  </Accordion>

  <Accordion title="두 번째 주기에 구독 할인 없이 고객의 주문이 청구되었어요">
    할인은 기본적으로 **첫 청구 주기에만** 적용돼요. 고객이 두 번째나 세 번째 주문에 할인이 없는 이유를 묻는다면 이는 예상된 동작이에요. 반복 주문은 고객이 오퍼에서 **Recurring subtotal**로 확인한 일반 구독 가격으로 청구돼요.
  </Accordion>

  <Accordion title="이미 구독이 포함된 주문에 오퍼가 표시돼요">
    Recharge, Skio 또는 Loop가 연결되어 있다면 이는 예상된 동작이며 오퍼가 정상적으로 작동해요. Aftersell이 제공업체에서 새 구독을 생성해요. [기존 구독자에게 업셀하기](/ko/aftersell/subscription-upsell-existing-subscribers)를 참고하세요.

    연결된 제공업체가 없다면 Shopify가 두 번째 구독 추가를 차단하고, 오퍼는 실행 시점에 별도 안내 없이 건너뛰어요. 제공업체를 연결하거나, **Subscription trigger**를 **do not include a subscription**으로 설정해 해당 고객에게 오퍼가 표시되지 않도록 하세요.
  </Accordion>

  <Accordion title="퍼널에서 구독 오퍼 중 하나만 실행돼요">
    Shopify는 주문당 하나의 구독만 허용해요. 같은 퍼널에 여러 구독 오퍼가 있으면 처음 수락된 오퍼가 적용되고 나머지는 건너뛰어요. 퍼널을 구독 오퍼 하나로 제한하거나, Subscription trigger를 사용해 이미 구독이 있는 주문을 제외하세요.
  </Accordion>

  <Accordion title="고객이 계정에서 구독을 찾을 수 없어요">
    새 구독은 Shopify에서 직접 관리되는 것이 아니라 구독 제공업체의 고객 포털에서 관리돼요. 스토어의 계정 영역에 포털 링크가 있는지 확인하고, 제공업체의 환영 이메일이 수락 직후 발송되도록 구성되어 있는지 확인하세요.
  </Accordion>

  <Accordion title="고객이 수락한 후 새 구독을 환불하거나 취소하고 싶어요">
    첫 주기는 Shopify 주문의 일부로 결제되었으므로 환불은 다른 라인 항목과 동일하게 작동해요. 향후 주기의 취소는 Aftersell이 아니라 구독 제공업체에서 이루어져요. Shopify에서 라인을 환불해도 구독이 자동으로 취소되지 않으므로, 제공업체 포털에서도 취소해야 해요.
  </Accordion>
</AccordionGroup>