> ## 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 Upgrade 설정 마법사의 세부 규칙을 모아 놓은 문서예요: 가격이 산출되는 방식, 시점 및 할인 옵션의 동작, 적격성 트리거, 오퍼 제품이 자리 표시용인 이유를 다뤄요. 단계별 안내는 [구독 업그레이드 설정하기](/ko/aftersell/subscription-upgrades-setup)를 참고하세요.

<div id="api-key-verification-states">
  ## API 키 확인 상태
</div>

1단계에서 **Test API key**는 제공업체를 통해 토큰을 검증하며, 토큰이 인증되는지, 필요한 모든 스코프를 가지고 있는지, 스토어에 속하는지 확인해요. 결과는 두 가지 상태 중 하나로 표시돼요:

* **초록색 체크, "API key verified".** 토큰이 인증되었고, 필요한 모든 스코프가 있으며, 토큰이 스토어에 속해요. **Continue**가 활성화돼요.
* **빨간색 취소 아이콘.** 확인 결과가 정상이 아니에요. 아이콘 옆의 메시지가 두 가지 중 어떤 일이 발생했는지 알려줘요: 제공업체가 토큰을 **거부**했거나(취소되었거나 필요한 스코프가 없는 경우이며, 메시지에 구체적인 문제가 표시돼요), Aftersell이 **확인을 완료하지 못한** 경우("Could not verify the API key. Please try again.")예요. 후자는 잘못된 토큰이 아니라 호출이 실패한 것이에요. 토큰이 거부되었다면 토큰을 수정하고, 그렇지 않다면 다시 테스트하세요.

더 완화된 세 번째 상태는 없으며, 확인 불가 결과는 거부와 똑같이 보이므로 아이콘이 아니라 메시지를 읽으세요. 확인 결과가 초록색이 될 때까지 **Continue**는 비활성화된 상태로 유지돼요. 제공업체나 토큰을 수정하면 이전 결과가 지워지므로, 변경 후에는 다시 테스트하세요. 이 검증 단계는 고객에게 요금이 청구된 후에야 드러나는 구독 업그레이드 실패를 방지하기 위해 존재해요.

<div id="the-eligibility-trigger-variant-on-subscription">
  ## 적격성 트리거: Variant on subscription
</div>

마법사가 단일 트리거를 자동으로 연결해 주므로 직접 설정할 필요가 없어요:

| 트리거 | 설정 |
| - | - |
| **Variant on subscription** | 적격(대상) 변형으로 설정돼요. 해당 변형이 주문에 **구독 라인으로** 포함되어 있을 때만 실행돼요. |

활성화된 모든 트리거는 AND 논리를 사용해요: 퍼널이 표시되려면 모든 조건이 충족되어야 해요. 퍼널 에디터의 **Triggers** 단계에서 선택적 트리거를 추가로 겹쳐 설정할 수 있어요(접을 수 있는 **Additional triggers** 섹션 아래에 그룹화되어 있으며, 개수가 표시되고 선택적 트리거가 설정되면 자동으로 열려요).

<Warning>
  **이 트리거를 Product 트리거와 Subscription 트리거 조합으로 대체하지 마세요.** 이전 방식의 조합은 서로 독립적인 두 조건이므로, 트리거 제품을 *일회성* 구매로 포함하고 *관련 없는* 구독 항목도 함께 있는 주문은 두 조건을 모두 충족해요. 그러면 퍼널이 실행되지만, 변경할 일치하는 구독이 없기 때문에 이후 업그레이드가 실패해요. **Variant on subscription**은 그렇게 분리될 수 없는 단일 조건이며, 마법사는 이전 퍼널을 이 조합에서 자동으로 마이그레이션해요.
</Warning>

<Warning>
  제품별 트리거가 없으면 주문에 적격 구독 제품이 없는 고객에게도 퍼널이 표시될 수 있어요. 이는 노출을 낭비하고 별도 안내 없이 실패하는 구독 변경을 만들어요: 오퍼 제품은 주문에 추가되지만 Recharge, Skio, Loop에서는 어떤 구독도 변경되지 않아요.
</Warning>

<Warning>
  **Show this funnel for all customers**가 활성화되어 있으면 다른 모든 트리거를 재정의하여 모든 체크아웃에서 퍼널이 실행돼요. 구독 업그레이드 퍼널에는 권장되지 않아요.
</Warning>

<div id="which-price-the-recurring-subtotal-shows">
  ## Recurring subtotal에 표시되는 가격
</div>

오퍼의 **Recurring subtotal**은 고객에게 다음 갱신 비용을 알려줘요. 이 가격을 어떤 제품에서 가져오는지는 업그레이드 유형에 따라 달라요:

| 업그레이드 유형 | 가격 출처 |
| - | - |
| Change delivery or billing frequency | **트리거** 제품 |
| Replace with a different subscription product | **교체** 제품 |
| Both, change frequency and replace subscription product | **교체** 제품 |
| Add another subscribable item to subscription | **추가된** 항목 |

가장 흔히 혼동되는 부분이에요. 주기만 변경하는 업그레이드는 설계상 같은 제품을 유지하므로, 어떤 주기를 설정하든 반복 소계에는 트리거 제품의 가격만 표시될 수 있어요. 그 자리에 다른 제품의 가격이 나오길 기대했다면 **Both, change frequency and replace subscription product**를 사용하려던 것일 가능성이 높아요.

사용되는 수량은 교체 유형에서만 표시되는 **Override subscription quantity**에서 가져와요. 주기만 변경하는 업그레이드에서는 항상 1이에요.

