Skip to main content
Deze pagina behandelt alles wat specifiek is voor het gebruik van Recharge met Subscription Upgrades. Zie Subscription Upgrades voor een volledig overzicht van hoe Subscription Upgrades werken.

Ondersteunde functies

Recharge 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)
  • Prepaid en postpaid frequenties

Je Recharge API-token genereren

  1. Log in op je Recharge merchant portal.
  2. Ga naar Tools & Apps → API Tokens.
  3. Klik op Create an API Token.
  4. Voer een naam en contact-e-mailadres in.
  5. Stel de rechten in die Aftersell nodig heeft: Read and Write op Subscriptions, en Read op Orders en Plans. Er is geen Products-scope vereist.
  6. Klik op Save en kopieer de API-sleutel.
Het token moet alle vier de scopes bevatten: read_orders, read_subscriptions, write_subscriptions en read_plans. Aftersell controleert op alle vier wanneer je de sleutel test en benoemt eventuele ontbrekende scopes in het foutbericht. Zie de API-documentatie van Recharge voor meer details.

Recharge verbinden in de installatiewizard

Wanneer je bij Step 1: Connect provider in de Subscription Upgrade-wizard bent:
  1. Selecteer Recharge 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 Recharge 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.

Een upgrade verifiëren in Recharge

Na het plaatsen van een testbestelling en het accepteren van de upgrade-aanbieding: Ga naar Customers in je Recharge-dashboard, zoek de klant en open Subscriptions. Het actieve abonnement zou de nieuwe frequentie, het nieuwe product of de nieuwe korting direct moeten weergeven. Recharge wordt vrijwel realtime bijgewerkt na acceptatie.

Recharge-specifieke problemen oplossen

De upgrade is geaccepteerd maar het abonnement is niet aangepast De meest voorkomende oorzaken:
  • Je API-token is verlopen of mist de vereiste rechten. Het token moet 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.
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 Recharge. Als de dropdown leeg is:
  • Controleer of er selling plans zijn geconfigureerd in je Recharge-dashboard.
  • Zorg ervoor dat je API-token de scope read_plans heeft.
  • Ga terug naar Step 1: Connect provider, test je API-sleutel opnieuw en ga verder.

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