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

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

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

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

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

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

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

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

1. Skio 대시보드에서 **API & Integrations → API**로 이동하세요.
2. 새 API 키의 이름을 입력하고 **Generate API key**를 클릭하세요.
3. 키를 즉시 복사하세요. 한 번만 표시돼요.
4. Skio는 전체 접근 권한을 가진 단일 API 키를 발급하므로 별도로 선택할 스코프가 없어요. 이 키는 업그레이드에 필요한 구독 수정, 생성, 취소 권한을 부여해요.

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

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

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

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

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

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

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

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

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

Skio 대시보드에서 **Subscriptions**로 이동해 고객의 구독을 찾으세요. 라인 아이템, 간격, 판매 플랜에 변경 사항이 즉시 반영되어야 해요.

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

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

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

가장 흔한 원인:

* API 토큰이 만료되었거나 더 이상 유효하지 않은 경우예요. Skio는 전체 접근 권한의 단일 키를 사용하므로, Skio에서 새 키를 생성한 뒤 **Step 1: Connect provider**로 이동해 다시 테스트하세요.
* 퍼널의 대상 상품이 고객이 실제로 구독한 것과 일치하지 않는 경우예요.

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

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

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

* Skio 대시보드에 판매 플랜이 구성되어 있는지 확인하세요.
* API 키가 유효하고 여전히 Skio 계정에 접근할 수 있는지 확인하세요.
* **Step 1: Connect provider**로 돌아가 API 키를 다시 테스트하고 계속 진행하세요.

***

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