Recursos suportados
- 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). 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)
Mudando uma assinatura para um plano de pagamento antecipado
- 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.
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 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
- No seu painel da Stay AI, vá para Account → API tokens → Add API key.
- 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.
- Copie a chave e guarde-a em um lugar seguro. Trate-a como uma senha.
Conectando a Stay AI no assistente de configuração
- Selecione Stay AI no dropdown Subscription provider.
- Cole sua chave de API no campo API key.
- Clique em Test API key. O Aftersell valida a chave, verificando se ela autentica corretamente e se pertence à sua loja.
- Quando o teste passar (marca verde), clique em Continue para avançar para a Etapa 2.
- 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.
Verificando um upgrade na Stay AI
Se um upgrade não puder ser aplicado
- 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.
Solução de problemas específicos da Stay AI
- 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.
← Voltar para Visão geral dos upgrades de assinatura · Configuração · O que são integrações?