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 |
| Any unique identifier on the page |
| Your Retino ID (automatically filled) |
| Language code ( |
| Keep |
| Optional; empty = default portal with all forms |
Step 2: Create a page in Shoptet
In the Shoptet admin, go to Admin → Appearance and Content → Pages
Click Add (or open an existing page you want to use)
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!
In the page editor, click Tools → Source code
Paste the entire integration code copied from the Retino admin
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
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
Open the created page in your browser (e.g.
www.your-eshop.com/returns/
)We recommend using an incognito browser window for testing without cache
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:
Go to Appearance and Content → Menu
Add a new menu item
Set the link to
/returns/
(or your chosen URL)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 editorCheck that the snippet does not contain
entitiesRemove 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:
Go to the page with the portal
Select the ticket type (claim, return, exchange)
For testing use:
Order number:
TUTORIAL-PORTAL
Email: use your Retino account email
Complete the ticket creation process
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.