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

# Upgrades de assinatura com Skio

> Guia passo a passo para conectar o Skio e configurar os Upgrades de Assinatura no Aftersell.

Esta página cobre tudo o que é específico do uso do **Skio** com os Upgrades de Assinatura. Para uma visão geral completa de como os Upgrades de Assinatura funcionam, consulte [Upgrades de Assinatura](/pt/aftersell/subscription-upgrades).

<div id="supported-features">
  ## Recursos suportados
</div>

O Skio suporta todos os tipos de Upgrade de Assinatura:

* Alterar a frequência de entrega ou de cobrança
* Substituir por um produto diferente
* Ambos – alterar a frequência e substituir o produto
* Adicionar outro item assinável à assinatura (consulte [Adicionar um item](/pt/aftersell/subscription-upgrades-add-item))
* Frequências pré-pagas e pós-pagas

<div id="generating-your-skio-api-token">
  ## Gerando seu token de API do Skio
</div>

1. No seu painel do Skio, vá para **API & Integrations → API**.
2. Insira um nome para a sua nova chave de API e clique em **Generate API key**.
3. Copie a chave imediatamente. Ela será exibida apenas uma vez.
4. O Skio emite uma única chave de API de acesso total, então não há escopos separados para selecionar. A chave concede o acesso de edição, criação e cancelamento de assinaturas de que o upgrade precisa.

Para mais detalhes, consulte a [documentação da API do Skio](https://docs.skio.com/).

<div id="connecting-skio-in-the-setup-wizard">
  ## Conectando o Skio no assistente de configuração
</div>

Quando você chegar à **Etapa 1: Connect provider** no assistente de Upgrade de Assinatura:

1. Selecione **Skio** no dropdown **Subscription provider**.
2. Cole seu token de API no campo **API token**.
3. Clique em **Test API key**. O Aftersell valida o token, verificando se ele autentica corretamente e pertence à sua loja.
4. Quando o teste passar (marca verde), clique em **Continue** para avançar para a Etapa 2.

O resultado do teste mostra um de dois estados:

* **Marca verde — "API key verified".** O token foi autenticado e pertence à sua loja. **Continue** agora está habilitado.
* **Ícone vermelho de cancelamento.** A verificação não foi concluída com sucesso. Leia a mensagem ao lado do ícone: ou o token foi rejeitado ou não tem acesso à sua conta Skio. Gere uma nova chave no Skio e teste novamente. Ou o Aftersell não conseguiu concluir a verificação ("Could not verify the API key. Please try again."), o que é uma chamada que falhou e não um token inválido — nesse caso, basta testar novamente.

Um resultado de não-verificação se parece exatamente com uma rejeição, então guie-se pela mensagem e não pelo ícone. **Continue** permanece desabilitado até a verificação voltar verde, e editar o provedor ou o token limpa o resultado anterior.

<div id="verifying-an-upgrade-in-skio">
  ## Verificando um upgrade no Skio
</div>

Depois de fazer um pedido de teste e aceitar a oferta de upgrade:

Vá para **Subscriptions** no seu painel do Skio e localize a assinatura do cliente. O item de linha, o intervalo e o plano de venda devem refletir imediatamente a alteração.

O Skio é atualizado quase em tempo real após a aceitação.

<div id="troubleshooting-skio-specific-issues">
  ## Solução de problemas específicos do Skio
</div>

**O upgrade foi aceito, mas a assinatura não foi modificada**

As causas mais comuns:

* Seu token de API está expirado ou não é mais válido. O Skio usa uma única chave de acesso total, então gere uma nova chave no Skio, vá para a **Etapa 1: Connect provider** e teste-a novamente.
* O produto elegível no funil não corresponde ao que o cliente realmente assinou.

O Aftersell tenta novamente de forma automática as chamadas ao provedor que falharam em um fluxo de trabalho em segundo plano. Se todas as tentativas falharem, entre em contato com o suporte informando a URL da sua loja, o ID do pedido na Shopify, o e-mail do cliente, o horário aproximado em que o upgrade foi aceito e o provedor que você está usando.

**O dropdown de planos de venda está vazio**

A opção "Use an existing selling plan" busca os planos diretamente do Skio. Se o dropdown estiver vazio:

* Confirme se os planos de venda estão configurados no seu painel do Skio.
* Verifique se sua chave de API é válida e ainda tem acesso à sua conta Skio.
* Volte à **Etapa 1: Connect provider**, teste novamente sua chave de API e continue.

***

← Voltar para [Visão geral dos upgrades de assinatura](/pt/aftersell/subscription-upgrades) · [Configuração](/pt/aftersell/subscription-upgrades-setup) · [O que são integrações?](/pt/aftersell/subscription-upgrades-integrations)