지원되는 기능
- 배송 또는 청구 주기 변경 (구독 전체에 적용)
- 다른 상품으로 교체
- 둘 다 - 주기 변경과 상품 교체
- 구독에 다른 구독 가능 상품 추가 (상품 추가 참고). 고객이 이미 해당 상품을 구독하고 있다면, Stay는 새 라인을 추가하는 대신 수량을 늘려요(가격 일치 조건이 있어요 - 아래 제한 사항 참고).
- 후불(배송당 결제) 주기, 후불 구독을 일시불 플랜으로 전환하는 것 포함 (아래 조건 적용)
구독을 일시불 플랜으로 전환하기
- 일시불 플랜이 Stay AI에 이미 존재하고 상품에 할당되어 있어야 해요. Aftersell은 플랜을 생성할 수 없으며, 오퍼에서는 Stay AI에 이미 설정된 플랜 중에서만 선택할 수 있어요.
- 전환 시 새 구독이 생성되고 기존 구독은 취소돼요. Stay는 일시불 플랜으로 새 구독을 생성하고 원래 구독을 취소하는 방식으로 이 변경을 처리하므로, 구독에 새 참조가 부여돼요. 참조로 구독을 추적하는 창고, 3PL 또는 리포팅 도구는 다시 동기화해야 해요. 주문 처리 및 3PL 매핑을 참고하세요.
Stay AI 고유의 제한 사항
- 선불(일시불) 구독은 수정할 수 없어요. Stay는 업그레이드 유형과 관계없이 고객이 일시불로 결제한 구독의 어떤 변경도 허용하지 않아요. 선불 플랜을 사용하는 고객이 업그레이드 오퍼를 수락하면 업그레이드가 취소되고 환불되므로, 구독은 그대로 유지돼요. 같은 이유로, 일시불 플랜으로만 판매되는 상품으로 구독을 교체할 수 없어요.
- 취소 알림은 계정당 하나의 앱으로 제한돼요. Stay는 취소 업데이트를 계정당 하나의 앱에만 보내요. 다른 앱이나 연동이 Aftersell보다 먼저 Stay의 취소 웹훅에 등록했다면 Aftersell은 해당 업데이트를 받을 수 없으며, Subscriptions cancelled 차트에 Stay 취소가 반영되지 않아요. 취소 추적이 작동하려면 연결하는 API 키에 Webhooks 권한(아래 참고)이 포함되어야 해요.
- 주기 변경은 구독 전체에 적용돼요. Stay는 구독당 하나의 일정을 가지므로, 배송 주기를 변경하면 구독에 포함된 모든 상품이 함께 이동해요. 구독에 두 개 이상의 상품이 포함된 경우 오퍼에서 Keep on existing subscription을 켜야 해요. 그렇지 않으면 주기 업그레이드가 거부되고 쇼핑객에게 환불돼요. 이는 주기 변경에만 필요해요 - 상품 교체와 애드온은 영향을 받지 않으며 이 설정 없이도 작동해요.
- 고객이 이미 구독 중인 상품을 더 추가하려면 가격이 일치해야 해요. 애드온이 고객이 이미 보유한 상품이면 Stay는 라인을 추가하는 대신 수량을 늘려요 - 단, 오퍼 가격이 고객이 현재 지불하는 가격과 일치하는 경우에만 그래요. 가격이 다르면(예: 애드온은 20% 할인인데 고객의 플랜은 10% 할인인 경우) 업그레이드가 거부되고 구독은 변경되지 않아요. 애드온에 고객의 플랜과 동일한 할인을 적용하거나, 다른 상품을 제안하세요(다른 상품은 영향을 받지 않아요).
- 통화가 스토어의 가격 책정과 일치해야 해요. 고객의 구독이 스토어에서 가격을 책정하지 않는 통화로 청구되는 경우 업그레이드가 거부돼요.
- 한 주문에서 생성된 중복 구독은 구분할 수 없어요. 하나의 주문으로 오퍼 상품이 포함된 Stay 구독이 두 개 시작된 경우, Aftersell은 고객이 어느 구독을 의도했는지 알 수 없으므로 잘못된 계약에 적용하는 대신 업그레이드를 거부해요.
- 요청 한도가 처리량을 제한해요. Stay는 계정당 분당 60개의 요청을 허용해요. 업그레이드 한 건에 4
6개의 요청이 필요하므로, 스토어는 최대 분당 약 1015건의 업그레이드를 처리할 수 있어요.
Stay AI API 키 생성하기
- Stay AI 대시보드에서 Account → API tokens → Add API key로 이동하세요.
- 키를 생성할 때 All permissions를 선택하세요. Aftersell에는 Subscriptions, Orders, Selling Plan Groups, Webhooks에 대한 접근 권한이 필요해요. Webhooks 권한이 있어야 Aftersell이 취소 정보를 받을 수 있어요.
- 키를 복사하고 안전한 곳에 보관하세요. 비밀번호처럼 취급하세요.
설정 마법사에서 Stay AI 연결하기
- Subscription provider 드롭다운에서 Stay AI를 선택하세요.
- API key 필드에 API 키를 붙여넣으세요.
- Test API key를 클릭하세요. Aftersell이 키를 검증하며, 올바르게 인증되는지와 스토어에 속하는지 확인해요.
- 테스트가 통과하면(초록색 체크) Continue를 클릭해 Step 2로 이동하세요.
- 초록색 체크 - “API key verified”. 키가 인증되었고 스토어에 속해요. 이제 Continue가 활성화돼요. 키에 Webhooks 권한이 없으면 테스트는 통과하지만 구독 취소가 기록되지 않는다는 경고가 표시돼요 - 취소 추적을 원한다면 Stay AI에서 All permissions로 키를 다시 생성하세요.
- 빨간색 취소 아이콘. 검사가 정상적으로 완료되지 않았어요. 아이콘 옆의 메시지를 읽으세요: 키가 거부되었거나, Aftersell이 검사를 완료하지 못한 경우(“Could not verify the API key. Please try again.”)예요. 후자는 잘못된 키가 아니라 호출 실패이므로 다시 테스트하면 돼요.
Stay AI에서 업그레이드 확인하기
업그레이드를 적용할 수 없는 경우
- 실패한 업그레이드는 자동으로 재시도돼요. Stay AI 호출이 실패하면 Aftersell이 백그라운드 워크플로에서 재시도해요.
- 그래도 적용할 수 없으면 쇼핑객에게 환불돼요. 구독 업그레이드는 Shopify 주문에 작은 플레이스홀더 라인(쇼핑객이 보관하는 상품이 아님)만 청구하므로, 업그레이드를 완료할 수 없으면 Aftersell이 해당 청구를 환불해요.
- 확인할 수 없는 항목은 추측하지 않고 수동 검토 대상으로 표시돼요. 따라서 쇼핑객은 실제로 이루어지지 않은 업그레이드에 대해 절대 청구되지 않아요.
Stay AI 관련 문제 해결
- 고객이 선불(일시불) 플랜을 사용하는 경우예요. Stay는 선불 계약의 수정을 허용하지 않으므로 업그레이드가 취소되고 환불돼요. 이는 정상적인 동작이에요.
- 구독이 스토어에서 가격을 책정하지 않는 통화로 청구되어 업그레이드가 거부된 경우예요.
- 구독에 두 개 이상의 상품이 있는데 Keep on existing subscription을 켜지 않고 주기를 변경한 경우예요.
- 하나의 주문으로 오퍼 상품이 포함된 Stay 구독이 두 개 시작되어 Aftersell이 어느 구독을 업그레이드할지 알 수 없는 경우예요.
- API 키가 다른 스토어의 것이거나 필요한 권한(Subscriptions, Orders 또는 Selling Plan Groups)이 없는 경우예요. Stay AI에서 키를 다시 생성하거나 다시 선택한 다음, Step 1: Connect provider로 이동해 다시 테스트하세요.
- 퍼널의 적격 상품이 고객이 실제로 구독한 것과 일치하지 않는 경우예요.
← 구독 업그레이드 개요로 돌아가기 · 설정 & 구성 · 연동이란 무엇인가요?