Set up your returns platform
Select your platform for its connection requirements.- Loop Returns
- Redo Returns
Connect Loop Returns
Confirm that your Loop plan includes Return Create API access. If the draft-return scopes below are unavailable, ask your Loop contact.- Sign in to Loop Admin and open Returns Management > Tools & integrations > Developer Tools.
- Select Generate API key. Choose Orders, Returns, Draft Returns (read), and Draft Returns (write). Name the key and select Generate. See Loop’s authentication guide.
- Open Settings > Integrations in Remark. Find Loop Returns and select Connect.
- Enter your Domain, such as
my-domain.admin.loopreturns.com. Use your Loop admin domain, not your storefront or public returns portal domain. If you do not have this domain, contactsupport@remark.aibefore connecting. - Enter your API key and select Connect.
Configure a returns intent
- Open Intents in the Remark dashboard. Open an existing returns intent or select Add intent.
- Write matching criteria for the requests you want the intent to handle, such as starting a return or checking its status.
- In the Actions section, select Add an action for each action the agent needs.
- Write the instructions using the guidance below. Reference an action with
@when the agent needs to use it at a specific step.
For Redo return creation, also add an order lookup action that provides the e-commerce platform’s order and line item IDs.
Loop actions can also run as integration action steps in Workflows, if enabled for your workspace. Redo’s image action requires a conversation and is not available in workflows.
Write the return instructions
In the intent’s instructions, tell the agent to:- Collect the order details and shopper verification required by your platform.
- Collect the items, quantities, return reasons, and the shopper’s refund, store credit, or supported replacement choice.
- Ask the shopper to confirm the items, quantities, and compensation before creating or submitting the return.
- Share only status, label, and tracking links returned by the platform.
- Hand off to your team if verification fails or the requested return cannot be completed. For Loop, use a portal link when the shopper can complete the remaining steps there.
Creating a return does not mean that the provider has approved it or processed a refund or replacement. Labels may appear later. Use the return lookup actions to check for updates.
Loop Returns instructions
Ask for the order name as shown to the shopper, such as#1001, and the verification detail required by your Loop settings. This can be a shipping postal code, email address, or phone number.
For in-chat returns, check eligible items and prepare the selection before asking for confirmation. Show Loop’s refund or store credit quote, including fees. If the shopper changes the selection, prepare the full updated list and confirm the new quote before submission.
For exchanges or steps that Remark cannot complete, use Create Loop Returns link with the order name and verification detail. The shopper completes the remaining steps in Loop. The chat widget shows a Return for order card with a Start your return button that opens the portal in a new tab. The action creates standard order return links, not gift return links.
Redo Returns instructions
For return lookups, ask for the order email. Search Redo returns also needs the order name. Get Redo return needs the return ID. Before creating a return:- Ask for the order email and either the last name or shipping postal code on the original order. Do not copy verification values from order lookup results. If the shopper supplies both the last name and postal code, both must match.
- Confirm the address the shopper will ship from. This can differ from the original order address used for verification.
- If your policy requires image evidence, collect the images before creating the return.
Test and review
Turn on Enabled in playground for the intent and save your changes. Before enabling live use, test:- An eligible return with the shopper’s confirmation before submission
- Incorrect verification details, with no return created and no retry using details from an order lookup
- A return status question, including a return without a label yet
- An unsupported request, such as an in-chat Loop exchange or a Redo replacement in a different size
- Portal links for Loop, or image collection for Redo, if you use those actions
Troubleshooting
Connection fails
- For Loop, use an admin domain ending in
.admin.loopreturns.comand a valid key with all four scopes listed above. - For Redo, check the API key, Redo store ID, and
returns_readscope. - If you rotated the key, open More options > Manage connection on the integration to replace it.
Lookups work, but return creation fails
- For Loop, check the draft-return scopes and your plan’s Return Create API access. Rebuild expired or cancelled drafts and confirm the new quote. If a draft was already submitted, look up the existing return instead. If Loop reports ineligible items or missing return steps, use the portal or ask your team to review the return in Loop.
- For Redo, check
orders_read,returns_write, and the e-commerce platform name. Ask the shopper to check their verification details. Do not retry with values copied from an order lookup.
A Loop portal link fails
Check the order name, including any# prefix, and the verification detail required by Loop. If the link opens but the shopper cannot complete the return, check eligibility in Loop. Loop controls return windows, product restrictions, and approval steps.
A Redo image upload fails
Keep the existing return. Do not repeat successful uploads or automatically retry an unconfirmed upload. Redo may already have saved the image. Check the return in Redo before trying again.Need help connecting a returns platform or testing returns? Contact
support@remark.ai.
Redo Returns