Skip to main content
Deze pagina beschrijft de volledige werking achter Replacement Upsell: hoe een vervanging wordt verwerkt, welke scenario’s worden ondersteund of zonder melding worden geblokkeerd, de betaal- en kortingsregels, de bèta-failsafe en de volledige catalogus voor probleemoplossing. Zie de gids Vervangende upsells voor hoe je er een bouwt.

Hoe een vervanging wordt verwerkt

Wanneer een klant een Replacement Upsell accepteert:
  1. Het oorspronkelijke eenmalige regelitem wordt in Shopify terugbetaald.
  2. Het vervangende regelitem wordt aan dezelfde bestelling toegevoegd, als eenmalige aankoop of als abonnement (afhankelijk van wat je hebt geconfigureerd).
  3. De klant betaalt voor de vervanging op dezelfde bestelling.
  4. Het afschrift toont twee transacties: de terugbetaling van het origineel en de afschrijving voor de vervanging. De weergegeven knop Accept Offer toont het nettoverschil tussen de twee prijzen.
Dit is geïmplementeerd met de post-purchase API van Shopify:
  • Voor een eenmalige vervanging (andere variant, ander aantal of ander product) stuurt Aftersell een add_variant-changeset.
  • Voor een abonnementsvervanging stuurt Aftersell een add_subscription-changeset.
  • Het oorspronkelijke regelitem wordt verwijderd via de terugbetalings-API van Shopify.
Aftersell roept voor abonnementsvervangingen niet rechtstreeks de API van je abonnementsapp aan. Het abonnement wordt aangemaakt door de native Subscription API van Shopify en je abonnementsapp pikt het op via zijn eigen Shopify-integratie.

Ondersteunde scenario’s

Replacement Upsell ondersteunt vier scenario’s. In elk geval moet het oorspronkelijke regelitem een eenmalige aankoop zijn. De vervanging kan eenmalig of een abonnement zijn.
  • Eenmalig naar eenmalig, hetzelfde product, andere variant. Vervang bijvoorbeeld de maat Twin door de maat Queen.
  • Eenmalig naar eenmalig, hetzelfde product, ander aantal. Vervang bijvoorbeeld een enkele fles door een 3-pack van hetzelfde item. Schakel Override quantity in op de vervanging om het aantal in te stellen dat wordt verzonden.
  • Eenmalig naar eenmalig, een volledig ander product. Vervang bijvoorbeeld een startfles door een versie op volledige grootte van een andere SKU.
  • Eenmalig naar abonnement. Vervang bijvoorbeeld de eenmalige fles door een maandelijks abonnement op dezelfde fles, of door een abonnementsversie van een ander product. Dit is de meest voorkomende toepassing.

Geblokkeerde scenario’s

Deze scenario’s worden door Aftersell geblokkeerd op het moment dat de aanbieding wordt weergegeven. De aanbieding wordt zonder melding overgeslagen als de bestelling van de klant met een van deze scenario’s overeenkomt.
  • Abonnement naar eenmalig. Het verwijderen van het abonnementsregelitem annuleert het abonnementscontract in Recharge, Skio of Loop niet. De klant zou nog steeds worden gefactureerd en daarnaast de vervanging ontvangen.
  • Abonnement naar een ander abonnement. Dezelfde onderliggende oorzaak als hierboven, plus de regel van Shopify van “één abonnement per bestelling” blokkeert het toevoegen van een nieuw abonnement aan een bestelling die er al een bevat.
  • Abonnement naar wissel van abonnementsvariant of -frequentie. Dezelfde onderliggende oorzaak.
Als je het bestaande abonnement van een klant moet wijzigen, gebruik dan in plaats daarvan Subscription Upgrade. Subscription Upgrade wijzigt het bestaande contract in Recharge, Skio of Loop rechtstreeks, zonder te proberen de abonnementsregel te verwijderen en opnieuw toe te voegen.
Wanneer een Replacement Upsell wordt overgeslagen (een geblokkeerd scenario hierboven, een niet-ondersteunde payment gateway of een triggerregel met korting), probeert Aftersell automatisch in plaats daarvan de downsell-aanbieding in dezelfde funnel te tonen. Stel altijd een downsell in als terugvaloptie wanneer je Replacement Upsell gebruikt, zodat de shopper toch een aanbieding ziet.

