Abonnementsupgrades met Loop

Deze pagina behandelt alles wat specifiek is voor het gebruik van Loop met Subscription Upgrades, inclusief de unieke beperkingen. Zie Subscription Upgrades voor een volledig overzicht van hoe Subscription Upgrades werken.

Ondersteunde functies

Loop ondersteunt alle typen Subscription Upgrades:

Wijzig de leverings- of factureringsfrequentie
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)
Alleen postpaid frequenties (prepaid wordt niet ondersteund — zie Beperkingen hieronder)

Loop-specifieke beperkingen

De factureringsfrequentie moet gelijk zijn aan de leveringsfrequentie. Loop ondersteunt geen prepaid abonnementen via deze integratie. Het veld voor de factureringsfrequentie is uitgeschakeld en wordt automatisch gesynchroniseerd met de leveringsfrequentie. Dit is de grootste beperking om rekening mee te houden als je winkel afhankelijk is van prepaid plannen.

Je Loop API-token genereren

Open de Loop-app en ga naar Settings linksonder.
Klik onder Admin op API Tokens.
Stel de rechten in die Aftersell nodig heeft: Read and Write op Subscription contracts, en Read op Orders en Selling plans. Schrijftoegang is alleen vereist voor abonnementen.
Klik op Generate New Token.
Geef een naam op, selecteer de juiste scopes en klik op Generate Token.
Klik op Show Token om je sleutel te bekijken en te kopiëren. Behandel deze als een wachtwoord en bewaar hem op een veilige plek.

Zie de API-documentatie van Loop voor meer details.

Loop verbinden in de installatiewizard

Wanneer je bij Step 1: Connect provider in de Subscription Upgrade-wizard bent:

Selecteer Loop in de dropdown Subscription provider.
Plak je API-token in het veld API token.
Klik op Test API key. Aftersell valideert het token en controleert of het correct authenticeert, alle vereiste scopes bevat en bij jouw winkel hoort.
Zodra de test slaagt (groen vinkje), klik je op Continue om naar stap 2 te gaan.

Het testresultaat toont een van twee statussen:

Groen vinkje — “API key verified”. Het token is geauthenticeerd, alle vereiste scopes zijn aanwezig en het token hoort bij jouw winkel. Continue is nu ingeschakeld.
Rood annuleerpictogram. De controle is niet goed doorlopen. Lees het bericht naast het pictogram: het token is afgewezen of mist vereiste scopes. Het bericht benoemt de specifieke ontbrekende scopes. Corrigeer het token in Loop en test opnieuw. Of Aftersell kon de controle niet voltooien (“Could not verify the API key. Please try again.”), wat een mislukte aanroep is en geen fout token — test in dat geval gewoon opnieuw.

Een could-not-verify-resultaat ziet er precies hetzelfde uit als een afwijzing, dus ga af op het bericht en niet op het pictogram. Continue blijft uitgeschakeld totdat de controle groen terugkomt, en het bewerken van de provider of het token wist het vorige resultaat.

Multi-product abonnementen intact houden

Wanneer standaard een frequentie- of frequentie-en-product-upgrade wordt toegepast op een klant met twee of meer actieve regels op zijn Loop-abonnement, splitst Aftersell het geüpgradede product af naar een nieuw abonnement. Zo blijven de andere artikelen op hun oorspronkelijke factureringscadans staan. Als de andere producten op het abonnement add-ons zijn bij het geüpgradede product (in plaats van zelfstandige abonnementen), kun je Don’t split multi-product subscriptions op de aanbieding inschakelen. Als dit aan staat, hertimet Aftersell het hele contract naar de nieuwe frequentie in plaats van het te splitsen. Wat te verwachten met deze instelling aan:

De andere producten op het abonnement gaan ook mee naar de nieuwe frequentie.
Die producten behouden de korting uit het selling plan van hun oorspronkelijke frequentie, maar dan op de nieuwe cadans.
Aftersell garandeert geen correcte prijzen voor sibling-items — als een sibling-product op een vaste-prijsplan zit zonder passend plan op de nieuwe frequentie, behoudt het zijn oorspronkelijke absolute prijs op de nieuwe cadans.

Schakel dit alleen in wanneer de andere producten add-ons zijn bij het geüpgradede product. Zijn het onafhankelijke abonnementen, gebruik dan het standaard splitsgedrag, zodat elk product op zijn eigen factureringsschema blijft.

Deze instelling is alleen op Loop beschikbaar voor upgrade-typen frequentie en frequentie + product. Ze verschijnt als een selectievakje in het instellingenpaneel van de aanbieding.

Voordat je de upgrade configureert (stap 3)

Bij het configureren van een frequentiewijziging kun je een bestaand selling plan kiezen of de frequentie handmatig instellen:

