Skip to main content
Oplossingen voor de meest voorkomende problemen met Subscription Upgrades. Kom je er na het proberen hiervan nog steeds niet uit, neem dan contact op met support met de details vermeld onder Testen en verifiëren.

​
Mislukte upgrades monitoren

Aftersell monitort definitief mislukte upgrades over een voortschrijdend venster van 7 dagen. Als het aantal mislukkingen de waarschuwingsdrempel overschrijdt, verschijnt er een waarschuwingsbanner op je startpagina die beschrijft hoeveel upgrades zijn mislukt en over hoeveel dagen. Dezelfde melding verschijnt ook in het paneel Needs attention van de startpagina. De melding bevat een knop Review orders die je rechtstreeks naar de orderbrowser brengt, gefilterd op problemen met abonnementsupgrades, zodat je de getroffen bestellingen en de specifieke oorzaak van elke mislukking kunt zien. De melding verdwijnt automatisch zodra het aantal mislukkingen binnen het voortschrijdende venster onder de drempel zakt. Zie je deze melding, open dan de orderbrowser, controleer de oorzaak die bij elke getroffen bestelling wordt getoond en raadpleeg vervolgens de relevante stappen voor probleemoplossing hieronder.
De sjabloon Subscription Upgrade is nooit verborgen — deze staat altijd vermeld onder Add Funnel, ongeacht je providerconfiguratie. Wat je tegenhoudt, is de verbindingscontrole van stap 1: Continue blijft uitgeschakeld totdat Test API key het resultaat API key verified met een groen vinkje geeft.Twee verschillende uitkomsten tonen hetzelfde rode annuleerpictogram, dus lees het bericht ernaast:
  • Je provider heeft de sleutel afgewezen. Het token mist vereiste scopes of is ingetrokken, en het bericht benoemt het specifieke probleem. Maak een nieuw token aan in je providerdashboard met de scopes vermeld in Installatie & configuratie, plak het en test opnieuw.
  • Aftersell kon je provider niet bereiken — “Could not verify the API key. Please try again.” Er is niet per se iets mis met het token; de aanroep zelf is mislukt. Klik nogmaals op Test API key.
Het bewerken van de provider of het token wist het vorige resultaat, dus test opnieuw na elke wijziging.
Dit is verwacht gedrag. Het product is het aanbiedingsproduct, de placeholder-orderregel die aan de Shopify-bestelling wordt toegevoegd als registratie van de geaccepteerde upgrade. Om verwarring te verminderen, kun je het aanbiedingsproduct hernoemen naar iets duidelijks en in Shopify Admin een beschrijving toevoegen die uitlegt wat het voorstelt. Zie Wat de klant ziet.
De Shopify-changeset en de provider-API-aanroep zijn onafhankelijk van elkaar. Als het aanbiedingsproduct aan de bestelling is toegevoegd maar het abonnement niet is gewijzigd, zijn de meest voorkomende oorzaken:
  • Je provider-API-token is verlopen of mist de vereiste rechten. Voor Recharge moet het token read_orders, read_subscriptions, write_subscriptions en read_plans hebben. Ga naar Step 1: Connect provider, test je sleutel opnieuw en controleer het foutbericht op de specifieke ontbrekende scopes.
  • Het in aanmerking komende product in de funnel komt niet overeen met waar de klant daadwerkelijk op geabonneerd is.
  • Voor Loop bestaat het beoogde selling plan niet in je Loop-dashboard voor de geconfigureerde frequentie.
  • De retry-workflow kan nog bezig zijn met het schema: na een mislukte aanroep probeert deze het opnieuw na +1 uur en vervolgens na +24 uur. Dit is voor elke provider hetzelfde — inclusief Loop, waarvan de upgrade-aanroepen synchroon zijn en direct in het dashboard verschijnen wanneer ze slagen.
Aftersell probeert mislukte provider-aanroepen automatisch opnieuw in een achtergrondworkflow. De workflow controleert de huidige status bij de provider voordat deze opnieuw wordt uitgevoerd, zodat een geslaagde maar trage upgrade niet twee keer wordt toegepast.Als een herhaling de oorzaak niet kan verhelpen, zal de workflow ofwel de afschrijving terugbetalen — wanneer geen enkele providerwijziging is geslaagd en de belaste regel een placeholder was — of de upgrade markeren voor handmatige afstemming, waarbij de bestelling intact blijft. Volledig nieuwe abonnementen en box-upgrades worden nooit automatisch terugbetaald, omdat de klant echte producten ontvangt. Neem contact op met support met de details vermeld in Testen en verifiëren.
De optie “Use an existing selling plan” haalt plannen rechtstreeks op uit Recharge, Skio of Loop. Als de dropdown leeg is:
  • Controleer of er selling plans zijn geconfigureerd in je providerdashboard.
  • Zorg ervoor dat je API-token leestoegang heeft tot Plans (Recharge: scope read_plans) of de juiste scopes heeft (Skio, Loop).
  • Ga terug naar Step 1: Connect provider, test je API-sleutel opnieuw en ga verder.
Dit is verwacht gedrag. Bij Loop wordt het veld Billing frequency helemaal niet getoond — alleen Delivery frequency, met de opmerking “Loop syncs billing to delivery — customers are charged on each renewal”. Wat je instelt als leveringsfrequentie is ook de factureringsfrequentie.Dat is ook waarom prepaid abonnementen — een factureringsfrequentie langer dan de leveringsfrequentie — niet worden ondersteund op Loop: de integratie wijst ze direct af in plaats van een veld aan te bieden dat je niet kunt gebruiken. De andere providers tonen beide velden.
Het aanbiedingsproduct is alleen als abonnement verkrijgbaar — het product zelf, of elke variant ervan — en de checkout van de klant bevatte al een abonnement. Shopify staat geen tweede abonnement toe op dezelfde bestelling, dus de aanbieding is overgeslagen.Het paneel met bestelgegevens geeft precies aan welk geval het was: “The customer’s checkout already has a subscription, and the offer product is subscription-only”, of “All variants of the offer product are subscriptions, and the customer’s checkout already has one.” Beide los je op dezelfde manier op — bewerk de productselectie van de aanbieding en vervang deze door een product voor eenmalige aankoop, of gebruik de optie Create new in Step 4: Offer product om een placeholder te genereren.
  • Controleer of Show this funnel for all customers niet is ingeschakeld. Dit overschrijft alle andere triggers.
  • Controleer de trigger Variant on subscription. Deze toont de funnel alleen wanneer de bestelling een van de geselecteerde producten bevat die als abonnement is gekocht. In een funnel met een abonnementsupgrade-aanbieding beheert de wizard deze trigger en houdt deze gesynchroniseerd met het product dat wordt geüpgraded, dus de trigger is alleen-lezen — het paneel toont “Managed by this funnel’s subscription upgrade offer.” Als de trigger op de verkeerde producten is gericht, corrigeer dan het triggerproduct van de upgrade-aanbieding in plaats van de trigger zelf.
  • Controleer de funnelprioriteit. Een funnel met hogere prioriteit en bredere triggers kan als eerste worden geactiveerd.
Probeer dit niet na te bouwen met een aparte producttrigger plus een abonnementstrigger. Die combinatie is precies wat Variant on subscription heeft vervangen: de twee matchten onafhankelijk van elkaar, dus een bestelling met je triggerproduct als eenmalige aankoop en een niet-gerelateerd abonnementsitem voldeed aan beide, activeerde de funnel, waarna de upgrade verderop mislukte. Eén trigger die product en abonnementsstatus samen matcht, is de ondersteunde configuratie.