Wat de klant ziet

Inzicht in wat de klant ziet, voorkomt het meest voorkomende supportticket: “Waarom is er twee keer bij mij afgeschreven?”

In de post-purchase aanbieding

De knop Accept Offer toont het nettoverschil tussen het origineel en de vervanging. Als de klant bijvoorbeeld een fles van $30 heeft gekocht en jij een 3-pack van $45 aanbiedt, staat er op de knop Accept “Add $15.00 to your order.” Als de vervanging goedkoper is dan het origineel, wordt de knop als tegoed weergegeven. De aanbiedingskaart toont de afbeelding, titel en prijs van het vervangende product. De aanbiedingskaart gebruikt de variantspecifieke afbeelding wanneer die in Shopify aan de variant is gekoppeld. Als er geen afbeelding aan de variant is gekoppeld, valt de aanbiedingskaart terug op de eerste afbeelding van het bovenliggende product. Dit betekent dat het wisselen tussen twee varianten van hetzelfde product de afbeelding al dan niet kan veranderen, afhankelijk van of elke variant in Shopify een eigen afbeelding heeft.

Op de Shopify-bestelling na acceptatie

De bestelling toont uiteindelijk beide:
  • Het oorspronkelijke regelitem met een terugbetaling erop toegepast.
  • Het nieuwe regelitem voor de vervanging, afgerekend tegen de volledige prijs.
Het besteltotaal weerspiegelt het nettoresultaat, maar het bankafschrift van de klant toont twee transacties: één afschrijving voor de vervanging en één terugbetaling voor het origineel. Zo verwerkt Aftersell acceptaties van Replacement Upsells op betaalniveau. Het nettobedrag komt overeen met de weergegeven knop Accept Offer. Om verwarring te verminderen:
  • Neem in de aanbiedingstekst een regel op die de werking van terugbetalen en vervangen expliciet beschrijft. Bijvoorbeeld: “Wanneer je accepteert, betalen we het oorspronkelijke item terug en schrijven we het bedrag voor de vervanging af. Je ziet twee regels op je afschrift; het nettobedrag is de upgradeprijs die op deze knop wordt getoond.”
  • Schakel de automatische e-mail met terugbetalingsmelding van Aftersell voor vervangende upsells in, die de klant een bevestiging stuurt waarin de terugbetaling wordt uitgelegd.

In het portaal van de abonnementsprovider (wanneer de vervanging een abonnement is)

Als de vervanging een abonnement is, ziet de klant het nieuwe abonnement in het klantportaal van je abonnementsprovider (Recharge, Skio, Loop, Appstle, Smartrr, Stay.ai). Het portaal is van je abonnementsprovider, niet van Aftersell. Zorg ervoor dat de welkomstmail van je abonnementsprovider zo is geconfigureerd dat deze binnen enkele minuten na acceptatie wordt verstuurd.

Compatibele abonnementsplatforms

Wanneer de vervanging een abonnement is, werkt Replacement Upsell met elke abonnementsapp die de native Subscription API van Shopify gebruikt. Aftersell roept voor deze flow niet rechtstreeks provider-API’s aan; het abonnement wordt door Shopify aangemaakt en je abonnementsapp pikt het op via zijn eigen Shopify-integratie. Compatibele providers zijn onder meer Recharge, Skio, Loop, Stay.ai, Appstle, Smartrr, Bold Subscriptions (wanneer deze op de native subscriptions API van Shopify draait) en de native selling plans van Shopify. Als voor je vervangingsdoel een vooruitbetaald abonnement is geconfigureerd (bijvoorbeeld elke 3 maanden vooraf afgerekend), controleer dan bij je abonnementsprovider of vooruitbetaling wordt ondersteund als vervangingsbestemming. De afhandeling van vooruitbetaling verschilt per provider.

Vereisten voor betaalmethoden