Gebruik een bestaand selling plan. Kies uit de dropdown met selling plans. Het plan moet al bestaan en actief zijn in je Loop-dashboard.
Stel de frequentie handmatig in. Voer zelf de leveringsfrequentie in. Loop accepteert elke frequentie zonder dat er een passend selling plan nodig is. Je kunt ook een terugkerende korting toepassen bij een handmatige frequentie.

Als je de frequentie handmatig instelt en het abonnement van de klant twee of meer actieve productregels heeft (een contract met meerdere producten of een bundel), mislukt de upgrade tenzij er een passend selling plan bestaat voor de doelfrequentie. Zie Beperkingen voor details.

Een terugkerende kortingslaag selecteren

Sommige Loop selling plans passen verschillende kortingen toe op verschillende momenten in het abonnement — bijvoorbeeld $20 korting op de eerste afschrijving en $10 korting vanaf de tweede afschrijving. Wanneer je zo’n plan selecteert, wordt het veld Recurring discount vervangen door een lijst met keuzerondjes die elke kortingslaag van het plan toont met het bijbehorende afschrijvingsbereik (bijvoorbeeld “Charge 1” of “Charge 2 onward”). Selecteer de laag die je wilt toepassen op elke toekomstige verlenging van het geüpgradede abonnement. De geselecteerde laag wordt opgeslagen bij de aanbieding en toegepast wanneer een klant de upgrade accepteert. Als het geselecteerde plan geen kortingslagen heeft, of als je de frequentie handmatig instelt, verschijnt in plaats daarvan het standaard vrij invulbare kortingsveld.

Een upgrade verifiëren in Loop

Na het plaatsen van een testbestelling en het accepteren van de upgrade-aanbieding: Ga naar Subscriptions in je Loop-dashboard en zoek het abonnement van de klant. De upgrade-aanroepen van Loop zijn synchroon, dus er is geen verwerkingsvertraging aan de kant van Aftersell — de wijziging wordt bij Loop toegepast zodra de aanroep terugkomt. De eigen abonnementenlijst van Loop kan iets langer nodig hebben om bij te werken, dus als de wijziging er nog niet staat, wacht dan een paar minuten en vernieuw de pagina voordat je het als een fout beschouwt. Als de wijziging er niet staat, is deze niet doorgekomen — zie hieronder.

Loop-specifieke problemen oplossen

Ik kan de factureringsfrequentie niet wijzigen Dit is verwacht gedrag. Loop ondersteunt geen prepaid abonnementen via deze integratie. Het veld voor de factureringsfrequentie is uitgeschakeld en wordt automatisch gesynchroniseerd met de leveringsfrequentie. De upgrade is geaccepteerd maar het abonnement is niet aangepast Als het abonnement ongewijzigd is, zijn de meest voorkomende oorzaken:

Je hebt de frequentie handmatig ingesteld en het abonnement van de klant heeft twee of meer actieve productregels. In dit geval vereist Loop een passend selling plan voor de doelfrequentie. Maak het selling plan aan in Loop, of schakel over naar Use an existing selling plan in de aanbiedingsconfiguratie.
Je hebt Use an existing selling plan gebruikt en het geselecteerde selling plan bestaat niet meer in je Loop-dashboard. Maak het selling plan aan in Loop en probeer het opnieuw.
Je API-token is verlopen of mist de vereiste rechten: write op Subscription contracts, read op Orders en Selling plans. 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.

Aftersell probeert mislukte provider-aanroepen automatisch opnieuw in een achtergrondworkflow. Als alle pogingen mislukken, neem dan contact op met support met je winkel-URL, het Shopify-order-ID, het e-mailadres van de klant, het geschatte tijdstip waarop de upgrade is geaccepteerd en de provider die je gebruikt. De dropdown met selling plans is leeg De optie “Use an existing selling plan” haalt plannen rechtstreeks op uit Loop. Als de dropdown leeg is:

Controleer of er selling plans zijn geconfigureerd in je Loop-dashboard.
Zorg ervoor dat je API-token Read-toegang heeft tot Selling plans.
Ga terug naar Step 1: Connect provider, test je API-sleutel opnieuw en ga verder.

Er verschijnen tijdelijke regels in behandeling in mijn Loop-dashboard Dit is verwacht gedrag wanneer een upgrade van een abonnement met meerdere regels het standaard splitsgedrag gebruikt. Loop handelt ze in twee stappen af (splitsen en vervolgens verwijderen), waardoor er tijdens het synchronisatievenster van 24 uur tijdelijke regels kunnen verschijnen. Deze lossen zich automatisch op zodra de synchronisatie is voltooid. Wil je het splitsen volledig vermijden, zie dan Multi-product abonnementen intact houden.

← Terug naar Overzicht abonnementsupgrades · Installatie & configuratie · Wat zijn integraties?

Strategieën

Post-purchase upsells