> ## 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 Upgrades)를 사용하면 기존 구독자에게 체크아웃 직후 활성 구독을 변경할 수 있는 구매 후(post-purchase) 제안을 제공할 수 있어요. 배송 주기를 변경하거나, 다른 구독 상품으로 교체하거나, 두 가지를 동시에 하거나, [구독에 다른 상품을 추가](/ko/aftersell/subscription-upgrades-add-item)할 수 있어요. 변경 사항은 Recharge, Skio 또는 Loop에 직접 적용되므로 구독 자체에 대한 환불이나 새로운 청구가 발생하지 않아요.

<div id="which-feature-do-you-need">
  ## 어떤 기능이 필요한가요?
</div>

Aftersell에는 구독과 함께 작동하는 세 가지 구매 후 기능이 있어요. 이름은 비슷하지만 동작 방식은 매우 달라요. 설정을 시작하기 전에 아래 의사 결정 흐름을 사용하세요.

<Info>
  **이렇게 생각해 보세요:**

  1. **구독 업그레이드(Subscription Upgrade)** 는 기존 구독을 어떤 식으로든 수정해요 — 주기, 상품, 또는 상품 추가를 통해서요.
  2. **구독 업셀(Subscription Upsell)** 은 추가 전용이에요: 완전히 새로운 구독을 생성해요. 구독 공급자가 연결되어 있으면 이미 구독이 포함된 주문에서도 작동하므로 더 이상 Shopify 제한을 걱정할 필요가 없어요.

  Aftersell은 각 시나리오를 전용 기능으로 처리하므로 플랫폼 규칙을 직접 고민할 필요가 없어요:

  * **고객이 이미 보유한 구독을 변경하려면** 구독 업그레이드를 사용하세요. 고객의 기존 구독을 Recharge, Skio 또는 Loop에서 직접 수정해요. Shopify의 규칙을 충족하기 위해 작은 비구독 플레이스홀더 상품이 Shopify 주문에 추가되고, 실제 업그레이드는 구독 플랫폼에서 이루어져요.
  * **완전히 새로운 구독을 추가하려면** **구독 업셀**을 사용하세요. 원래 상품은 주문에 그대로 유지되고, 고객은 그 옆에 새로운 정기 구독을 갖게 돼요. 이는 주문에 이미 구독이 포함되어 있든 아니든 작동해요 — [기존 구독자에게 업셀하기](/ko/aftersell/subscription-upsell-existing-subscribers)를 참고하세요.
  * **일회성 상품을 다른 상품으로 교체하려면** **교체 업셀(Replacement Upsell)** 을 사용하세요. 교체 상품은 동일 상품의 구독 버전이거나, 완전히 다른 상품이거나, 동일 상품의 다른 옵션 또는 수량일 수 있어요.
</Info>

<Note>
  **"주문당 구독 하나" 제한이 더 이상 구독 업셀을 막지 않아요.** Shopify는 이미 구독이 포함된 주문에 구매 후 업셀로 구독을 추가하는 것을 허용하지 않아요. Recharge, Skio 또는 Loop를 연결하면 Aftersell이 Shopify 대신 공급자에서 새 구독을 생성하므로, 구독 제안이 기존 구독자에게도 도달해요. [기존 구독자에게 업셀하기](/ko/aftersell/subscription-upsell-existing-subscribers)를 참고하세요.
</Note>

아래 세 가지 질문을 사용해 시나리오에 맞는 기능을 찾으세요. 순서대로 진행하다가 첫 번째 **예**에서 멈추면, 그것이 사용해야 할 기능이에요.

**Q1: 고객이 이미 보유한 구독을 변경하고 싶으신가요?**