Aftersell blokkeert Replacement Upsell expliciet bij sommige payment gateways, omdat die het patroon van terugbetalen en opnieuw afschrijven binnen het post-purchase venster niet betrouwbaar kunnen ondersteunen:
  • Authorize.net (authorize_net). Authorize.net vereist dat transacties zijn afgewikkeld voordat terugbetalingen kunnen worden gedaan, en de afwikkeling heeft vertraging, dus Aftersell kan het origineel niet betrouwbaar terugbetalen en de vervanging op dezelfde Shopify-bestelling toevoegen. Als Authorize.net je betaalverwerker is, stuur die klanten dan in plaats daarvan naar bedankpagina-aanbiedingen.
  • Handmatige payment gateways (manual). Dit omvat rembours, aangepaste betaalmethoden, checkouts via conceptbestellingen en elke andere handmatige betaalverwerker die geen opgeslagen autorisatie vastlegt. Replacement Upsell heeft een actieve opgeslagen betaling nodig om een vervolgafschrijving te doen, en handmatige gateways bieden die niet.
Wanneer de payment gateway van de bestelling een van deze is, slaat Replacement Upsell de aanbieding zonder melding over. De reden voor het overslaan verschijnt in de Aftersell Order Browser als “Payment gateway does not support replacement upsells.” Zie Betaalmethoden voor de bredere lijst met betaalmethoden die van invloed zijn op alle post-purchase aanbiedingen van Aftersell (niet alleen Replacement Upsell).

Kortingsafhandeling

Replacement Upsell heeft specifiek gedrag rond kortingen dat partners vaak verrast.

Kortingen op de oorspronkelijke regel gaan niet over naar de vervanging

Wanneer Aftersell het oorspronkelijke regelitem terugbetaalt, gaat elke korting die erop was toegepast mee. De vervangende regel wordt afgerekend tegen de volledige prijs (of tegen de korting van je vervangingsaanbieding, als je die hebt geconfigureerd), maar de oorspronkelijke korting van de klant wordt niet overgedragen. Als je wilt dat de klant een gelijkwaardige korting behoudt, configureer die dan rechtstreeks op de vervangingsaanbieding.

Vervanging toestaan wanneer het doel een korting heeft

Standaard slaat Replacement Upsell de aanbieding over als de triggerregel een korting op bestelniveau heeft. Dit is een beschermende standaardinstelling om verschillen in terugbetalingsbedragen te voorkomen. Om de aanbieding ook te laten afgaan wanneer de trigger een korting heeft, schakel je de schakelaar Allow replacement when target has a discount in de geavanceerde instellingen van de aanbieding in. Indien ingeschakeld, dekt de terugbetaling de afgeprijsde prijs (niet de volledige prijs) en wordt de vervanging afgerekend volgens je aanbiedingsconfiguratie.

Korting op de eerste cyclus bij abonnementsvervangingen

Wanneer de vervanging een abonnement is, geldt de korting die je op de aanbieding configureert alleen voor de eerste factureringscyclus. Toekomstige terugkerende bestellingen worden afgerekend tegen de reguliere abonnementsprijs. De klant ziet de terugkerende prijs onder Recurring subtotal in de aanbieding.

Funnels per variant

Eén Replacement Upsell-aanbieding richt zich aan beide kanten op één specifiek product en één specifieke variant. Als je abonnementen per variant verschillen (verschillende maten, smaken of prijzen), kun je niet één aanbieding configureren die zegt “vervang welke variant de klant ook heeft gekocht door de bijbehorende abonnementsvariant.” Elke variantkoppeling heeft een eigen funnel nodig. Als je bijvoorbeeld een serum in drie maten verkoopt (Small / Medium / Large) en elke maat wilt laten wisselen naar de abonnementstegenhanger, bouw je drie funnels:
  • Funnel 1: trigger = Small eenmalig, vervanging = Small abonnement.
  • Funnel 2: trigger = Medium eenmalig, vervanging = Medium abonnement.
  • Funnel 3: trigger = Large eenmalig, vervanging = Large abonnement.
Aftersell heeft momenteel geen ingebouwde functie voor het koppelen van varianten, dus elk variantpaar heeft een eigen funnel nodig.

Analytics en rapportage

