> ## 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.

# Abonnementsupgrades met Loop

> Stapsgewijze handleiding voor het verbinden van Loop en het instellen van Subscription Upgrades in Aftersell, inclusief Loop-specifieke beperkingen.

Deze pagina behandelt alles wat specifiek is voor het gebruik van **Loop** met Subscription Upgrades, inclusief de unieke beperkingen. Zie [Subscription Upgrades](/nl/aftersell/subscription-upgrades) voor een volledig overzicht van hoe Subscription Upgrades werken.

<div id="supported-features">
  ## Ondersteunde functies
</div>

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](/nl/aftersell/subscription-upgrades-add-item))
* Alleen postpaid frequenties (prepaid wordt niet ondersteund — zie [Beperkingen](#loop-specific-limitations) hieronder)

<div id="loop-specific-limitations">
  ## Loop-specifieke beperkingen
</div>

* **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.
* **Abonnementen met meerdere regels** worden in twee stappen afgehandeld: de betreffende productregel wordt afgesplitst naar een nieuw abonnement met de gewenste frequentie en vervolgens verwijderd uit het oorspronkelijke abonnement. Dit vereist meerdere API-aanroepen en kan tijdens het synchronisatievenster tijdelijke regels in behandeling tonen in je Loop-dashboard.
* **Aangepaste frequentie wordt niet ondersteund voor abonnementen met meerdere regels.** Wanneer je de frequentie handmatig instelt (zonder een selling plan te selecteren), werkt de upgrade voor klanten van wie het abonnement één productregel bevat. Bij klanten met een abonnement met meerdere producten of een bundel (twee of meer actieve regels) mislukt de upgrade als er geen passend selling plan bestaat voor de doelfrequentie. Maak het bijbehorende selling plan aan in je Loop-dashboard om deze klanten te ondersteunen.

<div id="generating-your-loop-api-token">
  ## Je Loop API-token genereren
</div>

1. Open de Loop-app en ga naar **Settings** linksonder.
2. Klik onder **Admin** op **API Tokens**.
3. 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.
4. Klik op **Generate New Token**.
5. Geef een naam op, selecteer de juiste scopes en klik op **Generate Token**.
6. 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](https://loop.app/docs) voor meer details.

<div id="connecting-loop-in-the-setup-wizard">
  ## Loop verbinden in de installatiewizard
</div>

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

1. Selecteer **Loop** in de dropdown **Subscription provider**.
2. Plak je API-token in het veld **API token**.
3. Klik op **Test API key**. Aftersell valideert het token en controleert of het correct authenticeert, alle vereiste scopes bevat en bij jouw winkel hoort.
4. 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.

<div id="before-you-configure-the-upgrade-step-3">
  ## Voordat je de upgrade configureert (stap 3)
</div>

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.

<Note>
  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](#loop-specific-limitations) voor details.
</Note>

<div id="selecting-a-recurring-discount-tier">
  ### Een terugkerende kortingslaag selecteren
</div>

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.

<div id="verifying-an-upgrade-in-loop">
  ## Een upgrade verifiëren in Loop
</div>

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 abonnementen*lijst* 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.

<div id="troubleshooting-loop-specific-issues">
  ## Loop-specifieke problemen oplossen
</div>

**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 bij abonnementen met meerdere regels. Loop handelt ze in twee stappen af (splitsen en vervolgens verwijderen), dus tussen de twee stappen kan een tijdelijke regel verschijnen. Dit lost zich op zodra de tweede stap is voltooid.

***

← Terug naar [Overzicht abonnementsupgrades](/nl/aftersell/subscription-upgrades) · [Installatie & configuratie](/nl/aftersell/subscription-upgrades-setup) · [Wat zijn integraties?](/nl/aftersell/subscription-upgrades-integrations)