Skip to main content

How to Integrate the Portal in Shoptet

O
Written by Ondřej Průša
Updated over a week ago

This guide will walk you through the complete integration of the Retino Portal into your Shoptet e-shop. The integration allows your customers to create warranty claims and returns directly on your website.

What you'll need

  • Access to the Shoptet admin with permission to edit pages

  • Access to the Retino admin to copy the integration code

  • The target URL of the page where you want to display the portal (e.g. /returns/)

Step 1: Get the integration code

Log in to your Retino admin and go to the Settings > Integration page. Here you will find the prepared integration code for your portal.

The integration code looks like this:

<div id="retino-portal-XXXX"
     data-company-id="YOUR-COMPANY-ID"
     data-language="en"
     data-base-url="https://app.retino.com"
     data-form-ids="">
</div>
<script type="text/javascript" id="retino-embedded-form-script">
  (function(r,e,t,i,n,o){n=e.createElement(t);n.src=i;n.async=true;o=e.getElementsByTagName(t)[0];o.parentNode.insertBefore(n,o)})(window,document,'script','https://cdn.retino.com/embeddedFormInjector.js')
</script>

Copy the entire code using the "Copy" button. The code already contains the correct data-company-id for your account.

Parameter meaning

Attribute

Meaning

id

Any unique identifier on the page

data-company-id

Your Retino ID (automatically filled)

data-language

Language code (en, sk, cs, ...)

data-base-url

Keep https://app.retino.com

data-form-ids

Optional; empty = default portal with all forms

Step 2: Create a page in Shoptet

  1. In the Shoptet admin, go to Admin → Appearance and Content → Pages

  2. Click Add (or open an existing page you want to use)

  3. Fill in:

    • Name: e.g. "Returns and Claims"

    • URL address (slug): e.g. returns

Step 3: Insert the HTML snippet correctly

Important: You must insert the snippet via source code, not into a regular text editor!

  1. In the page editor, click Tools → Source code

  2. Paste the entire integration code copied from the Retino admin

  3. Click OK to return to the editor

Warning: Do not add the snippet to the "normal" text mode. Always insert via Source code to prevent unwanted HTML tags like <p>, <br> or &nbsp; from being added.

Step 4: Save changes

Click the SAVE AND LEAVE button to save the page with the integrated portal.

Step 5: Verify functionality on the frontend

  1. Open the created page in your browser (e.g. www.your-eshop.com/returns/)

  2. We recommend using an incognito browser window for testing without cache

  3. Check that the portal loaded with buttons for returns and claims

Step 6: Add a link to the menu (optional)

For easy customer access to the portal, add a link to the main menu:

  1. Go to Appearance and Content → Menu

  2. Add a new menu item

  3. Set the link to /returns/ (or your chosen URL)

  4. Name the item e.g. "Returns and Claims"

Common problems and solutions

The portal is not displaying

  • Re-open Tools → Source code and verify that the snippet is not wrapped in unwanted tags (<p>, <div>) from the WYSIWYG editor

  • Check that the snippet does not contain &nbsp; entities

  • Remove any wrapping and unwanted tags

Browser cache

  • Always test in an incognito window or use a hard refresh (Ctrl+F5 / Cmd+Shift+R)

  • Clear your browser cache

Other language version

  • In the integration code, change the data-language attribute (e.g. sk, en)

  • Or create a separate page for each language variation

  • Language can be set directly in Settings > Integration before copying the code

Testing portal functionality

After successful integration, we recommend testing the complete functionality:

  1. Go to the page with the portal

  2. Select the ticket type (claim, return, exchange)

  3. For testing use:

    • Order number: TUTORIAL-PORTAL

    • Email: use your Retino account email

  4. Complete the ticket creation process

  5. Verify that the ticket appeared in the Retino admin

Need help?

If you encounter any problems with the integration, please contact us at [email protected]. We're happy to help you with setup or resolve any technical issues.

Did this answer your question?