Terugbetalingen die door een Replacement Upsell worden gegenereerd, krijgen in Shopify de notitie “AfterSell Post-Purchase Replacement Upsell”, waardoor terugbetalingen die met vervangingen te maken hebben gemakkelijk te herkennen zijn. Aftersell-analytics trekken het terugbetaalde bedrag niet af van de upsellwaarde. Het vervangen van een product van $100 door een product van $200 wordt gerapporteerd als een upsell van $200, niet als netto $100.

De bèta-failsafe

Zolang Replacement Upsell in bèta is, houdt Aftersell fouten per aanbieding bij en stopt het met het tonen van de aanbieding aan nieuwe klanten zodra het aantal fouten een drempel overschrijdt. Dit beschermt je tegen een wijdverbreide misconfiguratie die ongemerkt veel klanten treft.
Bèta-failsafe van Replacement Upsell in de Order Browser

De failsafe-drempel configureren

De failsafe-drempel is configureerbaar in Settings → Replacement Upsells. Deze telt vervangingsfouten over een voortschrijdend venster van 7 dagen en pauzeert vervangende upsells zodra je gekozen drempel binnen dat venster is bereikt. Je kunt kiezen uit:
  • Stop on any issue in the past 7 days (aanbevolen, en de standaard). De aanbieding stopt zodra de eerste vervanging binnen het voortschrijdende venster mislukt.
  • Stop after 3 issues in the past 7 days.
  • Stop after 5 issues in the past 7 days.
  • Stop after 7 issues in the past 7 days (meest tolerant).
  • Custom toont een getalveld waarin je elk geheel getal van 1 tot 100 kunt invoeren. Gebruik dit als je winkel grote ordervolumes verwerkt en de voorinstellingen te snel afgaan.
Kies een hogere drempel als je vertrouwen hebt in de configuratie van de aanbieding en een paar tijdelijke fouten van Shopify of de abonnementsprovider wilt opvangen zonder de aanbieding uit te schakelen. Kies een lagere drempel als fouten die klanten zien voor je winkel veel kosten.

Wat de failsafe activeert

Elke uitzondering in de vervangingsflow telt als een fout binnen het voortschrijdende venster van 7 dagen. De meest voorkomende oorzaken:
  • Shopify weigert de changeset omdat de checkout al is voltooid.
  • Het vervangende product is verwijderd of gedepubliceerd tussen het instellen van de aanbieding en de acceptatie door de klant.
  • Het selling plan van een abonnementsvervanging is gedeactiveerd.
  • Een tijdelijke storing bij de Shopify API of de abonnementsprovider.

Wanneer de failsafe wordt geactiveerd

Wanneer het aantal fouten binnen het voortschrijdende venster van 7 dagen je drempel bereikt, wordt de aanbieding niet meer getoond aan nieuwe klanten. Je merkt dit op twee plaatsen:
  • Banner op de homepage. Er verschijnt een waarschuwingsbanner met de titel “Replacement upsells are paused” op je Aftersell-homepage, met een knop Review failsafe die naar Settings → Replacement Upsells linkt.
  • Statuskaart van de failsafe (Settings → Replacement Upsells). Een statuskaart toont een badge Failsafe tripped (oranje) of Not tripped (groen), plus je huidige voortschrijdende aantal en drempel, bijvoorbeeld “4 of 5 errors in the past 7 days”.
Omdat de failsafe een voortschrijdend venster van 7 dagen gebruikt, herstelt hij zichzelf: zodra het aantal fouten onder je drempel zakt, worden vervangende upsells automatisch hervat, zonder dat je iets hoeft te doen.

Resetten

Je kunt de failsafe zelf resetten via Settings → Replacement Upsells. Zodra je het onderliggende probleem hebt opgelost, klik je op Reset failsafe en bevestig je in de modal. Het voortschrijdende foutaantal wordt direct gewist en vervangende upsells worden hervat voor nieuwe bestellingen. (De knop is uitgeschakeld wanneer je huidige foutaantal al nul is.) Reset pas nadat je de oorzaak hebt opgelost, anders wordt de failsafe opnieuw geactiveerd zodra de drempel is bereikt. Weet je niet zeker wat de fouten heeft veroorzaakt, neem dan vóór het resetten contact op met support via de chat in de app.

Probleemoplossing

