> ## 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.

# Loop로 구독 업그레이드하기

> Loop 연결과 Aftersell에서 구독 업그레이드를 설정하는 단계별 가이드로, Loop 고유의 제한 사항을 포함해요.

이 페이지는 **Loop**를 구독 업그레이드와 함께 사용할 때의 모든 세부 사항과 고유한 제한 사항을 다뤄요. 구독 업그레이드가 작동하는 방식에 대한 전체 개요는 [구독 업그레이드](/ko/aftersell/subscription-upgrades)를 참고하세요.

<div id="supported-features">
  ## 지원되는 기능
</div>

Loop는 모든 구독 업그레이드 유형을 지원해요:

* 배송 또는 청구 주기 변경
* 다른 상품으로 교체
* 둘 다 – 주기 변경과 상품 교체
* 구독에 다른 구독 가능 상품 추가 ([상품 추가](/ko/aftersell/subscription-upgrades-add-item) 참고)
* 후불(postpaid) 주기만 지원 (선불은 지원되지 않아요 — 아래 [제한 사항](#loop-specific-limitations) 참고)

<div id="loop-specific-limitations">
  ## Loop 고유의 제한 사항
</div>

* **청구 주기는 배송 주기와 같아야 해요.** Loop는 이 연동을 통해 선불 구독을 지원하지 않아요. 청구 주기 필드는 비활성화되어 있으며 배송 주기와 자동으로 동기화돼요. 스토어가 선불 플랜에 의존한다면 알아두어야 할 가장 큰 제약이에요.
* **멀티 라인 구독**은 두 단계로 처리돼요: 대상 상품 라인이 원하는 주기의 새 구독으로 분리된 다음 원래 구독에서 제거돼요. 여러 API 호출이 필요하며, 동기화 기간 동안 Loop 대시보드에 일시적인 진행 중 라인이 표시될 수 있어요.
* **멀티 라인 구독에서는 사용자 지정 주기가 지원되지 않아요.** 판매 플랜을 선택하지 않고 주기를 수동으로 설정하면, 구독에 상품 라인이 하나만 포함된 고객에게는 업그레이드가 작동해요. 여러 상품 또는 번들 구독(활성 라인이 두 개 이상)을 가진 고객은 대상 주기에 일치하는 판매 플랜이 없으면 업그레이드가 실패해요. 이러한 고객을 지원하려면 Loop 대시보드에서 해당 판매 플랜을 생성하세요.

<div id="generating-your-loop-api-token">
  ## Loop API 토큰 생성하기
</div>

1. Loop 앱을 열고 왼쪽 하단의 **Settings**로 이동하세요.
2. **Admin** 아래에서 **API Tokens**를 클릭하세요.
3. Aftersell에 필요한 권한을 설정하세요: Subscription contracts에 대한 **Read and Write**, Orders와 Selling plans에 대한 **Read**. 쓰기 권한은 구독에만 필요해요.
4. **Generate New Token**을 클릭하세요.
5. 이름을 입력하고 적절한 스코프를 선택한 다음 **Generate Token**을 클릭하세요.
6. **Show Token**을 클릭해 키를 확인하고 복사하세요. 비밀번호처럼 취급하고 안전한 곳에 보관하세요.

자세한 내용은 [Loop의 API 문서](https://loop.app/docs)를 참고하세요.

<div id="connecting-loop-in-the-setup-wizard">
  ## 설정 마법사에서 Loop 연결하기
</div>

구독 업그레이드 마법사에서 **Step 1: Connect provider**에 도달하면:

1. **Subscription provider** 드롭다운에서 **Loop**를 선택하세요.
2. **API token** 필드에 API 토큰을 붙여넣으세요.
3. **Test API key**를 클릭하세요. Aftersell이 토큰을 검증하며, 올바르게 인증되는지, 필요한 모든 스코프를 보유하는지, 스토어에 속하는지 확인해요.
4. 테스트가 통과하면(초록색 체크) **Continue**를 클릭해 Step 2로 이동하세요.

테스트 결과는 두 가지 상태 중 하나로 표시돼요:

* **초록색 체크 — "API key verified".** 토큰이 인증되었고, 필요한 모든 스코프가 있으며, 토큰이 스토어에 속해요. 이제 **Continue**가 활성화돼요.
* **빨간색 취소 아이콘.** 검사가 정상적으로 완료되지 않았어요. 아이콘 옆의 메시지를 읽으세요: 토큰이 거부되었거나 필요한 스코프가 누락된 경우예요. 메시지에 누락된 스코프가 구체적으로 표시돼요. Loop에서 토큰을 수정하고 다시 테스트하세요. 또는 Aftersell이 검사를 완료하지 못한 경우("Could not verify the API key. Please try again.")인데, 이는 잘못된 토큰이 아니라 호출 실패이므로 다시 테스트하면 돼요.

확인 실패(could-not-verify) 결과는 거부와 똑같아 보이므로, 아이콘이 아니라 메시지를 기준으로 판단하세요. 검사가 초록색으로 돌아올 때까지 **Continue**는 비활성화 상태로 유지되며, 공급자나 토큰을 수정하면 이전 결과가 지워져요.

<div id="before-you-configure-the-upgrade-step-3">
  ## 업그레이드를 구성하기 전에 (Step 3)
</div>

주기 변경을 구성할 때 기존 판매 플랜을 선택하거나 주기를 수동으로 설정할 수 있어요:

* **기존 판매 플랜 사용.** 판매 플랜 드롭다운에서 선택하세요. 플랜이 Loop 대시보드에 이미 존재하고 활성 상태여야 해요.
* **주기 수동 설정.** 배송 주기를 직접 입력하세요. Loop는 일치하는 판매 플랜 없이도 모든 주기를 허용해요. 수동 주기를 사용할 때는 정기 할인도 적용할 수 있어요.

<Note>
  주기를 수동으로 설정했는데 고객의 구독에 활성 상품 라인이 두 개 이상 있는 경우(여러 상품 또는 번들 계약), 대상 주기에 일치하는 판매 플랜이 없으면 업그레이드가 실패해요. 자세한 내용은 [제한 사항](#loop-specific-limitations)을 참고하세요.
</Note>

<div id="selecting-a-recurring-discount-tier">
  ### 정기 할인 등급 선택하기
</div>

일부 Loop 판매 플랜은 구독의 시점에 따라 서로 다른 할인을 적용해요 — 예를 들어 첫 번째 청구에 \$20 할인, 두 번째 청구부터 \$10 할인 같은 식이에요. 이런 플랜을 선택하면 **Recurring discount** 필드가 각 할인 등급과 청구 범위(예: "Charge 1" 또는 "Charge 2 onward")를 보여주는 라디오 버튼 목록으로 바뀌어요.

업그레이드된 구독의 모든 향후 갱신에 적용할 등급을 선택하세요. 선택한 등급은 제안과 함께 저장되고 고객이 업그레이드를 수락할 때 적용돼요.

선택한 플랜에 할인 등급이 없거나 주기를 수동으로 설정하는 경우에는 표준 자유 입력 할인 필드가 대신 표시돼요.

<div id="verifying-an-upgrade-in-loop">
  ## Loop에서 업그레이드 확인하기
</div>

테스트 주문을 하고 업그레이드 제안을 수락한 후:

Loop 대시보드에서 **Subscriptions**로 이동해 고객의 구독을 찾으세요. Loop의 업그레이드 호출은 동기식이므로 Aftersell 쪽에서 처리 지연이 없어요 — 호출이 반환되는 순간 Loop에 변경 사항이 적용돼요. Loop 자체의 구독 *목록*은 따라잡는 데 시간이 조금 더 걸릴 수 있으므로, 아직 표시되지 않는다면 실패로 판단하기 전에 몇 분 기다렸다가 새로고침하세요.

변경 사항이 없다면 적용되지 않은 것이에요 — 아래를 참고하세요.

<div id="troubleshooting-loop-specific-issues">
  ## Loop 관련 문제 해결
</div>

**청구 주기를 변경할 수 없어요**

이는 정상적인 동작이에요. Loop는 이 연동을 통해 선불 구독을 지원하지 않아요. 청구 주기 필드는 비활성화되어 있으며 배송 주기와 자동으로 동기화돼요.

**업그레이드가 수락되었지만 구독이 수정되지 않았어요**

구독이 변경되지 않았다면 가장 흔한 원인은 다음과 같아요:

* 주기를 수동으로 설정했는데 고객의 구독에 활성 상품 라인이 두 개 이상 있는 경우예요. 이 경우 Loop는 대상 주기에 일치하는 판매 플랜을 요구해요. Loop에서 판매 플랜을 생성하거나, 제안 구성에서 **Use an existing selling plan**으로 전환하세요.
* **Use an existing selling plan**을 사용했는데 선택한 판매 플랜이 더 이상 Loop 대시보드에 존재하지 않는 경우예요. Loop에서 판매 플랜을 생성하고 다시 시도하세요.
* API 토큰이 만료되었거나 필요한 권한이 없는 경우예요: Subscription contracts에 대한 **write**, Orders와 Selling plans에 대한 **read**. **Step 1: Connect provider**로 이동해 키를 다시 테스트하고, 오류 메시지에서 구체적으로 누락된 스코프를 확인하세요.
* 퍼널의 대상 상품이 고객이 실제로 구독한 것과 일치하지 않는 경우예요.

Aftersell은 실패한 공급자 호출을 백그라운드 워크플로에서 자동으로 재시도해요. 모든 재시도가 실패하면 스토어 URL, Shopify 주문 ID, 고객의 이메일, 업그레이드가 수락된 대략적인 시각, 사용 중인 공급자를 포함해 지원팀에 문의하세요.

**판매 플랜 드롭다운이 비어 있어요**

"Use an existing selling plan" 옵션은 Loop에서 직접 플랜을 가져와요. 드롭다운이 비어 있다면:

* Loop 대시보드에 판매 플랜이 구성되어 있는지 확인하세요.
* API 토큰에 Selling plans에 대한 **Read** 접근 권한이 있는지 확인하세요.
* **Step 1: Connect provider**로 돌아가 API 키를 다시 테스트하고 계속 진행하세요.

**Loop 대시보드에 일시적인 진행 중 라인이 표시돼요**

멀티 라인 구독에서는 정상적인 동작이에요. Loop는 두 단계(분리 후 제거)로 처리하므로, 두 단계 사이에 일시적인 라인이 나타날 수 있어요. 두 번째 단계가 완료되면 바로 해결돼요.

***

← [구독 업그레이드 개요](/ko/aftersell/subscription-upgrades)로 돌아가기 · [설정 & 구성](/ko/aftersell/subscription-upgrades-setup) · [연동이란 무엇인가요?](/ko/aftersell/subscription-upgrades-integrations)