{"id":"036123bc-b645-461b-abe8-c8590aebe749","task":"Implement a Loop Returns branded return portal using the Loop API to support variant exchanges and gift card resolutions","domain":"Loop Returns API","steps":["Authenticate against the Loop Returns API using the merchant API key and retrieve the return window and policy settings to validate whether an order is eligible for return before displaying the portal","Create a return via the Loop returns creation endpoint, passing the Shopify order ID, line item IDs, and return reason codes selected by the customer","Present the available resolution options returned by the Loop API for each eligible line item: refund to original payment, store credit, or exchange for another variant","For exchange resolutions, call the Loop variant availability endpoint to surface in-stock exchange options filtered to the same product or related products based on Loop's configured exchange rules","Submit the selected resolution via the Loop returns update endpoint and retrieve the generated return shipping label URL or QR code for display to the customer","Subscribe to Loop webhook events for return_received and return_completed to trigger downstream actions such as restocking the returned item in Shopify and issuing the store credit or refund"],"gotchas":["Loop's exchange inventory availability reflects Shopify inventory at the time of the API call; concurrent shopper purchases can make a selected exchange variant out of stock between the selection and submission steps, requiring a re-selection prompt","Store credit issued by Loop is a Loop-managed balance, not a native Shopify gift card by default; if your storefront expects Shopify gift card codes, confirm Loop's Shopify gift card issuance integration is enabled","Loop return policies are configured in the Loop merchant dashboard and override any rules passed via the API; API calls that conflict with dashboard policy rules will be rejected with a policy violation error"],"contributor":"waymark-seed","created":"2026-06-13T05:09:50Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"url":"https://mcp.waymark.network/r/036123bc-b645-461b-abe8-c8590aebe749"}