Replacement Upsell is een bètafunctie die handmatig door Aftersell support moet worden ingeschakeld. Neem contact op met support via de chat in de app om toegang aan te vragen. Zodra het is ingeschakeld, verschijnt de schakelaar Replace item in original order with upsell in de geavanceerde instellingen van de aanbieding.
Drie oorzaken:
  • Funneltrigger komt niet overeen. Controleer of het triggerproduct hetzelfde product is als het product in de cart van de testbestelling.
  • De bestelling bevat al een abonnement. Replacement Upsell slaat elke bestelling over waarbij de triggerregel een abonnement is. Gebruik in dat geval Subscription Upgrade.
  • De oorspronkelijke regel heeft een korting. Standaard slaat Replacement Upsell regels met een korting op bestelniveau over. Schakel Allow replacement when target has a discount in de geavanceerde instellingen van de aanbieding in.
Een Replacement Upsell-aanbieding heeft in de editor drie afzonderlijke productselecties, en die moeten consistent worden geconfigureerd om de vervanging te laten afgaan:
  1. Funneltrigger. Ingesteld op funnelniveau. Bepaalt welke bestellingen de aanbieding zien.
  2. Upsellproduct. Ingesteld in het gedeelte Upsell Products van de aanbieding. Het product dat aan de bestelling wordt toegevoegd wanneer de klant accepteert.
  3. Edit product to replace. Ingesteld in het gedeelte Replace item in original order with upsell, door op de knop Edit product to replace te klikken. Dit is het exacte product en de exacte variant in de cart van de klant die wordt terugbetaald en verwijderd.
De meest voorkomende configuratiefout: het te vervangen product komt niet overeen met de variant die daadwerkelijk in de cart van de klant zit. Als dat gebeurt, kan Aftersell geen overeenkomend regelitem vinden om te verwijderen, en gaat de vervanging zonder melding niet af.Zo los je het op:
  • Open de Replacement Upsell-aanbieding.
  • Klik op Edit product to replace en controleer of het geselecteerde product en de geselecteerde variant exact overeenkomen met het product en de variant die de klant zou moeten hebben gekocht (volgens de funneltrigger).
  • Als je wisselt tussen varianten van hetzelfde product (Small → Large), moet het “te vervangen product” specifiek naar de variant Small wijzen. Als je het naar Large wijst of naar een variant die de klant niet heeft gekocht, wordt de aanbieding overgeslagen.
  • Sla op en test met een echte bestelling met een lage prijs die de exacte variant bevat waarvan je wilt wisselen.
Dit is het verwachte gedrag. De oorspronkelijke regel wordt terugbetaald en de vervanging wordt afgerekend, dus het bankafschrift van de klant toont twee transacties, ook al is het nettobedrag de weergegeven aanbiedingsprijs. Om verwarring te verminderen:
  • Voeg een zin toe aan de aanbiedingstekst die de werking van terugbetalen en vervangen uitlegt.
  • Schakel de automatische e-mail met terugbetalingsmelding van Aftersell voor vervangende upsells in.
  • Train je supportteam om het patroon met twee regels uit te leggen wanneer een klant contact opneemt.