* **예**, [구독 업그레이드](#how-subscription-upgrades-work)를 사용하세요. 이 가이드에서 다루는 기능이에요. 구독 업그레이드는 고객이 체크아웃을 완료한 직후 Recharge, Skio 또는 Loop에 있는 고객의 기존 구독을 수정해요. 배송 또는 청구 주기를 변경하거나, 다른 구독 상품으로 교체하거나, 두 가지를 동시에 하거나, [구독에 다른 상품을 추가](/ko/aftersell/subscription-upgrades-add-item)할 수 있어요. 고객의 기존 구독은 그 자리에서 업데이트돼요. 구독 자체에 대한 환불이나 새 청구는 발생하지 않아요. 수락된 업그레이드의 기록으로 작은 플레이스홀더 라인 아이템("오퍼 상품")이 Shopify 주문에 추가돼요.
* **아니요**, Q2로 이동하세요.

**Q2: 고객이 이미 구매한 것에 더해, 주문에 완전히 새로운 정기 구독을 추가하고 싶으신가요?**

* **예**, [구독 업셀](/ko/aftersell/subscriptions_in_post_purchase_offers)을 사용하세요. 구독 업셀은 주문에 새 구독을 추가해요. 고객이 이미 구매한 것은 주문에 그대로 유지되고, 그 옆에 정기 구독이 추가돼요. 구독이 없는 주문에서는 Shopify의 Subscription API를 사용해요. **이미 구독이 포함된** 주문에서는 Aftersell이 대신 연결된 공급자에서 새 구독을 생성해요 — [기존 구독자에게 업셀하기](/ko/aftersell/subscription-upsell-existing-subscribers)를 참고하세요. 어느 쪽이든 고객은 두 번째의 독립적인 구독을 갖게 돼요.
* **아니요**, Q3으로 이동하세요.

**Q3: 고객이 일회성 상품을 구매했어요. 이를 다른 상품으로, 즉 동일 상품의 구독 버전이나 완전히 다른 상품으로 교체하고 싶으신가요?**

* **예**, [교체 업셀](/ko/aftersell/replacement_upsells)을 사용하세요. 교체 업셀은 주문에서 원래의 일회성 상품을 제거하고 그 자리에 교체 상품을 추가해요. Shopify가 원래 라인 아이템을 환불하고 교체 상품에 대해 청구해요. 교체 상품은 동일 상품의 구독 버전(예: 고객이 일회성 보틀을 구매했는데 월간 구독으로 전환하고 싶은 경우)이거나, 일회성 또는 구독 형태의 완전히 다른 상품일 수 있어요.

<div id="at-a-glance">
  ### 한눈에 보기
</div>

| 원하는 작업                                    | 사용할 기능                                                                  | 고객이 주문에서 보게 되는 것                                                 |
| ----------------------------------------- | ----------------------------------------------------------------------- | ---------------------------------------------------------------- |
| 이미 보유한 구독 수정 <br />(주기 변경, 다른 구독 상품으로 교체) | 구독 업그레이드 (이 가이드)                                                        | 작은 플레이스홀더 라인 아이템("오퍼 상품"). 구독 자체는 Recharge, Skio 또는 Loop에서 변경돼요. |
| 이미 보유한 구독에 다른 상품 추가                       | [구독에 상품 추가](/ko/aftersell/subscription-upgrades-add-item)               | 추가된 상품이 이 주문에서 청구돼요. 이후 구독과 함께 배송되고 청구돼요.                        |
| 구매한 것에 더해 새 구독 추가                         | [구독 업셀](/ko/aftersell/subscriptions_in_post_purchase_offers)            | 이미 구매한 것과 함께 새 구독 라인 아이템이 표시돼요.                                  |
| 주문에 **이미 구독이 있는** 경우 새 구독 추가              | [기존 구독자에게 업셀하기](/ko/aftersell/subscription-upsell-existing-subscribers) | 첫 주기 가격으로 청구된 새 상품. 공급자에서 두 번째 구독이 생성돼요.                         |
| 일회성 상품을 구독 또는 다른 상품으로 교체                  | [교체 업셀](/ko/aftersell/replacement_upsells)                              | 원래 상품에 대한 환불 라인과 교체 상품에 대한 새 청구.                                 |

<div id="how-subscription-upgrades-work">
  ## 구독 업그레이드 작동 방식
</div>

고객이 처음부터 끝까지 경험하는 것과 그 뒤에서 일어나는 일은 다음과 같아요.

고객 여정은 네 가지 짧은 단계로 이루어져요:

1. **구독 구매.** 고객이 구독 판매 플랜이 있는 상품의 체크아웃을 완료해요.
2. **업그레이드 제안 확인.** 구매 후 페이지에서 여러분이 구성한 구독 업그레이드 제안을 보게 돼요.
3. **구매 후 수락.** 결제 정보나 배송 정보를 다시 입력하지 않고 수락해요.
4. **플랜 업데이트.** 기존 구독이 Recharge, Skio 또는 Loop에서 수정돼요. 수락 기록으로 작은 플레이스홀더 라인 아이템("오퍼 상품")이 Shopify 주문에 추가돼요.

두 시스템은 하나의 고객 행동에 연결되어 있지만 독립적으로 실행돼요:

* **Shopify에서는** 오퍼 상품이 플레이스홀더 라인 아이템으로 주문에 추가돼요. Shopify의 구매 후 API가 이미 구독이 포함된 주문에 두 번째 구독을 추가할 수 없기 때문에 필요해요.
* **Recharge, Skio 또는 Loop에서는** 고객의 기존 구독이 업데이트되고, 원래 구독에 대한 환불은 발생하지 않아요. 대부분의 경우 그 자리에서 수정되며 ID가 유지돼요. 두 가지 형태는 다르게 작동해요:

  * **Recharge 또는 Skio에서 선불 플랜으로 전환하는 경우.** 공급자가 활성 구독을 선불 플랜으로 전환할 수 없기 때문에, Aftersell이 새 플랜으로 구독을 생성한 다음 원래 구독을 취소해요.
  * **Skio 또는 Loop에서 여러 라인으로 구성된 구독의 한 라인만 업그레이드하는 경우.** 공급자가 단일 라인의 주기를 다시 설정할 수 없기 때문에, 해당 라인은 자체적인 새 구독으로 생성되고 원래 구독에서 제거돼요 — Skio는 수량을 `0`으로 설정하고, Loop는 라인을 완전히 제거해요.

  두 경우 모두 업그레이드된 상품은 **다른 구독 ID** 아래에 놓이게 되는데, 해당 ID를 기준으로 하는 연동이 있다면 중요해요. [풀필먼트 & 3PL 매핑](/ko/aftersell/subscription-upgrades-fulfillment)을 참고하세요.

새 플랜의 가격은 고객이 방금 완료한 Shopify 주문이 아니라 **구독 플랫폼의 다음 정기 주기**부터 적용돼요.

오퍼 상품이 주문에 추가된 후 공급자 호출이 실패하면 Aftersell이 백그라운드 워크플로에서 재시도해요. 워크플로는 먼저 실패를 분류하므로, 이후 동작은 원인과 업그레이드 유형에 따라 달라져요:

* **일시적인 원인과 공급자 속도 제한**은 재실행돼요. 워크플로가 재실행 전에 공급자의 현재 상태를 확인하므로, 느리지만 성공한 업그레이드가 두 번 적용되지 않아요.
* **재실행으로 해결할 수 없는 원인**은 대신 수동 조정(reconciliation)으로 전달돼요.
* **환불이 안전한 경우** — 공급자 변경이 성공하지 않았고, 청구된 라인이 고객이 실제로 받는 상품이 아닌 플레이스홀더였던 경우 — 청구 금액이 자동으로 환불돼요. 완전히 새로운 구독과 박스 업그레이드는 이 방식으로 환불되지 않아요. 두 경우 모두 고객이 실제 상품을 받기 때문이에요.

결과가 수동 조정인 경우 지원팀에 문의하고 [문제 해결](/ko/aftersell/subscription-upgrades-troubleshooting)을 참고하세요.

<div id="what-the-customer-sees">
  ## 고객이 보게 되는 것
</div>

구독 업그레이드 흐름은 두 시스템에 걸쳐 있고, 고객은 각 시스템에서 서로 다른 것을 보게 돼요. 이를 이해하면 "이중 청구"나 "누락된 상품"에 대한 지원 문의를 예방할 수 있어요.

<div id="on-the-shopify-order">
  ### Shopify 주문에서
</div>

고객이 업그레이드를 수락해도 Aftersell은 주문에서 원래 구독 라인 아이템을 제거하지 **않아요**. 제거하려면 환불이 필요한데, 이는 해결하는 것보다 더 많은 고객 혼란("이중 청구된 것 같은데 무슨 일이죠?")을 일으켜요.

대신 주문은 다음과 같이 구성돼요:

* 고객이 구매한 그대로의 **원래 구독 라인 아이템**.
* 업그레이드를 나타내는 별도의 플레이스홀더 라인 아이템인 **오퍼 상품**.

이 때문에 오퍼 상품의 이름을 명확하게 짓는 것이 매우 중요해요. 고객이 주문 요약을 보고 두 번째 라인 아이템이 무엇을 의미하는지 즉시 이해할 수 있어야 해요.

**좋은 이름:**

* Upgrade to Quarterly
* Quarterly plan upgrade
* Switch to monthly delivery

여러 업그레이드 등급을 제공한다면 Subscription Upgrade 같은 **일반적인 이름은 피하세요**. 고객이 어떤 것을 수락했는지 알 수 없어요.

또한 Shopify Admin에서 오퍼 상품에 이것이 구독 업그레이드를 나타내며 이 라인에서 추가 청구가 발생하지 않는다는 것을 설명하는 짧은 설명을 추가하세요.

<div id="in-the-subscription-provider-portal">
  ### 구독 공급자 포털에서
</div>

Recharge, Skio 또는 Loop의 고객 포털에서 고객은 업데이트된 구독을 볼 수 있어요. 변경 사항이 언제 적용되는지는 즉시 업그레이드 옵션 사용 여부에 따라 달라져요:

* **기본값(다음 청구 주기)** 에서는 고객의 다음 청구 주기에 변경 사항이 적용돼요. 현재 주기는 변경되지 않으며, 새 플랜은 다음 갱신부터 적용돼요.
* **즉시 업그레이드(베타, 요청 시 제공)** 를 사용하면 다음 갱신을 기다리지 않고 새 청구 간격이 즉시 시작돼요. 고객의 기존 구독은 여전히 그 자리에서 업데이트되며, 삭제 후 다시 생성되지 않아요.

<div id="works-with-recharge-skio-and-loop">
  ## Recharge, Skio, Loop와 함께 작동
</div>

구독 업그레이드는 현재 **Recharge**, **Skio**, **Loop**와만 호환돼요. 업그레이드는 구독을 운영하는 이 플랫폼들 중 하나 안에서 적용되므로, 연결이 필수 설정 단계예요.

연동이 무엇인지, 어떤 플랫폼이 지원되는지, 공급자별 토큰 설정에 대해서는 [연동](/ko/aftersell/subscription-upgrades-integrations)을 참고하세요.

이 세 가지 이외의 구독 앱을 사용한다면 현재로서는 구독 업그레이드를 사용할 수 없지만, [구독 업셀](/ko/aftersell/subscriptions_in_post_purchase_offers)과 [교체 업셀](/ko/aftersell/replacement_upsells)은 여전히 사용할 수 있어요.

<div id="next-steps">
  ## 다음 단계
</div>

<CardGroup cols={2}>
  <Card title="설정 & 구성" icon="sliders" href="/ko/aftersell/subscription-upgrades-setup">
    공급자를 연결하고 설정 마법사로 업그레이드 제안을 만들어요.
  </Card>

  <Card title="구독에 상품 추가" icon="plus" href="/ko/aftersell/subscription-upgrades-add-item">
    구독을 변경하는 대신 새 상품을 추가해 구독을 키워요.
  </Card>

  <Card title="테스트" icon="vial" href="/ko/aftersell/subscription-upgrades-testing">
    테스트 주문을 하고 Shopify와 공급자에서 업그레이드를 확인해요.
  </Card>

  <Card title="제한 사항 & 중요 참고" icon="triangle-exclamation" href="/ko/aftersell/subscription-upgrades-limitations">
    출시 전에 알아야 할 제약과 동작이에요.
  </Card>

  <Card title="풀필먼트 & 3PL 매핑" icon="truck" href="/ko/aftersell/subscription-upgrades-fulfillment">
    업그레이드 후 3PL이 올바른 상품을 배송하도록 해요.
  </Card>

  <Card title="문제 해결" icon="wrench" href="/ko/aftersell/subscription-upgrades-troubleshooting">
    가장 흔한 업그레이드 문제에 대한 해결책이에요.
  </Card>

  <Card title="연동" icon="plug" href="/ko/aftersell/subscription-upgrades-integrations">
    Recharge, Skio, Loop 설정 가이드예요.
  </Card>
</CardGroup>