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

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

> Recharge 연결과 Aftersell에서 구독 업그레이드를 설정하는 단계별 가이드예요.

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

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

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

* 배송 또는 청구 주기 변경
* 다른 상품으로 교체
* 둘 다 – 주기 변경과 상품 교체
* 구독에 다른 구독 가능 상품 추가 ([상품 추가](/ko/aftersell/subscription-upgrades-add-item) 참고)
* 선불 및 후불 주기

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

1. Recharge 머천트 포털에 로그인하세요.
2. **Tools & Apps → API Tokens**로 이동하세요.
3. **Create an API Token**을 클릭하세요.
4. 이름과 연락처 이메일을 입력하세요.
5. Aftersell에 필요한 권한을 설정하세요: Subscriptions에 대한 **Read and Write**, Orders와 Plans에 대한 **Read**. Products 스코프는 필요하지 않아요.
6. **Save**를 클릭하고 API 키를 복사하세요.

토큰은 네 가지 스코프를 모두 보유해야 해요: `read_orders`, `read_subscriptions`, `write_subscriptions`, `read_plans`. Aftersell은 키를 테스트할 때 네 가지 모두를 확인하고, 누락된 스코프를 오류 메시지에 표시해요.

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

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

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

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

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

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

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

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

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

Recharge 대시보드에서 **Customers**로 이동해 고객을 찾은 다음 **Subscriptions**를 여세요. 활성 구독에 새 주기, 상품 또는 할인이 즉시 반영되어야 해요.

Recharge는 수락 후 거의 실시간으로 업데이트돼요.

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

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

가장 흔한 원인:

* API 토큰이 만료되었거나 필요한 권한이 없는 경우예요. 토큰에는 `read_orders`, `read_subscriptions`, `write_subscriptions`, `read_plans`가 있어야 해요. **Step 1: Connect provider**로 이동해 키를 다시 테스트하고, 오류 메시지에서 구체적으로 누락된 스코프를 확인하세요.
* 퍼널의 대상 상품이 고객이 실제로 구독한 것과 일치하지 않는 경우예요.

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

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

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

* Recharge 대시보드에 판매 플랜이 구성되어 있는지 확인하세요.
* API 토큰에 `read_plans` 스코프가 있는지 확인하세요.
* **Step 1: Connect provider**로 돌아가 API 키를 다시 테스트하고 계속 진행하세요.

***

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