Ondersteunde functies
- Wijzig de leverings- of factureringsfrequentie (toegepast op het hele abonnement)
- Vervang door een ander product
- Beide - wijzig de frequentie en vervang het product
- Voeg een ander abonneerbaar item toe aan het abonnement (zie Een item toevoegen). Als de klant al op dat product geabonneerd is, verhoogt Stay de hoeveelheid ervan in plaats van een nieuwe regel toe te voegen (hiervoor geldt een voorwaarde voor een overeenkomende prijs - zie de beperkingen hieronder).
- Postpaid frequenties (betalen per levering), inclusief het overzetten van een postpaid abonnement naar een vooruitbetaald plan (onder de onderstaande voorwaarden)
Een abonnement overzetten naar een vooruitbetaald plan
- Het vooruitbetaalde plan moet al bestaan in Stay AI en aan het product zijn toegewezen. Aftersell kan er geen aanmaken; in de aanbieding kun je alleen kiezen uit plannen die al in Stay AI zijn ingesteld.
- De overzetting maakt een nieuw abonnement aan en annuleert het oude. Stay voert deze wijziging door door een nieuw abonnement op het vooruitbetaalde plan aan te maken en het oorspronkelijke te annuleren, waardoor het abonnement een nieuwe referentie krijgt. Magazijn-, 3PL- of rapportagetools die abonnementen op referentie bijhouden, moeten opnieuw synchroniseren. Zie Fulfillment en 3PL-mapping.
Stay AI-specifieke beperkingen
- Prepaid (vooruitbetaalde) abonnementen kunnen niet worden gewijzigd. Stay staat geen enkele wijziging toe aan een abonnement waarvoor de klant vooruit heeft betaald, ongeacht het upgradetype. Als een klant met een prepaid plan een upgrade-aanbieding accepteert, wordt de upgrade geannuleerd en krijgt de klant zijn geld terug, zodat het abonnement onaangeroerd blijft. Om dezelfde reden kun je een abonnement niet wisselen naar een product dat alleen op vooruitbetaalde plannen wordt verkocht.
- Annuleringen zijn beperkt tot één app per account. Stay stuurt annuleringsupdates naar slechts één app per account. Als een andere app of integratie zich vóór Aftersell heeft geregistreerd voor de annuleringswebhook van Stay, kan Aftersell die updates niet ontvangen en geeft de grafiek Subscriptions cancelled geen Stay-annuleringen weer. De API-sleutel die je verbindt, moet de machtiging Webhooks bevatten (zie hieronder) om annuleringen überhaupt te kunnen bijhouden.
- Een frequentiewijziging geldt voor het hele abonnement. Stay heeft één schema per abonnement, dus als je wijzigt hoe vaak het wordt geleverd, verschuift elk product erop mee. Wanneer het abonnement twee of meer producten bevat, moet je Keep on existing subscription inschakelen op de aanbieding; anders wordt de frequentie-upgrade geweigerd en krijgt de shopper zijn geld terug. Dit is alleen nodig voor frequentiewijzigingen - productwissels en add-ons worden niet beïnvloed en werken zonder deze instelling.
- Meer toevoegen van een product waarop de klant al geabonneerd is, vereist een overeenkomende prijs. Wanneer de add-on een product is dat de klant al heeft, verhoogt Stay de hoeveelheid in plaats van een regel toe te voegen - maar alleen als de prijs van de aanbieding overeenkomt met wat de klant er al voor betaalt. Als de prijzen verschillen (bijvoorbeeld de add-on biedt 20% korting terwijl het plan van de klant 10% korting geeft), wordt de upgrade geweigerd en blijft het abonnement ongewijzigd. Geef de add-on dezelfde korting als het plan van de klant, of bied een ander product aan (een ander product wordt niet beïnvloed).
- De valuta moet overeenkomen met de prijzen van je winkel. Als het abonnement van de klant wordt gefactureerd in een valuta waarin je winkel geen prijzen hanteert, wordt de upgrade geweigerd.
- Dubbele abonnementen uit één bestelling kunnen niet van elkaar worden onderscheiden. Als één bestelling twee Stay-abonnementen heeft gestart die allebei het product van de aanbieding bevatten, kan Aftersell niet bepalen welke de klant bedoelde, en wordt de upgrade geweigerd in plaats van op het verkeerde contract toegepast.
- Rate limits beperken de doorvoer. Stay staat 60 verzoeken per minuut per account toe. Eén upgrade kost vier tot zes verzoeken, dus een winkel haalt op piekmomenten maximaal ongeveer 10 tot 15 upgrades per minuut.
Je Stay AI API-sleutel genereren
- Ga in je Stay AI-dashboard naar Account → API tokens → Add API key.
- Selecteer bij het aanmaken van de sleutel All permissions. Aftersell heeft toegang nodig tot Subscriptions, Orders, Selling Plan Groups en Webhooks. Met de Webhooks-machtiging kan Aftersell op de hoogte worden gebracht van annuleringen.
- Kopieer de sleutel en bewaar hem op een veilige plek. Behandel hem als een wachtwoord.
Stay AI verbinden in de installatiewizard
- Selecteer Stay AI in de dropdown Subscription provider.
- Plak je API-sleutel in het veld API key.
- Klik op Test API key. Aftersell valideert de sleutel en controleert of deze correct authenticeert en bij jouw winkel hoort.
- Zodra de test slaagt (groen vinkje), klik je op Continue om naar stap 2 te gaan.
- Groen vinkje - “API key verified”. De sleutel is geauthenticeerd en hoort bij jouw winkel. Continue is nu ingeschakeld. Als de sleutel de machtiging Webhooks mist, slaagt de test nog steeds, maar wordt gewaarschuwd dat abonnementsannuleringen niet worden geregistreerd - maak de sleutel opnieuw aan in Stay AI met All permissions als je annuleringen wilt bijhouden.
- Rood annuleerpictogram. De controle is niet goed doorlopen. Lees het bericht naast het pictogram: de sleutel is afgewezen, of Aftersell kon de controle niet voltooien (“Could not verify the API key. Please try again.”), wat een mislukte aanroep is en geen foute sleutel - test in dat geval gewoon opnieuw.
Een upgrade verifiëren in Stay AI
Als een upgrade niet kan worden toegepast
- Mislukte upgrades worden automatisch opnieuw geprobeerd. Als een aanroep naar Stay AI mislukt, probeert Aftersell deze opnieuw in een achtergrondworkflow.
- Als de upgrade nog steeds niet kan worden toegepast, krijgt de shopper zijn geld terug. Een Subscription Upgrade rekent alleen een kleine placeholderregel af op de Shopify-bestelling (geen product dat de shopper houdt), dus Aftersell betaalt die afschrijving terug wanneer de upgrade niet kan worden voltooid.
- Alles wat niet kan worden bevestigd, wordt gemarkeerd voor handmatige controle in plaats van te gokken, zodat een shopper nooit wordt belast voor een upgrade die niet heeft plaatsgevonden.
Stay AI-specifieke problemen oplossen
- De klant heeft een prepaid (vooruitbetaald) plan. Stay staat niet toe dat prepaid contracten worden gewijzigd, dus de upgrade wordt geannuleerd en terugbetaald. Dit is verwacht gedrag.
- Het abonnement wordt gefactureerd in een valuta waarin je winkel geen prijzen hanteert, dus de upgrade is geweigerd.
- Het abonnement heeft twee of meer producten en je hebt de frequentie gewijzigd zonder Keep on existing subscription in te schakelen.
- Eén bestelling heeft twee Stay-abonnementen gestart die allebei het product van de aanbieding bevatten, dus Aftersell kon niet bepalen welke moest worden geüpgraded.
- Je API-sleutel is van een andere winkel, of mist een vereiste machtiging (Subscriptions, Orders of Selling Plan Groups). Maak de sleutel opnieuw aan of selecteer hem opnieuw in Stay AI, ga naar Step 1: Connect provider en test hem opnieuw.
- Het in aanmerking komende product in de funnel komt niet overeen met waar de klant daadwerkelijk op geabonneerd is.
← Terug naar Overzicht abonnementsupgrades · Installatie & configuratie · Wat zijn integraties?