> ## 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 Stay AI > Guia passo a passo para conectar a Stay AI e configurar os Upgrades de Assinatura no Aftersell, incluindo limitações específicas da Stay AI relacionadas a planos pré-pagos, cancelamentos e moeda. Esta página cobre tudo o que é específico do uso da **Stay AI** com os Upgrades de Assinatura, incluindo suas limitações exclusivas. Para uma visão geral completa de como os Upgrades de Assinatura funcionam, consulte [Upgrades de Assinatura](/pt/aftersell/subscription-upgrades).
## Recursos suportados
A Stay AI suporta todos os tipos de Upgrade de Assinatura: * Alterar a frequência de entrega ou de cobrança (aplicada à assinatura inteira) * 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)). Se o cliente já assina esse produto, a Stay aumenta sua quantidade em vez de adicionar uma nova linha (isso tem uma condição de correspondência de preço - consulte as limitações abaixo). * Frequências pós-pagas (pagamento por entrega), incluindo a mudança de uma assinatura pós-paga para um plano de pagamento antecipado (com as condições abaixo) Trocas de produto são suportadas, **exceto para um produto vendido apenas em planos de pagamento antecipado** - consulte a limitação de pré-pago abaixo.
### Mudando uma assinatura para um plano de pagamento antecipado
Mudar uma assinatura pós-paga para um plano de pagamento antecipado (pré-pago) é suportado, com duas condições: * **O plano de pagamento antecipado já deve existir na Stay AI e estar atribuído ao produto.** O Aftersell não consegue criar um; a oferta só permite escolher entre planos já configurados na Stay AI. * **A mudança cria uma nova assinatura e cancela a antiga.** A Stay faz essa alteração criando uma nova assinatura no plano de pagamento antecipado e cancelando a original, então a assinatura recebe uma **nova referência**. Ferramentas de armazém, 3PL ou relatórios que rastreiam assinaturas pela referência precisam ser ressincronizadas. Consulte [Fulfillment e mapeamento de 3PL](/pt/aftersell/subscription-upgrades-fulfillment).
## Limitações específicas da Stay AI
* **Assinaturas pré-pagas (pagamento antecipado) não podem ser modificadas.** A Stay não permite nenhuma alteração em uma assinatura que o cliente pagou antecipadamente, seja qual for o tipo de upgrade. Se um cliente em um plano pré-pago aceitar uma oferta de upgrade, o upgrade é cancelado e ele é reembolsado, então a assinatura permanece intacta. Pelo mesmo motivo, você não pode trocar uma assinatura para um produto vendido apenas em planos de pagamento antecipado. * **Os cancelamentos são limitados a um app por conta.** A Stay envia atualizações de cancelamento para apenas **um app por conta**. Se outro app ou integração se registrou no webhook de cancelamento da Stay antes do Aftersell, o Aftersell não consegue receber essas atualizações, e o [gráfico Subscriptions cancelled](/pt/aftersell/analytics_metrics_reference#subscriptions-cancelled-chart) não refletirá os cancelamentos da Stay. A chave de API que você conectar deve incluir a permissão **Webhooks** (veja abaixo) para que o rastreamento de cancelamentos funcione. * **Uma alteração de frequência se aplica à assinatura inteira.** A Stay tem uma única agenda por assinatura, então alterar a frequência de entrega move todos os produtos dela. Quando a assinatura contém dois ou mais produtos, você deve ativar **Keep on existing subscription** na oferta; caso contrário, o upgrade de frequência é recusado e o comprador é reembolsado. Isso só é necessário para alterações de frequência - trocas de produto e add-ons não são afetados e funcionam sem essa opção. * **Adicionar mais unidades de um produto que o cliente já assina exige um preço correspondente.** Quando o add-on é um produto que o cliente já tem, a Stay aumenta sua quantidade em vez de adicionar uma linha - mas apenas se o preço da oferta corresponder ao que o cliente já paga por ele. Se os preços forem diferentes (por exemplo, o add-on oferece 20% de desconto enquanto o plano do cliente tem 10% de desconto), o upgrade é recusado e a assinatura permanece inalterada. Dê ao add-on o mesmo desconto do plano do cliente ou ofereça um produto diferente (um produto diferente não é afetado). * **A moeda deve corresponder aos preços da sua loja.** Se a assinatura do cliente for cobrada em uma moeda na qual sua loja não define preços, o upgrade é recusado. * **Assinaturas duplicadas de um mesmo pedido não podem ser diferenciadas.** Se um único pedido iniciou duas assinaturas na Stay que contêm o produto da oferta, o Aftersell não consegue saber a qual delas o cliente se referia, e o upgrade é recusado em vez de ser aplicado ao contrato errado. * **Os limites de requisições restringem a capacidade.** A Stay permite 60 requisições por minuto por conta. Um upgrade usa de quatro a seis requisições, então uma loja chega a cerca de 10 a 15 upgrades por minuto no pico.
## Gerando sua chave de API da Stay AI
1. No seu painel da Stay AI, vá para **Account → API tokens → Add API key**. 2. Ao criar a chave, selecione **All permissions**. O Aftersell precisa de acesso a **Subscriptions**, **Orders**, **Selling Plan Groups** e **Webhooks**. A permissão Webhooks é o que permite ao Aftersell saber dos cancelamentos. 3. Copie a chave e guarde-a em um lugar seguro. Trate-a como uma senha. Para mais detalhes, consulte a [documentação de autenticação da API da Stay AI](https://docs.stay.ai/reference/authentication).
## Conectando a Stay AI no assistente de configuração
Quando você chegar à **Etapa 1: Connect provider** no assistente de Upgrade de Assinatura: 1. Selecione **Stay AI** no dropdown **Subscription provider**. 2. Cole sua chave de API no campo **API key**. 3. Clique em **Test API key**. O Aftersell valida a chave, verificando se ela autentica corretamente e se 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".** A chave foi autenticada e pertence à sua loja. **Continue** agora está habilitado. Se a chave não tiver a permissão **Webhooks**, o teste ainda passa, mas avisa que os cancelamentos de assinatura não serão registrados - recrie a chave na Stay AI com **All permissions** se quiser o rastreamento de cancelamentos. * **Ícone vermelho de cancelamento.** A verificação não foi concluída com sucesso. Leia a mensagem ao lado do ícone: ou a chave foi rejeitada, 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 uma chave inválida - 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 a chave limpa o resultado anterior.
## Verificando um upgrade na Stay AI
Depois de fazer um pedido de teste e aceitar a oferta de upgrade: Vá para **Subscriptions** no seu painel da Stay AI e localize a assinatura do cliente. A frequência de cobrança, o produto ou a data da próxima cobrança devem refletir a alteração. A alteração em si é aplicada assim que o Aftersell processa a aceitação, mas a Stay pode demorar para receber um pedido novo: o upgrade geralmente aparece em poucos minutos e, nos casos mais lentos, em até 24 horas. Se a alteração ainda não estiver lá, aguarde um pouco antes de tratá-la como uma falha.
## Se um upgrade não puder ser aplicado
Os upgrades da Stay AI são seguros por design - um comprador nunca é cobrado por um upgrade que não aconteceu: * **Upgrades com falha são repetidos automaticamente.** Se uma chamada à Stay AI falhar, o Aftersell a repete em um fluxo de trabalho em segundo plano. * **Se ainda assim não puder ser aplicado, o comprador é reembolsado.** Um Subscription Upgrade cobra apenas uma pequena linha placeholder no pedido da Shopify (não um produto que o comprador mantém), então o Aftersell reembolsa essa cobrança quando o upgrade não pode ser concluído. * **Qualquer coisa que não possa ser confirmada é sinalizada para revisão manual** em vez de ser presumida, então um comprador nunca é cobrado por um upgrade que não aconteceu. Para o funcionamento completo das novas tentativas e da reconciliação (comum a todos os provedores), consulte [Como os Upgrades de Assinatura funcionam](/pt/aftersell/subscription-upgrades#how-subscription-upgrades-work).
## Solução de problemas específicos da Stay AI
**O upgrade foi aceito, mas a assinatura não foi modificada** As causas mais comuns: * O cliente está em um plano **pré-pago (pagamento antecipado)**. A Stay não permite que contratos pré-pagos sejam modificados, então o upgrade é cancelado e reembolsado. Isso é esperado. * A assinatura é cobrada em uma **moeda na qual sua loja não define preços**, então o upgrade foi recusado. * A assinatura tem **dois ou mais produtos** e você alterou a frequência sem ativar **Keep on existing subscription**. * Um pedido iniciou **duas assinaturas na Stay** que contêm o produto da oferta, então o Aftersell não conseguiu saber qual delas atualizar. * Sua chave de API é de outra loja ou não tem uma permissão necessária (**Subscriptions**, **Orders** ou **Selling Plan Groups**). Recrie ou selecione novamente a chave na Stay AI, 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. **Os cancelamentos da Stay não aparecem nas análises** A Stay envia atualizações de cancelamento para apenas um app por conta. Se outro app se registrou no webhook de cancelamento da Stay antes do Aftersell, o Aftersell não consegue recebê-las. Confirme que nenhuma outra integração é dona do webhook de cancelamento da Stay e verifique se a chave de API conectada inclui a permissão **Webhooks**. *** ← 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)