<div id="upgrade-timing">
  ## 업그레이드 시점
</div>

기본적으로 업그레이드는 고객의 **다음 청구 주기**부터 적용되며, 기존 갱신 날짜가 유지돼요.

스토어에서 시점 옵션이 활성화되어 있으면 주기 필드 아래에 체크박스가 표시돼요:

> **My fulfillment provider ships the upgraded item on the current order**

체크하면 다음 갱신이 아니라 즉시 새 청구 주기가 시작되며, 4단계의 **One-time upgrade price** 필드가 잠금 해제돼요.

<Warning>
  Aftersell은 고객이 방금 한 주문을 변경하지 않아요. 이 설정은 청구 주기만 이동시켜요. 풀필먼트 제공업체가 업그레이드의 자리 표시 제품을 인식하고 현재 주문에 업그레이드된 항목을 배송하도록 설정된 경우에만 체크하세요.
</Warning>

<Note>
  이 체크박스는 기본적으로 꺼져 있으며 모든 스토어에서 제공되지는 않아요. **Change delivery or billing frequency** 및 **Both, change frequency and replace subscription product** 업그레이드 유형에서만, 그리고 스토어에서 옵션이 활성화된 후에만 표시돼요. 필요하면 앱 내 채팅으로 지원팀에 문의하세요.
</Note>

<div id="recurring-discount">
  ## 반복 할인
</div>

업그레이드된 구독의 첫 주기뿐 아니라 **향후 모든 갱신**에 적용되는 선택적 인센티브예요. 항목 추가 유형에서는 사용할 수 없어요. 필드가 표시되는 방식은 선택한 판매 플랜에 단계별 가격 정책이 있는지에 따라 달라요:

* **할인 단계가 있는 판매 플랜을 선택한 경우**(예: 첫 결제에 \$20 할인, 두 번째 결제부터 \$10 할인을 적용하는 Loop 플랜), 자유 입력 필드 대신 단계별 라디오 버튼 목록이 표시돼요. 각 옵션에는 할인 금액과 적용되는 결제 범위(예: "Charge 1" 또는 "Charge 2 onward")가 표시돼요. 향후 모든 갱신에 적용할 단계를 선택하세요.
* **판매 플랜을 선택하지 않았거나 선택한 플랜에 할인 단계가 없는 경우**, 표준 자유 입력 필드가 표시돼요. 금액을 입력하고 **Percentage** 또는 **Fixed amount**를 선택하세요.

<div id="one-time-upgrade-price-by-upgrade-type">
  ## 업그레이드 유형별 일회성 업그레이드 가격
</div>

**One-time upgrade price**는 고객이 수락할 때 이 Shopify 주문에서 지불하는 금액이에요.

* **Change delivery or billing frequency** 및 **Both** 유형에서는 기본적으로 `0`으로 잠겨 있어요. 구독 제공업체가 현재 청구 주기가 끝날 때 요금을 청구하고, 자리 표시 제품은 Shopify 주문에 \$0.00으로 표시되기 때문이에요. 3단계의 [업그레이드 시점 체크박스](#upgrade-timing)를 체크한 경우에만 편집할 수 있어요.
* **Replace with a different subscription product** 및 **Add another subscribable item to subscription**에서는 시점 체크박스가 적용되지 않으므로 가격 필드를 항상 편집할 수 있어요.

입력할 값은 업그레이드 유형에 따라 달라요:

* **주기, 교체 또는 둘 다:** 원래 구독과 업그레이드된 구독 간의 가격 *차이*예요. 고객은 구독을 유지하며, 이 요금이 차액을 충당해요.
* **구독 가능한 항목 추가:** 이 주문에서 추가된 항목에 대한 요금이에요. 교체되는 것이 없으므로 계산할 차액이 없어요. 고객이 새 항목에 대해 지금 지불하는 금액이며, 이후 구독과 함께 반복돼요. [기존 구독에 항목 추가하기](/ko/aftersell/subscription-upgrades-add-item)를 참고하세요.

**첫 주문 할인.** 이 업그레이드 구매에만 적용되는 선택적 할인으로, 퍼센트(`%`) 또는 정액으로 입력해요. **One-time upgrade price** 옆에 있으며, 해당 필드를 편집할 수 있을 때마다 **Create new** 탭과 **Pick existing** 탭 모두에 표시돼요. 항목 추가 유형에서도 필드는 표시되지만 항상 `0`으로 저장돼요. 항목 추가 오퍼에는 할인이 적용되지 않으므로, 대신 오퍼 제품에 원하는 가격을 설정하세요.

<div id="why-the-offer-product-is-a-placeholder">
  ## 오퍼 제품이 자리 표시용인 이유
</div>

오퍼 제품은 고객이 실제로 구매하는 제품이 아니라 **시각적 자리 표시용**일 뿐이에요. Shopify는 이미 구독이 포함된 주문 이후에 구독 제품을 구매 후 업셀로 표시하는 것을 허용하지 않으므로, Aftersell은 대신 비구독 자리 표시 SKU로 업그레이드 간 가격을 처리해요.

* 설정한 이미지, 제목, 가격이 오퍼 카드에 표시돼요.
* 수락하면 표시된 가격이 Shopify 주문에 청구되고, Recharge, Skio 또는 Loop가 다음 주기에 구독에 실제 업그레이드를 적용해요.
* 새로 만들지 않고 **Pick existing**을 선택하는 경우, 제품이 일회성 구매를 지원해야 해요. 구독 전용 제품은 선택기에서 제외돼요.