De Returns Widget op je website integreren

Met de nShift Returns-widget kunnen je klanten hun retourzendingen rechtstreeks op je website starten zonder je webshop te verlaten.
 

Vereisten

• Toegang tot de configuratie-interface van nShift Returns
• De mogelijkheid om de HTML van je website te bewerken (of toegang tot een ontwikkelaar die dit kan)
• Een markt-ID (zie stap 1)

Stap 1. Zoek je identificatiecode

1. Log in bij de nShift Returns configuration interface
2. Ga naar Widget Settings > Market Setup
3. De volgende identificatiecodes zijn beschikbaar. Gebruik een van de ondersteunde combinaties:

Welke moet ik gebruiken? marketId wordt waar mogelijk aanbevolen. Als een klant wordt doorgestuurd naar de inlogpagina, zorgt dit ervoor dat direct de juiste branding en taal worden weergegeven. Alleen customerName werkt wanneer je één markt hebt. Gebruik customerName + marketName wanneer je meerdere markten onder hetzelfde bedrijf hebt.

Opmerking: Als je alleen Company Name gebruikt, stuurt nShift Returns de klant automatisch door naar de juiste markt op basis van de ingevoerde gegevens.

Stap 2. Machtigingen voor insluiten configureren

Voordat de widget op je website kan worden geladen, moet je nShift Returns laten weten op welke URL de widget mag worden weergegeven.

1. Ga in de configuratie-interface naar Widget Settings > Market Setup > Embed permissions
2. Voer de volledige URL in van de pagina waarop de widget wordt weergegeven, bijvoorbeeld:
   https://www.yourstore.com/returns
3. Sla je wijzigingen op

Dit werkt als een lijst met toegestane URL's: de widget wordt alleen weergegeven wanneer deze vanaf exact deze URL wordt geladen.

Stap 3. Voeg de widget toe aan je website

Plak het volgende codefragment op de pagina waarop de widget moet worden weergegeven en vervang de src-waarde door de juiste URL voor je configuratie (zie de combinaties hieronder).

<!-- nShift Returns Widget -->
<iframe
  src="INSERT_URL_HERE"
  frameborder="0"
  marginheight="0"
  marginwidth="0"
  width="100%"
  height="700px"
  style="border: none;"
  title="Returns portal">
</iframe>

Ondersteunde URL-combinaties voor de src:

Language — als er geen lang is opgegeven, gebruikt de widget de standaardtaal die voor de markt is geconfigureerd. Ondersteunde taalcodes:

Base URLs by environment:

Klantgegevens vooraf invullen

Als er op je website bestelgegevens beschikbaar zijn, bijvoorbeeld wanneer een klant vanaf een orderbevestigingspagina komt, kun je deze gegevens rechtstreeks via de URL van de widget doorgeven. Wanneer geldige inloggegevens aanwezig zijn, slaat de widget het inlogscherm over en gaat de klant rechtstreeks naar de bestelpagina. Zonder deze gegevens komt de klant op de inlogpagina terecht en voert de klant de gegevens handmatig in.

Deze waarden worden doorgaans aan de serverzijde door je platform ingevoegd wanneer de pagina wordt geladen. Hierdoor blijft het codefragment voor het insluiten statisch, terwijl de waarden voor elke sessie dynamisch worden toegevoegd.

Ondersteunde combinaties van inloggegevens

De widget accepteert de volgende combinaties. Als er meerdere in de URL aanwezig zijn, wordt de eerste overeenkomst volgens deze prioriteitsvolgorde gebruikt:

https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&email=customer@example.com&order=1234

https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&customerId=0b6d015d-8f6d-412b-b976-6a1caebef839&order=1234

https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&emailBase=Y3VzdG9tZXJAZXhhbXBsZS5jb20=&orderBase=MTIzNA==

https://www.nshiftreturns.com/ui/widget/redirect?marketId=YOUR_MARKET_ID&lang=en-us&customerId=0b6d015d-8f6d-412b-b976-6a1caebef839&orderBase=MTIzNA==