Sommige payment gateways (waaronder Authorize.net en andere die transacties met vertraging in batches afwikkelen) staan geen terugbetalingen toe totdat de oorspronkelijke transactie is afgewikkeld. Omdat een Replacement Upsell de vervanging afrekent en het origineel direct na de checkout terugbetaalt, kan de terugbetalingsstap mislukken met de fout “Partial refunds are not allowed until the transaction is settled. Please try again later.” Aftersell probeert de terugbetaling na afwikkeling niet automatisch opnieuw, dus je moet de terugbetaling handmatig uitvoeren vanuit de Shopify-bestelling zodra de oorspronkelijke transactie is afgewikkeld (doorgaans binnen 24 uur, afhankelijk van het afwikkelingsschema van je gateway). Om dit scenario te voorkomen, wordt Replacement Upsell volledig overgeslagen voor bekende niet-ondersteunde gateways. Als je het blijft zien bij een ondersteunde gateway, neem dan contact op met support zodat we het kunnen onderzoeken.
Wanneer Aftersell het oorspronkelijke regelitem terugbetaalt, gaat elke korting die erop was toegepast mee met de terugbetaling. De vervangende regel wordt apart afgerekend. Als je wilt dat de klant de korting behoudt, configureer die dan rechtstreeks op de vervangingsaanbieding met het kortingsveld van de aanbieding.
Nee. Als het oorspronkelijke regelitem in de bestelling al een abonnement is, gaat Replacement Upsell niet af. Dit komt doordat het verwijderen van het abonnementsregelitem het abonnementscontract in je abonnementsapp niet annuleert; de klant zou nog steeds worden gefactureerd en daarnaast de vervanging ontvangen. Gebruik in plaats daarvan Subscription Upgrade om een bestaand abonnement te wijzigen (frequentie wijzigen, product wisselen of beide).
Replacement Upsell houdt fouten per aanbieding bij over een voortschrijdend venster van 7 dagen en stopt met het tonen van de aanbieding zodra het aantal fouten de drempel overschrijdt die je hebt geconfigureerd in Settings → Replacement Upsells (standaard: stop on any issue in the past 7 days). Wanneer de failsafe wordt geactiveerd, verschijnt er een banner “Replacement upsells are paused” op je Aftersell-homepage met een link Review failsafe naar Settings → Replacement Upsells, waar een statuskaart je huidige foutaantal toont en of de failsafe is geactiveerd.Als er geen fouten meer optreden, wordt de aanbieding automatisch hervat zodra het voortschrijdende 7-daagse aantal onder de drempel zakt. Om direct te hervatten nadat je het probleem hebt opgelost, klik je op Reset failsafe op die instellingenpagina. Weet je de oorzaak niet zeker, neem dan contact op met support via de chat in de app.
De aanbiedingskaart gebruikt de variantspecifieke afbeelding wanneer die in Shopify aan de variant is gekoppeld. Als er geen afbeelding aan de variant is gekoppeld, valt de aanbiedingskaart terug op de eerste afbeelding van het bovenliggende product. Als je wisselt tussen varianten van hetzelfde product en de afbeelding verandert niet, controleer dan of elke variant in Shopify een eigen afbeelding heeft.
Bouw één funnel per variant. Elke funnel heeft een trigger op product en variant en een bijbehorend vervangend product en variant. Aftersell heeft momenteel geen ingebouwde functie voor het koppelen van varianten.
Dezelfde foutoorzaak als bij Subscription Upsell: meestal is een selling plan gedeactiveerd tussen het weergeven van de aanbieding en de acceptatie door de klant. Shopify accepteert de changeset, maar er wordt verderop geen abonnement aangemaakt. Controleer of het selling plan nog actief is in Shopify en aan het vervangende product is toegewezen. Bekijk de orderimport- of webhooklogs van je abonnementsapp voor de betreffende bestelling. Als het abonnement ontbreekt, kan het supportteam van je abonnementsapp de klant meestal handmatig inschrijven.
Aftersell beheert het annuleren van abonnementen niet. Het annuleren van toekomstige cycli gebeurt in het klantportaal van je abonnementsprovider of door de klant zelf. Het terugbetalingsmechanisme van Shopify voor de eerste cyclus werkt hetzelfde als voor elk ander regelitem.
Dit is verwacht. Authorize.net is in de code van Aftersell expliciet geblokkeerd voor Replacement Upsell, omdat het vereist dat transacties zijn afgewikkeld voordat terugbetalingen kunnen worden gedaan, en de afwikkeling een vertraging heeft die het patroon van terugbetalen en opnieuw afschrijven doorbreekt waarop Replacement Upsell vertrouwt. Gebruik als alternatief bedankpagina-aanbiedingen voor klanten met Authorize.net. Je kunt bevestigen dat dit de oorzaak is door de bestelling te openen in de Aftersell Order Browser; de reden voor het overslaan luidt dan “Payment gateway does not support replacement upsells.”
Handmatige payment gateways (rembours, aangepaste betaalmethoden, checkouts via conceptbestellingen) zijn expliciet geblokkeerd voor Replacement Upsell, omdat ze geen kaart opslaan voor vervolgafschrijvingen. De Order Browser toont “Payment gateway does not support replacement upsells” als reden voor het overslaan. Zie Betaalmethoden voor bredere beperkingen van betaalmethoden bij post-purchase aanbiedingen.